1Password CLI
Folgen Sie den offiziellen CLI-Erste-Schritte-Schritten. Raten Sie keine Installationsbefehle.
Referenzen
- Offizielle Dokumentation: https://developer.1password.com/docs/cli/get-started/
references/get-started.md(Installation + App-Integration + Anmeldevorgang)references/cli-examples.md(echteop-Beispiele, einschließlich sicherer Muster zum Erstellen/Bearbeiten von Einträgen)
Arbeitsablauf
- Betriebssystem + Shell überprüfen.
- Überprüfen, ob die CLI in tmux vorhanden ist:
op --version. - ERFORDERLICH: Genau eine benannte persistente tmux-Sitzung für die gesamte Secret-Aufgabe erstellen.
- Zuerst versuchen, einen eingeschränkten Service-Account-Zugriff zu verwenden, wenn ein passender Token/Workflow vorhanden ist; keine Dialoge.
- Wenn der Service-Account-Zugriff fehlt oder nicht den genauen benötigten Eintrag/das genaue Feld enthält, automatisch den Desktop-App-Fallback in derselben Sitzung versuchen. Nicht zuerst um Chat-Erlaubnis fragen.
- Desktop-Fallback: App-Integration/Entsperrung auslösen, dann
op signineinmal innerhalb derselben Sitzung. Die 1Password-Eingabeaufforderung ist die Benutzerautorisierungsgrenze; nur im Chat fragen, wenn die Aufforderung nicht angezeigt oder abgeschlossen werden kann. - Den gewählten Zugriffspfad innerhalb derselben Sitzung überprüfen:
op whoami. - Bei mehreren Konten:
--accountoderOP_ACCOUNTverwenden. - Wenn ein Befehl fehlschlägt, dieselbe tmux-Sitzung mit
tmux send-keyswiederverwenden; keine zweite Sitzung nur für einen Wiederholungsversuch starten.
Standardkonto
- Das Standardkonto für persönliche/berufliche Secrets ist
my.1password.com. - Nicht stillschweigend
my.1password.eu/ Titan verwenden, es sei denn, es wurde explizit darum gebeten. --account my.1password.combei jedemop-Befehl zum Speichern oder Lesen von Secrets übergeben. Sich nicht auf die automatische Kontoauswahl verlassen.op account listist nur Metadaten, muss aber trotzdem in tmux ausgeführt werden. Verwenden Sie es, um Kontonamen zu bestätigen, wenn die Weiterleitung unklar ist.op signin --account my.1password.comkann den Status 0 ohne nützliche Ausgabe zurückgeben und dennoch eine spätere Shell nicht angemeldet lassen. Bevorzugen Sie es, Anmeldung, Erstellen/Bearbeiten/Abrufen und Überprüfung in derselben tmux-Shell durchzuführen.
Service-Account-Tokens
- Service-Account-Tokens vor jedem interaktiven 1Password-Vorgang bevorzugen. Benutzerdialoge sind nur ein Fallback.
- 1Password-Service-Accounts sind nicht-interaktive Tokens für einen bestimmten Tresor/Bereich, nützlich für Automatisierung ohne Entsperren der Desktop-App.
- Peters standardmäßiger Service-Account-Token wird aus
~/.profilealsOP_SERVICE_ACCOUNT_TOKENin einem Codex-verwalteten Block exportiert. Er ist auf den eingeschränktenMolty-Tresor beschränkt. - Ältere Shells können denselben Wert als
MOLTY_OP_SERVICE_ACCOUNT_TOKENbereitstellen; dies als Fallback-Alias für bekannteMolty-Tresor-Einträge behandeln. - Wenn der Token nicht bereits exportiert ist, nicht zutrifft oder der genaue bekannte Eintrag/das genaue Feld nicht gelesen werden kann, automatisch den Desktop-App-1Password-Vorgang unten verwenden. Nur fragen, wenn eine tatsächliche Entsperrung oder andere Benutzerinteraktion blockiert bleibt.
- Den Token nur für den einzelnen Befehl exportieren/übergeben, der ihn benötigt:
OP_SERVICE_ACCOUNT_TOKEN="$OP_SERVICE_ACCOUNT_TOKEN" op item get "<bekannter Eintrag>" --vault Molty .... - Service-Account-
op-Lesevorgänge erfordern eine explizite Tresorabfrage; das Weglassen von--vault Moltyschlägt fehl, selbst wenn der Token gültig ist. - Die tmux-Regel einhalten: Jeder
op-Befehl, einschließlich Service-Account-Lesevorgänge, läuft weiterhin innerhalb einer einzelnen benannten tmux-Sitzung. - Standardmäßig keine Tresore/Einträge mit Service-Accounts auflisten. Wenn der Benutzer explizit bittet zu suchen, einen Screenshot/eine Auflistung gibt oder nur einen ungefähren Eintragsnamen angibt, die sichere Metadatensuche unten vor dem Desktop-Fallback verwenden.
- Nur Vorhandensein/Form anzeigen, niemals Token- oder Secret-Werte.
Erforderliche persistente tmux-Sitzung
Das Shell-Tool verwendet pro Befehl eine neue TTY. Führen Sie op innerhalb einer dedizierten tmux-Sitzung aus und verwenden Sie dieselbe Sitzung, bis die gesamte Secret-Aufgabe erledigt ist. Service-Account-Befehle werden ebenfalls hier ausgeführt, dürfen aber keine App-Aufforderungen auslösen.
Beispiel:
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
Keine neue tmux-Sitzung nach einem Fehler bei Anführungszeichen, Eintragsnamen oder Befehl erstellen. Einen korrigierten Befehl in die vorhandene Sitzung senden.
Die Sitzung als $SESSION: ansprechen, nicht Fenster 0 annehmen; ältere Sitzungen können Fensterindizes haben, die bei 1 beginnen.
Dienstspezifische Arbeitsabläufe
- Dienstspezifische Authentifizierungsdetails in der zugehörigen Skill belassen.
- Für npm-Registrierungs-/Paketarbeit
$npmverwenden; es dokumentiert den Molty-Service-Account-Eintrag, den nicht-interaktiven Authentifizierungs-Wrapper und den Paketreservierungs-Helfer. - Diese Skill besitzt nur die generischen 1Password-Regeln: tmux-only
op, gezielte Lesevorgänge, eine persistente Sitzung, keine breite Auflistung, keine Secret-Ausgabe.
Bekanntes funktionierendes Secret-Schreibmuster
Die persistente tmux-Sitzung verwenden. Die genaue Secret-Aufgabe in ein temporäres Skript schreiben, dann dieses Skript an op-work senden; keine zweite tmux-Sitzung für Wiederholungsversuche erstellen.
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
Der op-Kategoriename ist in diesem CLI-Build lesbar und groß-/kleinschreibungssensitiv; verwenden Sie "API Credential", nicht api_credential.
Exakte Feldlesungen
Bei einem bekannten Eintrag die Feldform überprüfen, bevor Sie es live verwenden: Länge, erwartetes Präfix, Anzahl Zeilenumbrüche, niemals den Wert. op --field NAME und --fields label=NAME können das falsche versteckte Feld zurückgeben, wenn ein Eintrag doppelte/veraltete Anmeldeinformationsfelder hat. Wenn die Form falsch ist, den bekannten Eintrag als JSON lesen und das genaue Label extrahieren.
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-Extraktion auf den bekannten Eintrag und Tresor beschränken. Keine Tresore/Einträge auflisten, um Kandidaten zu entdecken.
Explizite Eintragssuche
Nur verwenden, wenn der Benutzer explizit bittet zu suchen, einen Screenshot/eine Auflistung gibt oder die genaue Titelschätzung fehlgeschlagen ist und der Benutzer nach Regex/unscharfer Suche fragt. Auf Tresor beschränkt und nur Metadaten bleiben; Kandidatentitel/IDs/Kategorien/Tresornamen anzeigen, niemals Felder oder Werte. Bevorzugt zuerst exakte sichtbare Zeichenfolgen aus Screenshots verwenden: Tresorname, Eintragstitel und Feldbezeichnung.
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
Nach der Auswahl eines Kandidaten zurück zur exakten Eintrags-/Feld-JSON-Extraktion und formgesteuerten Validierung wechseln. Ein genauer bekannter persönlicher Eintrag kann automatisch den Desktop-Fallback verwenden; persönliche Tresore nicht breit auflisten, es sei denn, der Benutzer hat darum gebeten zu suchen.
Geschwärztes Debugging
Die gesamte Pipeline innerhalb derselben tmux-Sitzung halten. Status und Ausgabelänge überprüfen, niemals Secret-Werte.
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
Schutzmaßnahmen
- Niemals Secrets in Logs, Chat oder Code einfügen.
op run/op injectgegenüber dem Schreiben von Secrets auf die Festplatte bevorzugen.- Wenn eine Anmeldung ohne App-Integration erforderlich ist,
op account addverwenden. - Wenn ein Befehl "account is not signed in" zurückgibt,
op signinin tmux erneut ausführen und in der App autorisieren. - Die Desktop-1Password-Entsperraufforderung die Benutzerinteraktion direkt anfordern lassen; keine separate Chat-Erlaubnis-Round-Trip davor einfügen.
opnicht außerhalb von tmux ausführen; anhalten und fragen, wenn tmux nicht verfügbar ist.