1password

openclaw/openclaw/skills/1password

作者 openclawb0c330d27df4a528f65185cc3e509284d1b218d9無授權條款394K 個星標收錄於 2026年11月20日更新於 2026年11月20日儲存庫今天更新

Set up and use 1Password CLI for sign-in, desktop integration, and reading or injecting secrets.

AI 產生的概覽

指導設定與使用 1Password CLI(op),用於登入、桌面應用程式整合,以及讀取或注入機密資料。

功能
引導代理確認 op 指令是否存在,辨識目前可用的驗證方式(服務帳號權杖、桌面應用程式整合或獨立登入),並依對應方式執行 op 指令。內容涵蓋讀取機密資料、列出保險庫、在不寫入磁碟的情況下將機密注入指令,以及在具備相關工具時透過瀏覽器自動填入憑證。另提供安全守則與登入失敗時的排解步驟。
適用情境
當任務需要從 1Password 取得憑證或機密資料、需要在主機上設定或排解 1Password CLI 驗證問題,或需要透過 1Password 憑證工具登入網站時使用。
執行需求
需要安裝 1Password CLI(op),例如透過 1password-cli 的 Homebrew 配方。需要下列其一:OP_SERVICE_ACCOUNT_TOKEN、已啟用 CLI 整合的 1Password 桌面應用程式,或互動式登入;僅在 macOS/Linux 上使用獨立登入流程時需要 tmux。不附帶指令碼,只有參考文件。

1Password CLI

Follow the official CLI get-started steps. Don't guess install commands.

References

  • references/get-started.md (install + app integration + sign-in flow)
  • references/cli-examples.md (real op examples)

Workflow

  1. Check OS + shell.
  2. Verify CLI present: op --version.
  3. Detect the auth mode the user has set up:
    • Service account: OP_SERVICE_ACCOUNT_TOKEN is set (typical for headless setups, CI, gateways).
    • Desktop app integration: the 1Password desktop app is running with CLI integration enabled (typical on macOS / Windows / Linux desktops).
    • Standalone signin: neither of the above — op signin will prompt for an account password every session.
  4. Run op according to the auth mode (see below).
  5. Verify access: op whoami should succeed before any secret read.
  6. If multiple accounts: use --account or OP_ACCOUNT.

Running op per auth mode

Service account (preferred for headless / gateway use)

Direct exec. No tmux, no signin step.

bash
export OP_SERVICE_ACCOUNT_TOKEN="ops_..."op vault listop read op://app-prod/db/password

Desktop app integration

Direct exec. Do not wrap in tmux — the desktop app integration uses a per-user IPC channel that is established for the gateway's exec environment but is not always reliably reachable from tmux subshells, which run with a different environment context. The transport differs per platform (XPC via the 1Password Browser Helper on macOS, a Unix domain socket on Linux, a named pipe on Windows); the practical rule for an agent is the same on all three: run op directly. On macOS, a useful symptom indicator is the 1Password integration group container at ~/Library/Group Containers/2BUA8C4S2C.com.1password/t/.

bash
op vault list      # may trigger Touch ID / Windows Hello / system auth on first callop whoami

If a call returns 1Password CLI couldn't connect to the 1Password desktop app, do not switch to tmux. Confirm the desktop app is running and unlocked, then retry direct exec.

Standalone signin (no app, interactive password)

This is the only mode where tmux helps. op signin prints an eval-style export setting an OP_SESSION_* token for POSIX shells; later commands in the same shell are authenticated by that env var. The gateway's per-command shells lose that state between calls, so a persistent tmux pane keeps the session token alive — but only if the export is actually applied with eval in a POSIX shell. Sending op signin as a plain command leaves stdout printed to the pane and op whoami will fail.

The tmux flow is only actionable on macOS/Linux hosts where the tmux skill is available. The example intentionally opens /bin/sh so the POSIX eval "$(op signin ...)" output is valid even when the user's normal shell is fish. On Windows, prefer desktop app integration or service account auth. If the user only has standalone interactive signin on Windows, stop and ask them to provide a persistent PowerShell session mechanism or switch to desktop integration/service account auth; do not translate the tmux commands directly.

bash
SOCKET_DIR="${OPENCLAW_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/openclaw-tmux-sockets}"mkdir -p "$SOCKET_DIR"chmod 700 "$SOCKET_DIR"SOCKET="$SOCKET_DIR/openclaw-op.sock"SESSION="op-auth-$(date +%Y%m%d-%H%M%S)"
tmux -S "$SOCKET" new -d -s "$SESSION" -n shell /bin/shtmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- 'eval "$(op signin --account my.1password.com)"' Entertmux -S "$SOCKET" capture-pane -t "$SESSION":0.0 -p -S - | tail -40

Do not queue follow-up commands while signin is prompting. Poll the pane with capture-pane until signin has either completed and the shell prompt has returned, or it is clearly waiting for human input. If the prompt requires a password, MFA, or account choice, pause and ask the user to complete signin in their own terminal; give them the socket and session values so they can attach locally. The agent should not run tmux attach from exec because attach consumes the current TTY and prevents scripted send-keys / capture-pane control.

After the shell prompt returns, verify by sending the checks into the same pane:

bash
tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- 'op whoami' Entertmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- 'op vault list' Entertmux -S "$SOCKET" capture-pane -t "$SESSION":0.0 -p -S - | tail -80

Keep the tmux session running so later op read / op run commands reuse the same authenticated shell.

Use the same SOCKET and SESSION values for every follow-up command in this standalone signin flow. The -S "$SOCKET" flag selects the tmux server socket; keep it in a user-owned 0700 directory, do not share it between users, and choose a new session name for each new signin attempt.

Browser sign-in (1Password for Claude)

If the session exposes Claude in Chrome credential tools (request_credentials, autofill_credential, enter_verification_code), prefer them over op for signing in to websites: 1Password fills the page directly and the secret never enters context. Rules:

  • Request every credential the task needs in one request_credentials call before navigating.
  • Approval is a 1Password prompt on the gateway host. If it stays pending, tell the user which host to unlock ("1Password is waiting for approval on this Mac") instead of retrying.
  • Never ask the user to send passwords or one-time codes through chat; codes go through enter_verification_code only.
  • Do not fall back to op read for a website password just because the browser flow needs approval; that defeats the no-exposure design. Use op for secrets consumed by commands and config, not for web logins when the browser flow exists.

Guardrails

  • Never paste secrets into logs, chat, or code.
  • Prefer op run / op inject over writing secrets to disk.
  • If sign-in without app integration is needed, use op account add first.
  • If a command returns "account is not signed in":
    • service account: re-export OP_SERVICE_ACCOUNT_TOKEN
    • desktop app: confirm the app is running and integration is enabled
    • standalone: re-run op signin inside the same tmux session and authorize

來源與署名

來源:openclaw/openclaw位於skills/1password提交b0c330d

授權條款: 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

在 README 中新增徽章

向讀者展示該技能已收錄於 SourceWeft,徽章連結到本頁。

「Listed on SourceWeft」徽章預覽
[![Listed on SourceWeft](https://sourceweft.com/badge/skills/gh-openclaw-openclaw-1password-skills-1password-e07658e9af312515.svg)](https://sourceweft.com/skills/gh-openclaw-openclaw-1password-skills-1password-e07658e9af312515?utm_source=readme&utm_medium=badge)

檢舉或申請下架