密钥管理
OpenClaw 支持增量式 SecretRefs,因此受支持的凭据无需以明文形式保存在配置中。
Note
明文仍然可用。SecretRefs 按凭据选择启用。
Warning
当明文凭据位于代理可检查的文件中时,它们仍对代理可读,包括 openclaw.json、.env、已弃用的 auth-profile JSON 归档,或生成的 agents/*/agent/models.json 文件。一旦所有受支持的凭据都完成迁移,并且 openclaw secrets audit --check 报告没有明文残留,SecretRefs 就会缩小该本地影响范围。
本页是索引。密钥管理文档分布在五个页面中,每个页面对应一种读者任务。 打开与你的任务匹配的页面。
密钥页面¶
| 页面 | 何时阅读 |
|---|---|
| 密钥运行时模型 | 所有者隔离、哨兵注入、代理访问边界以及活动表面过滤。 |
| SecretRef 契约与提供者配置 | SecretRef 契约、id 语法、验证规则,以及 env、file、exec 和 store 提供者块。 |
| 共享密钥存储与出口代理 | 共享密钥存储、密钥出口代理及其流量允许列表,以及基于文件的 API 密钥。 |
| 密钥集成示例 | 1Password、Bitwarden、Vault、pass 和 sops 的 Exec 提供者配方,以及 MCP 和沙箱 SSH。 |
| 密钥操作与行为 | 受支持表面、优先级、激活触发器、降级信号,以及审计和配置工作流。 |
各章节迁移位置¶
之前单页版本中的每个章节、选项卡、步骤和手风琴标题都保留其锚点,因此现有链接(例如
/gateway/secrets#shared-secret-store)仍然可以解析。每个条目指向当前
承载该内容的页面。
- 运行时模型
- 出口时注入(哨兵)
- 代理访问边界
- 活动表面过滤
- 网关认证表面诊断
- 入门参考预检
- SecretRef 契约
- 提供者配置
- 共享密钥存储
- 密钥出口代理
- 流量允许列表
- 基于文件的 API 密钥
- Exec 集成示例
- MCP 服务器环境变量
- 沙箱 SSH 认证材料
- 受支持的凭据表面
- 必需行为与优先级
- 激活触发器
- 降级与恢复信号
- 命令路径解析
- 审计与配置工作流
- 单向安全策略
- 旧版认证兼容性说明
- 控制界面
- 出口时注入(哨兵)
- 非活动表面示例
- env
- file
- exec
- store
- Env 提供者
- File 提供者
- Exec 提供者
- Store 提供者
- 1Password
- Bitwarden Secrets Manager (
bws) - HashiCorp Vault CLI
- password-store (
pass) - sops
- 严格命令路径
- 只读命令路径
- 审计当前状态
- 配置并应用 SecretRefs
- 重新审计
- secrets audit
- secrets configure
- secrets apply
相关¶
- 身份验证 - 身份验证设置
- CLI: secrets - CLI 命令
- Vault SecretRefs - HashiCorp Vault 提供商设置
- 环境变量 - 环境变量优先级
- SecretRef 凭据面 - 凭据面
- Secrets Apply Plan 契约 - 计划契约详情
- 安全 - 安全态势
- 配置参考 - 每个 secrets 和环境变量设置的文档位置
- 询问用户 - 向操作员提出非机密问题;切勿使用凭据回答,请使用掩码的
secrets工具处理这些 - 身份验证凭据语义 - 身份验证配置文件顺序和运行时凭据解析的规范规则
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw