1Password

• Segreti di configurazione: qualsiasi campo SecretRef in openclaw.json può essere risolto tramite la CLI op in fase di esecuzione, così le chiavi API non risiedono mai nel file di configurazione.
• Flussi di lavoro degli agenti: la skill 1password inclusa insegna agli agenti ad autenticarsi e a leggere o inserire segreti con op per le proprie attività.

​

Requisiti

• La CLI di 1Password (op) installata sull’host del Gateway (brew install 1password-cli su macOS).
• Una modalità di autenticazione per op:
  • Account di servizio (consigliato per Gateway headless): esportare OP_SERVICE_ACCOUNT_TOKEN nell’ambiente del servizio Gateway. Non sono necessari né un’app desktop né un accesso interattivo.
  • Integrazione con l’app desktop: l’app 1Password viene eseguita sulla stessa macchina con l’integrazione CLI abilitata. Le prime chiamate possono attivare Touch ID o l’autenticazione di sistema.
  • Accesso autonomo: op signin richiede l’autenticazione a ogni sessione. È utilizzabile dagli agenti tramite la skill, ma non è adatto alla risoluzione dei segreti di configurazione su un Gateway headless.

​

Risolvere i segreti di configurazione con op

{
  secrets: {
    providers: {
      onepassword_openai: {
        source: "exec",
        command: "/opt/homebrew/bin/op",
        allowSymlinkCommand: true, // necessario per i binari Homebrew collegati simbolicamente
        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 deve essere un percorso assoluto; trustedDirs contrassegna la relativa directory come attendibile e allowSymlinkCommand è necessario perché Homebrew installa op come collegamento simbolico.
• args trasmette il riferimento op://vault/item/field senza modificarlo. OpenClaw non analizza direttamente lo schema op://; è il binario op a risolverlo.
• passEnv inoltra le variabili elencate dall’ambiente del Gateway. L’integrazione con l’app desktop richiede HOME; gli account di servizio richiedono inoltre che OP_SERVICE_ACCOUNT_TOKEN sia presente nell’ambiente del servizio Gateway (aggiungerlo a passEnv, oppure impostarlo tramite env solo se si accetta che il token sia leggibile nel file di configurazione).
• Per l’output con un singolo valore, mantenere id: "value". Con jsonOnly: true e un payload JSON, indirizzare invece i campi mediante un ID puntatore JSON.
• Una voce del provider per ciascun segreto rende i riferimenti verificabili; assegnare ai provider nomi basati sul relativo utilizzatore (onepassword_openai, onepassword_telegram).

​

Configurazione dell’account di servizio per Gateway headless

1. Creare un account di servizio nell’account 1Password e concedergli l’accesso in lettura esclusivamente agli elementi del vault necessari al Gateway.
2. Fornire OP_SERVICE_ACCOUNT_TOKEN al servizio Gateway (plist di launchd, unità systemd o variabile di ambiente del container).
3. Aggiungere "OP_SERVICE_ACCOUNT_TOKEN" all’elenco passEnv del provider.
4. Verificare dall’ambiente dell’host del Gateway: op whoami dovrebbe mostrare l’account di servizio senza richiedere l’autenticazione.

​

La skill 1password per gli agenti

​

Note sulla sicurezza

• I valori segreti risolti tramite provider exec rimangono nella memoria del Gateway; le istantanee della configurazione e le risposte config.get oscurano i campi SecretRef.
• Non inserire mai valori segreti in openclaw.json, nei log o nelle chat. Mantenere i nomi degli elementi nella configurazione e i valori in 1Password.
• Il registro di controllo di 1Password mostra ogni lettura dell’account di servizio, rendendo pratiche la rotazione delle chiavi e l’analisi degli incidenti.

​

Risoluzione dei problemi

• command not found o errori di avvio del processo: utilizzare il percorso assoluto di op e includere la relativa directory in trustedDirs.
• op viene risolto, ma le letture non riescono a causa di errori relativi ai collegamenti simbolici: impostare allowSymlinkCommand: true per le installazioni Homebrew.
• account is not signed in: per gli account di servizio, verificare che OP_SERVICE_ACCOUNT_TOKEN raggiunga il servizio Gateway e sia elencato in passEnv; per l’integrazione desktop, verificare che l’app sia in esecuzione e sbloccata.
• Prime letture lente: aumentare timeoutMs nel provider; gli avvii a freddo di op possono superare timeout rigidi sugli host sottoposti a carico elevato.