1password

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

1Password CLI

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

请遵循官方CLI入门步骤操作，不要自行猜测安装命令。

References

参考资料

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

```
references/get-started.md
```
（安装 + 应用集成 + 登录流程）
```
references/cli-examples.md
```
（真实
```
op
```
示例）

Workflow

工作流程

Check OS + shell.
Verify CLI present:
```
op --version
```
.
Confirm desktop app integration is enabled (per get-started) and the app is unlocked.
REQUIRED: create a fresh tmux session for all
```
op
```
commands (no direct
```
op
```
calls outside tmux).
Sign in / authorize inside tmux:
```
op signin
```
(expect app prompt).
Verify access inside tmux:
```
op whoami
```
(must succeed before any secret read).
If multiple accounts: use
```
--account
```
or
```
OP_ACCOUNT
```
.

检查操作系统与Shell环境。
验证CLI是否存在：
```
op --version
```
。
确认桌面应用集成已启用（按照入门指南操作）且应用已解锁。
必需操作：为所有
```
op
```
命令创建一个全新的tmux会话（禁止在tmux之外直接调用
```
op
```
）。
在tmux内登录/授权：
```
op signin
```
（会触发应用弹窗）。
在tmux内验证访问权限：
```
op whoami
```
（在读取任何密钥前必须执行成功）。
若为多账户：使用
```
--account
```
参数或
```
OP_ACCOUNT
```
环境变量。

REQUIRED tmux session (T-Max)

必需的tmux会话（T-Max）

The shell tool uses a fresh TTY per command. To avoid re-prompts and failures, always run

op

inside a dedicated tmux session with a fresh socket/session name.

Example (see

tmux

skill for socket conventions, do not reuse old session names):

bash

SOCKET_DIR="${CLAWDBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/clawdbot-tmux-sockets}"
mkdir -p "$SOCKET_DIR"
SOCKET="$SOCKET_DIR/clawdbot-op.sock"
SESSION="op-auth-$(date +%Y%m%d-%H%M%S)"

tmux -S "$SOCKET" new -d -s "$SESSION" -n shell
tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- "op signin --account my.1password.com" Enter
tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- "op whoami" Enter
tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- "op vault list" Enter
tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200
tmux -S "$SOCKET" kill-session -t "$SESSION"

Shell工具每个命令会使用一个全新的TTY。为避免重复弹窗和执行失败，请始终在专用的tmux会话中运行

op

，并使用全新的套接字/会话名称。

示例（请遵循

tmux

技能中的套接字约定，不要复用旧会话名称）：

bash

SOCKET_DIR="${CLAWDBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/clawdbot-tmux-sockets}"
mkdir -p "$SOCKET_DIR"
SOCKET="$SOCKET_DIR/clawdbot-op.sock"
SESSION="op-auth-$(date +%Y%m%d-%H%M%S)"

tmux -S "$SOCKET" new -d -s "$SESSION" -n shell
tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- "op signin --account my.1password.com" Enter
tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- "op whoami" Enter
tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- "op vault list" Enter
tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200
tmux -S "$SOCKET" kill-session -t "$SESSION"

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
```
.
If a command returns "account is not signed in", re-run
```
op signin
```
inside tmux and authorize in the app.
Do not run
```
op
```
outside tmux; stop and ask if tmux is unavailable.

切勿将密钥粘贴到日志、聊天或代码中。
优先使用
```
op run
```
/
```
op inject
```
，而非将密钥写入磁盘。
若需要在未启用应用集成的情况下登录，请使用
```
op account add
```
。
如果命令返回“account is not signed in”，请在tmux内重新运行
```
op signin
```
并在应用中完成授权。
禁止在tmux之外运行
```
op
```
；若tmux不可用，请停止操作并咨询相关人员。