1Password

• Konfigurationsgeheimnisse: Jedes SecretRef-Feld in openclaw.json kann zur Laufzeit über die op-CLI aufgelöst werden, sodass API-Schlüssel niemals in der Konfigurationsdatei gespeichert werden.
• Agenten-Workflows: Der mitgelieferte 1password-Skill bringt Agenten bei, sich anzumelden und mit op Geheimnisse für ihre eigenen Aufgaben zu lesen oder einzuschleusen.

​

Voraussetzungen

• Die 1Password CLI (op) muss auf dem Gateway-Host installiert sein (brew install 1password-cli unter macOS).
• Ein Authentifizierungsmodus für op:
  • Dienstkonto (für Headless-Gateways empfohlen): Exportieren Sie OP_SERVICE_ACCOUNT_TOKEN in der Umgebung des Gateway-Dienstes. Keine Desktop-App, keine interaktive Anmeldung.
  • Desktop-App-Integration: Die 1Password-App wird auf demselben Computer ausgeführt und die CLI-Integration ist aktiviert. Bei den ersten Aufrufen kann eine Touch-ID- oder Systemauthentifizierung ausgelöst werden.
  • Eigenständige Anmeldung: op signin fordert pro Sitzung zur Anmeldung auf. Für Agenten über den Skill praktikabel, aber nicht für die Auflösung von Konfigurationsgeheimnissen auf einem Headless-Gateway geeignet.

​

Konfigurationsgeheimnisse mit op auflösen

{
  secrets: {
    providers: {
      onepassword_openai: {
        source: "exec",
        command: "/opt/homebrew/bin/op",
        allowSymlinkCommand: true, // für durch Homebrew symbolisch verknüpfte Binärdateien erforderlich
        trustedDirs: ["/opt/homebrew"],
        args: ["read", "op://Personal/OpenClaw QA API Key/password"],
        passEnv: ["HOME"],
        jsonOnly: false,
      },
    },
  },
  models: {
    providers: {
      openai: {
        baseUrl: "https://api.openai.com/v1",
        models: [{ id: "gpt-5", name: "gpt-5" }],
        apiKey: { source: "exec", provider: "onepassword_openai", id: "value" },
      },
    },
  },
}

• command muss ein absoluter Pfad sein; trustedDirs kennzeichnet sein Verzeichnis als vertrauenswürdig, und allowSymlinkCommand ist erforderlich, weil Homebrew op als symbolischen Link installiert.
• args übergibt die op://vault/item/field-Referenz unverändert. OpenClaw analysiert das op://-Schema nicht selbst; die Binärdatei op löst es auf.
• passEnv leitet die aufgeführten Variablen aus der Gateway-Umgebung weiter. Die Desktop-App-Integration benötigt HOME; für Dienstkonten muss außerdem OP_SERVICE_ACCOUNT_TOKEN in der Umgebung des Gateway-Dienstes vorhanden sein (fügen Sie es zu passEnv hinzu oder legen Sie es nur dann über env fest, wenn Sie akzeptieren, dass das Token in der Konfigurationsdatei lesbar ist).
• Behalten Sie für die Ausgabe eines einzelnen Werts id: "value" bei. Verwenden Sie bei jsonOnly: true und einer JSON-Nutzlast stattdessen eine JSON-Pointer-ID, um Felder zu adressieren.
• Ein Provider-Eintrag pro Geheimnis sorgt dafür, dass Referenzen überprüfbar bleiben; benennen Sie Provider nach ihrem Verbraucher (onepassword_openai, onepassword_telegram).

​

Dienstkonto für Headless-Gateways einrichten

1. Erstellen Sie in Ihrem 1Password-Konto ein Dienstkonto und gewähren Sie ihm ausschließlich Lesezugriff auf die Tresoreinträge, die das Gateway benötigt.
2. Stellen Sie dem Gateway-Dienst OP_SERVICE_ACCOUNT_TOKEN bereit (launchd-Plist, systemd-Unit oder Container-Umgebungsvariable).
3. Fügen Sie "OP_SERVICE_ACCOUNT_TOKEN" zur passEnv-Liste des Providers hinzu.
4. Überprüfen Sie dies in der Umgebung des Gateway-Hosts: op whoami sollte das Dienstkonto ohne Eingabeaufforderung ausgeben.

​

Der 1password-Skill für Agenten

​

Sicherheitshinweise

• Über Exec-Provider aufgelöste Geheimniswerte verbleiben im Arbeitsspeicher des Gateways; Konfigurations-Snapshots und config.get-Antworten schwärzen SecretRef-Felder.
• Speichern Sie Geheimniswerte niemals in openclaw.json, Protokollen oder Chats. Speichern Sie Elementnamen in der Konfiguration und Werte in 1Password.
• Das 1Password-Auditprotokoll zeigt jeden Lesezugriff eines Dienstkontos, wodurch Schlüsselrotation und Vorfallanalyse praktikabel werden.

​

Fehlerbehebung

• command not found oder Spawn-Fehler: Verwenden Sie den absoluten Pfad zu op und nehmen Sie dessen Verzeichnis in trustedDirs auf.
• op wird aufgelöst, aber Lesevorgänge schlagen mit Symlink-Fehlern fehl: Legen Sie für Homebrew-Installationen allowSymlinkCommand: true fest.
• account is not signed in: Stellen Sie bei Dienstkonten sicher, dass OP_SERVICE_ACCOUNT_TOKEN den Gateway-Dienst erreicht und in passEnv aufgeführt ist; stellen Sie bei der Desktop-Integration sicher, dass die App ausgeführt wird und entsperrt ist.
• Langsame erste Lesevorgänge: Erhöhen Sie timeoutMs beim Provider; Kaltstarts von op können auf ausgelasteten Hosts strenge Zeitlimits überschreiten.