Bitwarden CLI

通过 Bitwarden CLI 管理密码和密钥。

参考资料

• references/get-started.md（安装 + 登录 + 解锁流程）
• references/cli-examples.md（真实的bw示例）

工作流程

1. 检查 CLI 是否存在：bw --version。
2. 检查登录状态：bw status（返回包含状态字段的 JSON）。
3. 如果未登录：bw login（存储 API 密钥，提示输入主密码）。
4. 必需：为所有bw命令创建一个全新的 tmux 会话。
5. 在 tmux 内解锁保险库：bw unlock（输出会话密钥）。
6. 导出会话密钥：export BW_SESSION="<密钥>"。
7. 验证访问权限：bw sync然后bw list items --search test。

必需的 tmux 会话

Bitwarden CLI 要求为经过身份验证的命令设置 BW_SESSION 环境变量。为了在命令间保持会话持久性，请始终在专用的 tmux 会话中运行bw。

示例（有关套接字约定，请参阅tmux技能）：

SOCKET_DIR="${CLAWDBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/openclaw-tmux-sockets}"
mkdir -p "$SOCKET_DIR"
SOCKET="$SOCKET_DIR/openclaw-bw.sock"
SESSION="bw-auth-$(date +%Y%m%d-%H%M%S)"

tmux -S "$SOCKET" new -d -s "$SESSION" -n shell

# Unlock and capture session key
tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- 'export BW_SESSION=$(bw unlock --raw)' Enter
tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- 'bw sync' Enter
tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- 'bw list items --search github' Enter

# Capture output
tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200

# Cleanup when done
tmux -S "$SOCKET" kill-session -t "$SESSION"

常用命令

安全护栏

• 切勿将秘密信息粘贴到日志、聊天或代码中。
• 始终使用tmux来跨命令维护BW_SESSION。
• 首选bw get password而非解析完整的项目JSON，当仅需密码时。
• 如果命令返回“Vault is locked”，请重新运行bw unlock在tmux内。
• 不要在tmux外运行需要认证的bw命令；会话将不会持久保存。
• 完成后锁定保管库：bw lock。

使用Vaultwarden进行测试

此技能包含一个Docker Compose设置，用于通过Vaultwarden（自托管的Bitwarden兼容服务器）进行本地测试。

快速开始

# Install mkcert and generate local certs (one-time)
brew install mkcert
mkcert -install
cd /path/to/openclaw-bitwarden
mkdir -p certs && cd certs
mkcert localhost 127.0.0.1 ::1
cd ..

# Start Vaultwarden + Caddy
docker compose up -d

# Configure bw CLI to use local server
bw config server https://localhost:8443

# Create a test account via web UI at https://localhost:8443
# Or run the setup script:
./scripts/setup-test-account.sh

# Test the skill workflow
./scripts/test-skill-workflow.sh

测试凭据

• 服务器URL： https://localhost:8443
• 管理面板： https://localhost:8443/admin（令牌：测试管理员令牌-12345)
• 建议测试账户： test@example.com/ TestPassword123!

Node.js CA 信任

bw CLI 需要信任 mkcert CA。在运行 bw 命令前导出：

export NODE_EXTRA_CA_CERTS="$(mkcert -CAROOT)/rootCA.pem"

或添加到您的 shell 配置文件中以持久化。

清理

docker compose down -v  # Remove container and data