SuperAPI AI 工具集

1password

安全与审计

查看项目

更新于 10-16 06:56

技能介绍

用途

1Password CLI(命令为 op)是 1Password 提供的命令行工具。本技能用于指导完成 1Password CLI 的设置与日常使用,覆盖安装 CLI、启用桌面应用集成、登录(单账户或多账户)以及执行 op 命令等场景。

主要能力

  • 安装 1Password CLI,并遵循官方 CLI 入门步骤(不猜测安装命令)。
  • 启用桌面应用集成。
  • 登录与授权:支持单账户与多账户场景。
  • 验证身份与访问权限:通过 op whoami 确认登录状态,再进行任何密钥读取。
  • 多账户处理:使用 --account 参数或 OP_ACCOUNT 环境变量。

参考文档

  • references/get-started.md:安装、应用集成与登录流程。
  • references/cli-examples.md:真实的 op 使用示例。

使用方式(工作流程)

  1. 检查操作系统与 shell。
  2. 验证 CLI 是否已安装:op --version。
  3. 确认桌面应用集成已启用(依据 get-started 文档),并确保应用已解锁。
  4. 必需:为所有 op 命令创建一个全新的 tmux 会话(不允许在 tmux 之外直接调用 op)。
  5. 在 tmux 内登录/授权:op signin(预期会出现应用提示)。
  6. 在 tmux 内验证访问权限:op whoami(必须在读取任何密钥之前成功)。
  7. 如果存在多个账户:使用 --account 或 OP_ACCOUNT。

必需的 tmux 会话(T-Max)

由于 shell 工具为每条命令使用全新的 TTY,为避免重复提示与失败,应始终在专用的 tmux 会话中运行 op,并使用全新的 socket 与会话名称。示例(socket 约定参见 tmux 技能,不要复用旧会话名):

SOCKET_DIR="${OPENCLAW_TMUX_SOCKET_DIR:-${CLAWDBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/openclaw-tmux-sockets}}"
mkdir -p "$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
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 不可用,应停止并询问。

适用场景

适用于需要通过命令行访问 1Password 中凭据、在脚本或自动化流程中安全注入密钥、以及管理多账户登录的开发者与运维场景。

限制

资料未提供具体的安装命令、支持的操作系统与 shell 清单、版本要求、收费或价格信息,也未提供除上述流程外的其他功能说明。