1Password CLI
遵循官方CLI入门步骤。不要猜测安装命令。
参考
- 官方文档:https://developer.1password.com/docs/cli/get-started/
references/get-started.md(安装 + 应用集成 + 登录流程)references/cli-examples.md(真实的op示例,包括安全创建/编辑项的模式)
工作流
- 检查操作系统和Shell。
- 在tmux中验证CLI是否存在:
op --version。 - 必需:为整个密钥任务创建恰好一个持久的命名tmux会话。
- 当存在匹配的令牌/工作流时,优先尝试范围限定的服务账户访问;无需对话框。
- 如果缺少服务账户访问权限或缺少所需的精确项/字段,自动在同一会话中回退到桌面应用。不要先请求聊天许可。
- 桌面回退:触发应用集成/解锁,然后在同一会话内执行
op signin。1Password提示是用户批准的边界;仅当提示无法显示或完成时才在聊天中询问。 - 在同一会话中验证所选访问路径:
op whoami。 - 如果有多个账户:使用
--account或OP_ACCOUNT。 - 如果命令失败,使用
tmux send-keys重复使用同一tmux会话;不要仅仅为了重试而启动第二个会话。
默认账户
- 个人/工作密钥的默认账户是
my.1password.com。 - 除非明确要求,否则不要静默使用
my.1password.eu/ Titan。 - 在存储或读取密钥时,在每个
op命令上传递--account my.1password.com。不要依赖环境账户选择。 op account list仅用于元数据,但仍必须在tmux内运行。当路由不明确时,用它来确认账户名称。op signin --account my.1password.com可以返回状态0且没有有用输出,并且仍然不会使后续Shell登录。最好在同一个tmux Shell中执行登录、创建/编辑/获取和验证。
服务账户令牌
- 在任何交互式1Password流程之前优先使用服务账户令牌。用户对话框仅作为回退。
- 1Password服务账户是特定存储库/范围的非交互式令牌,适用于无需解锁桌面应用的自动化。
- Peter的默认服务账户令牌已从
~/.profile导出为OP_SERVICE_ACCOUNT_TOKEN,位于一个Codex管理的块中。其范围限定为受限的Molty存储库。 - 较旧的Shell可能将相同的值暴露为
MOLTY_OP_SERVICE_ACCOUNT_TOKEN;将其视为已知Molty存储库项的回退别名。 - 如果令牌尚未导出、不适用或无法读取所需的精确已知项/字段,则自动使用下面的桌面应用1Password流程。仅在实际解锁或其他用户交互仍被阻塞时才询问。
- 仅为需要它的单个命令导出/传递它:
OP_SERVICE_ACCOUNT_TOKEN="$OP_SERVICE_ACCOUNT_TOKEN" op item get "<known item>" --vault Molty ...。 - 服务账户
op读取需要显式指定存储库;省略--vault Molty即使令牌有效也会失败。 - 保留tmux规则:每个
op命令,包括服务账户读取,仍在一个命名tmux会话内运行。 - 默认情况下,不要使用服务账户枚举存储库/项。如果用户明确要求搜索、提供截图/列表或仅给出模糊的项名称,请在桌面回退之前使用下面的安全元数据搜索。
- 仅打印存在性/形状,绝不打印令牌或密钥值。
必需的持久Tmux会话
Shell工具每个命令使用一个新的TTY。在一个专用的tmux会话内运行op,并持续使用同一会话,直到整个密钥任务完成。服务账户命令仍在此处运行,但不得触发应用提示。
示例:
SOCKET_DIR="${CLAWDBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/clawdbot-tmux-sockets}"
mkdir -p "$SOCKET_DIR"
SOCKET="$SOCKET_DIR/clawdbot-op.sock"
SESSION="op-work"
tmux -S "$SOCKET" has-session -t "$SESSION" 2>/dev/null ||
tmux -S "$SOCKET" new -d -s "$SESSION" -n shell
tmux -S "$SOCKET" send-keys -t "$SESSION:" -- "op signin --account my.1password.com" Enter
tmux -S "$SOCKET" send-keys -t "$SESSION:" -- "op whoami" Enter
tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION:" -S -200
在出现引号、项名称或命令错误后,不要创建新的tmux会话。将更正后的命令发送到现有会话中。
将会话目标指定为$SESSION:,而不是假设窗口0;较旧的会话可能从1开始编号。
特定服务工作流
- 将特定服务的认证详细信息保留在所属技能中。
- 对于npm注册表/包工作,请使用
$npm;它记录了Molty服务账户项、非交互式认证包装器和包预留助手。 - 此技能仅拥有通用的1Password规则:仅tmux的
op、定向读取、一个持久会话、无广泛枚举、无密钥输出。
已知有效的密钥写入模式
使用持久tmux会话。将确切的密钥任务写入一个临时脚本,然后将该脚本发送到op-work;不要为重试创建第二个tmux会话。
SOCKET_DIR="${CLAWDBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/clawdbot-tmux-sockets}"
SOCKET="$SOCKET_DIR/clawdbot-op.sock"
SESSION="op-work"
tmux -S "$SOCKET" has-session -t "$SESSION" 2>/dev/null ||
tmux -S "$SOCKET" new -d -s "$SESSION" -n shell
cat > /tmp/op-store-secret.sh <<'SCRIPT'
#!/usr/bin/env bash
set -euo pipefail
set +x
ACCOUNT="my.1password.com"
ITEM_TITLE="Service API Tokens"
FIELD_NAME="api_token"
EXPECTED_PREFIX=""
NOTES="Created via tmux-safe op workflow"
TOKEN="$(pbpaste)"
if [ -n "$EXPECTED_PREFIX" ]; then
case "$TOKEN" in "$EXPECTED_PREFIX"*) ;; *) echo "clipboard value does not match expected prefix" >&2; exit 2;; esac
fi
op item create --account "$ACCOUNT" --category "API Credential" --title "$ITEM_TITLE" "$FIELD_NAME[password]=$TOKEN" "notesPlain=$NOTES" >/dev/null
op item get "$ITEM_TITLE" --account "$ACCOUNT" --fields "label=$FIELD_NAME" >/dev/null
echo "stored and verified secret field without printing it"
SCRIPT
chmod 700 /tmp/op-store-secret.sh
tmux -S "$SOCKET" send-keys -t "$SESSION" -- "bash /tmp/op-store-secret.sh; rm -f /tmp/op-store-secret.sh" C-m
在此CLI构建中,op类别字符串是可读且区分大小写的;请使用"API Credential",而不是api_credential。
精确字段读取
对于已知项,在使用前验证字段形状:长度、预期前缀、换行符数量,绝不验证值。当项具有重复/遗留凭证字段时,op --field NAME和--fields label=NAME可能返回错误的隐藏字段。如果形状错误,则将已知项读取为JSON并提取确切标签。
cat > /tmp/op-read-field.sh <<'SCRIPT'
#!/usr/bin/env bash
set -euo pipefail
set +x
ITEM_TITLE="Known API Credential Item"
FIELD_LABEL="api_token"
VAULT="Molty"
value="$(
OP_SERVICE_ACCOUNT_TOKEN="$OP_SERVICE_ACCOUNT_TOKEN" \
op item get "$ITEM_TITLE" --vault "$VAULT" --format json |
FIELD_LABEL="$FIELD_LABEL" node -e 'let s=""; process.stdin.on("data",d=>s+=d); process.stdin.on("end",()=>{const item=JSON.parse(s); const f=(item.fields||[]).find(x=>x.label===process.env.FIELD_LABEL); if(!f?.value) process.exit(2); process.stdout.write(f.value);})'
)"
echo "field_len:${#value}"
case "$value" in sk-*) echo "field_prefix:sk" ;; *) echo "field_prefix:other" ;; esac
echo "field_has_newline:$(printf %s "$value" | wc -l | tr -d ' ')"
SCRIPT
chmod 700 /tmp/op-read-field.sh
tmux -S "$SOCKET" send-keys -t "$SESSION:" -- "bash /tmp/op-read-field.sh; rm -f /tmp/op-read-field.sh" C-m
将JSON提取范围限定到已知项和存储库。不要枚举存储库/项来发现候选。
显式项搜索
仅当用户明确要求搜索、提供截图/列表,或确切的标题猜测失败且用户要求进行正则表达式/模糊查询时使用。保持存储库范围限定并仅返回元数据;打印候选标题/ID/类别/存储库名称,绝不打印字段或值。首选来自屏幕截图的确切可见字符串:存储库名称、项标题和字段标签。
cat > /tmp/op-find-item.sh <<'SCRIPT'
#!/usr/bin/env bash
set -euo pipefail
set +x
VAULT="Molty"
QUERY="minimax"
OP_SERVICE_ACCOUNT_TOKEN="$OP_SERVICE_ACCOUNT_TOKEN" \
op item list --vault "$VAULT" --format json |
QUERY="$QUERY" VAULT="$VAULT" node -e '
let s=""; process.stdin.on("data",d=>s+=d); process.stdin.on("end",()=>{
const q=process.env.QUERY.toLowerCase();
const vault=process.env.VAULT;
const items=JSON.parse(s).filter(x => [
x.title, x.id, x.category, ...(x.tags || [])
].filter(Boolean).join("\n").toLowerCase().includes(q));
for (const item of items.slice(0, 10)) {
console.log(`title:${item.title} id:${item.id} category:${item.category || ""} vault:${vault}`);
}
console.log(`matches:${items.length}`);
})'
SCRIPT
chmod 700 /tmp/op-find-item.sh
tmux -S "$SOCKET" send-keys -t "$SESSION:" -- "bash /tmp/op-find-item.sh; rm -f /tmp/op-find-item.sh" C-m
选择候选后,切换回精确项/字段JSON提取和仅形状验证。一个确切的已知个人项可能会自动使用桌面回退;除非用户要求搜索,否则不要广泛枚举个人存储库。
编辑过的调试
将整个管道保持在同一tmux会话内。检查状态和输出长度,绝不检查密钥值。
cat > /tmp/op-debug.sh <<'SCRIPT'
#!/usr/bin/env bash
set -euo pipefail
set +x
SIGNIN_OUTPUT="$(op signin --account my.1password.com 2>&1 || true)"
echo "signin output bytes: ${#SIGNIN_OUTPUT}"
op account list 2>&1 | sed -E "s/(xox[baprs]-)[A-Za-z0-9-]+/\\1REDACTED/g; s/(xapp-)[A-Za-z0-9-]+/\\1REDACTED/g"
SCRIPT
chmod 700 /tmp/op-debug.sh
tmux -S "$SOCKET" send-keys -t "$SESSION" -- "bash /tmp/op-debug.sh; rm -f /tmp/op-debug.sh" C-m
防护措施
- 绝不将密钥粘贴到日志、聊天或代码中。
- 优先使用
op run/op inject而不是将密钥写入磁盘。 - 如果无需应用集成即可登录,请使用
op account add。 - 如果命令返回“account is not signed in”,在tmux中重新运行
op signin并在应用中授权。 - 让桌面1Password解锁提示直接请求用户交互;不要先添加单独的聊天许可往返。
- 不要在tmux外部运行
op;如果tmux不可用,请停止并询问。