密钥
所有受支持的凭据字段都使用一个 SecretRef:env、file、exec(1Password、Vault、Bitwarden 和 sops 即通过这种方式接入),或共享存储。当已映射且可隔离的属主发生可重试的解析失败时,Gateway 会以降级状态启动。确切的属主(一个提供方、一个频道账号、一个插件路由)会被标记为不可用,对它的请求会因类型化错误而失败,不会回退到其他凭据;并且 doctor 和 status 会指出每个降级属主并附带脱敏原因。Gateway 入站认证失败、未知属主和无效的密钥配置仍会阻止启动。
模型提供方的凭据在受支持的出口路径上使用哨兵值:真实值会在出口边界处被替换,而无法识别的哨兵形态值会被拒绝,而不是被转发。操作员可以在 Control UI 的 设置 → 密钥 下选择受保护的 密钥 类型来提供凭据,而无需向 agent 暴露其值。受保护的值会从面向 agent 的读取中省略;另有一个管理员作用域的解析操作供操作员使用。agent 可读的环境变量条目则属于不同的类型。需显式启用的 出口代理 只针对受保护哨兵值所绑定的目标主机替换哨兵值。即使仅窃取加密的哨兵值,也不会在 Gateway 进程之外泄露底层凭据,但这并不能保护其他私有上下文,也无法阻止已授权服务被滥用。被允许的服务也可以将凭据回传给 agent,因此目标信任和主机隔离仍然重要。agent 请求的密钥 提示使用同一个受保护存储,而不会把提交的值放入对话中。
mermaid actions={true} placement="top-right"
flowchart LR
OPR["Operator"] -->|"Settings: Secrets, protected secret kind"| STORE["Protected store"]
AGT["Agent context"] -.->|"agent-requested secret: prompt"| OPR
STORE -->|"protected handle, not submitted value"| AGT
AGT -->|"sentinel on supported paths"| OUT["Outbound request"]
OUT --> EG["Configured egress boundary"]
STORE -->|"resolve"| EG
EG -->|"credential substituted for its bound host"| API["Allowed destination"]
EG -->|"unrecognized sentinel"| REF["Refused"]
Hermes 支持环境变量和 Vault 托管的凭据、用于多路复用配置文件的上下文本地密钥解析,以及可选的 iron-proxy 集成,后者向 Docker 工具提供不透明的提供商令牌,同时由主机侧代理注入凭据。这些是真实的保护措施,但在保管方式和绕过限制上有所不同;这两个项目的代理都不能替代进程和网络隔离。在 OpenClaw 中,secrets audit 会查找静态明文,secrets configure --apply 则会把受支持的字段改为通过引用(refs)提供。工作区 .env 文件不能覆盖提供方密钥或 OPENCLAW_* 运行时控制。
OpenClaw 以集成式 Gateway 流程提供 agent 请求的凭据:操作员通过受保护的界面提交值,agent 则会收到一个可复用的句柄。这并非独一无二的模式。MCP 支持针对敏感数据的带外 URL 获取,包括由服务器存储以供后续使用的凭据;它禁止通过表单模式获取密钥。Hermes 也支持由操作员配置的 vault 解析。这些机制的区别在于集成方式和保管方式,而不在于凭据能否始终不进入模型上下文。
存储本身是 0600 权限的 SQLite,而不是 HSM;文档会引导有更强保管需求的操作员使用外部 vault。SecretRef 会把内联凭据从引用它的配置中移除;存储暴露程度取决于所选的提供方。它并不能阻止 host-exec agent 读取文件。限制文件访问是沙箱的职责。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw