Bitwarden 凭据技能

通过 CLI 将凭据（密码、API 密钥、OAuth 令牌等）存储到 Bitwarden。

工作流程

步骤 1：确保保险库已解锁

用户必须在会话期间仅需解锁一次其 Bitwarden 保险库：

bw unlock

解锁后，系统会生成一个会话密钥。有两种方式提供该密钥：

选项 A — 导出会话（用户在终端中执行）：

export BW_SESSION="<unlock 命令返回的会话密钥>"

然后告知我“已解锁”，我即可直接运行命令。

选项 B — 将会话密钥直接传递给脚本：

BW_SESSION="<session-key>" ./bitwarden-credential.sh <name> <username> <password> [notes]

步骤 2：存储凭据

保险库解锁后，请提供以下信息：

• 名称 — 该凭据的标识符（例如：“GitHub API 密钥”、“MiniMax API”）
• 用户名 — 通常为 client_id 或密钥名称
• 密码/密钥 — 实际的密钥值
• 备注（可选）—— 额外上下文（如作用范围、grant_type 等）

示例用户输入：

“保存到 Bitwarden：name=Grafana, username=admin, password=xyz123, notes=生产服务器”

步骤 3：执行操作

可使用内置脚本或直接调用 bw CLI：

# 当 BW_SESSION 已设置时
./scripts/bitwarden-credential.sh "<name>" "<username>" "<password>" "[notes]"

# 或通过 bw CLI 直接执行
echo -n '{"name":"...","login":{"username":"...","password":"..."},"type":1}' | bw create item

注意事项

• 必须安装 Bitwarden CLI：brew install bitwarden-cli
• API 密钥认证：使用 bw login --apikey 配合 client_id 和 client_secret，但保险库仍需主密码解锁
• 我无法为您解锁保险库 —— 主密码不会离开您的终端
• 会话令牌（BW_SESSION）具有会话作用域；当保险库再次锁定时将失效