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 的預設服務帳戶權杖透過 Codex 管理的區塊,從
~/.profile匯出為OP_SERVICE_ACCOUNT_TOKEN。其範圍限定於受限的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 registry/套件工作,使用
$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 不可用,請停止並詢問。