vault

适用场景：当你需要安全的本地存储来保存密码、API 密钥或凭据时。

🔒 AES-256-GCM 加密 — 该插件使用行业标准的 AES-256-GCM 加密算法，并结合主密钥（master key）对密码进行加密存储。

功能特性

• 🔒 所有存储的密码均采用 AES-256-GCM 加密
• 📝 简洁的命令行接口
• 🗂️ 密钥管理与列表查看
• 💾 基于 JSON 的本地存储（已加密）
• 🕐 自动时间戳追踪
• 🔑 主密钥保护机制

安装

clawhub install vault

使用方法

设置密码

vault gemini sk-abc123xyz

查看密码

vault gemini show

删除密码

vault gemini remove

列出所有密钥

vault list

配置

主密钥（必需）

通过环境变量设置主加密密钥：

export VAULT_MASTER_KEY="your-secure-master-key-here"

或在你的 OpenClaw 配置文件中设置：

{
  "plugins": {
    "vault": {
      "masterKey": "your-secure-master-key-here",
      "storageFile": ".vault/passwords.json"
    }
  }
}

可选配置项：

• masterKey — 主加密密钥（也可通过环境变量 VAULT_MASTER_KEY 设置）
• storageFile（默认值：.vault/passwords.json）— 存储文件路径，相对于用户主目录（home directory）

⚠️ 重要提示：请务必妥善保管主密钥！一旦丢失，将无法解密已存储的密码。

安全性

🔒 加密细节：

• 算法：AES-256-GCM（Galois/Counter Mode）
• 密钥派生：使用 scrypt 算法，每个密码对应一个随机 salt
• IV（初始化向量）：每个密码使用一个随机的 12 字节 IV（符合 GCM 推荐长度）
• Salt：每个密码使用一个随机的 32 字节 salt，并随加密数据一同存储
• 认证：使用 GCM 认证标签（authentication tag）确保数据完整性

安全最佳实践：

• 使用强且唯一的主密钥（建议至少 32 个字符）
• 安全地存储主密钥（例如通过环境变量或受保护的配置文件）
• 设置严格的文件权限：chmod 600 ~/.vault/passwords.json
• 将 .vault/ 添加至你的 .gitignore 文件中
• 切勿将主密钥提交至版本控制系统
• 启用系统级磁盘加密以获得额外防护
• 安全备份主密钥 — 密钥丢失即意味着所有密码不可恢复

适用场景：

• 开发/测试环境中的凭据
• API 密钥与令牌
• 个人密码
• 团队共享凭据（需配合安全的密钥分发机制）

示例

# 保存 API 密钥
vault openai sk-proj-abc123
vault anthropic sk-ant-xyz789

# 查看某个密钥
vault openai show
# 输出：Password for 'openai': sk-proj-abc123

# 列出所有密钥
vault list
# 输出：
# Stored passwords:
# • openai (created: 2026-02-17T..., updated: 2026-02-17T...)
# • anthropic (created: 2026-02-17T..., updated: 2026-02-17T...)

# 删除某个密钥
vault openai remove

相关链接

• GitHub：https://github.com/zuiho-kai/openclaw-vault
• Issues：https://github.com/zuiho-kai/openclaw-vault/issues