此技能需要访问外网资源,可能需要科学上网
运行时依赖
无特殊依赖
安装命令
点击复制官方npx clawhub@latest install 1password
镜像加速npx clawhub@latest install 1password --registry https://cn.longxiaskill.com 镜像可用
国内专用无需额外安装
本土化适配说明
本技能需在 macOS 或 Linux 系统上运行,并预先安装 1Password 桌面应用。请先在本地创建 tmux 会话,按照官方文档完成 CLI 的安装、桌面集成以及登录授权。国内已提供镜像下载,可加速获取安装包。
技能文档
遵循官方 CLI 入门步骤。不要自行猜测安装命令。
参考文档
references/get-started.md(安装 + 桌面应用集成 + 登录流程)references/cli-examples.md(真实的 op 示例)
工作流
- 检查操作系统与 Shell 环境。
- 确认 CLI 已安装:
op --version。 - 确认已启用桌面应用集成(参考入门文档),且应用已解锁。
- 必需:为所有
op命令创建全新的 tmux 会话(不要在 tmux 之外直接调用op)。 - 在 tmux 中登录/授权:
op signin(会弹出应用授权提示)。 - 在 tmux 中验证访问权限:
op whoami(必须成功后才能读取任何机密)。 - 若有多个账户:使用
--account或环境变量OP_ACCOUNT。 - 必需 的 tmux 会话(T‑Max)
Shell 工具每个命令都会使用全新的 TTY。为避免重复提示和错误,始终在专用 tmux 会话中运行 op,并使用全新的 socket/会话名。
示例(请参考 tmux 技能中的 socket 命名约定,避免复用旧的会话名):
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"
守护规则
- 切勿将机密粘贴到日志、聊天或代码中。
- 优先使用
op run/op inject,避免将机密写入磁盘。 - 若无需桌面应用集成而需要登录,可使用
op account add。 - 如果命令返回 “account is not signed in”,请在 tmux 中重新运行
op signin并在应用中授权。 - 禁止在 tmux 之外运行
op;若无法使用 tmux,请停止操作并询问解决方案。