机密信息管理

• 已禁用的渠道/账户条目。
• 没有任何已启用账户继承的顶层渠道凭证。
• 已禁用的工具/功能表面。
• 未被 tools.web.search.provider 选中的 Web 搜索提供商专用键。在 auto 模式（未设置提供商）下，会按优先级查询这些键，用于提供商自动检测，直到其中一个解析成功。选择完成后，未选中的提供商键会被视为非活动，直到被选中。
• 沙箱 SSH 身份验证材料（agents.defaults.sandbox.ssh.identityData、certificateData、knownHostsData，以及每个智能体的覆盖项）只有在默认智能体或已启用智能体的有效沙箱后端为 ssh 时才处于活动状态。
• 如果以下任一条件为真，则 gateway.remote.token / gateway.remote.password SecretRefs 处于活动状态：
  • gateway.mode=remote
  • 已配置 gateway.remote.url
  • gateway.tailscale.mode 为 serve 或 funnel
  • 在没有这些远程表面的本地模式下：
    • 当令牌身份验证可以获胜且未配置环境变量/身份验证令牌时，gateway.remote.token 处于活动状态。
    • 只有当密码身份验证可以获胜且未配置环境变量/身份验证密码时，gateway.remote.password 才处于活动状态。
• 当设置了 OPENCLAW_GATEWAY_TOKEN 时，gateway.auth.token SecretRef 对启动身份验证解析处于非活动状态，因为环境变量令牌输入会在该运行时获胜。

• 可通过 allowlist 配置可选允许列表。
• 缺失/空环境变量值会导致解析失败。

• 从 path 读取本地文件。
• mode: "json" 需要 JSON 对象载荷，并将 id 作为 pointer 解析。
• mode: "singleValue" 需要引用 id "value"，并返回文件内容。
• 路径必须通过所有权/权限检查。
• Windows fail-closed 注意事项：如果某个路径无法执行 ACL 验证，则解析失败。仅对可信路径，可在该提供商上设置 allowInsecurePath: true 以绕过路径安全检查。

• 运行配置的绝对二进制路径，不使用 shell。
• 默认情况下，command 必须指向常规文件（不是符号链接）。
• 设置 allowSymlinkCommand: true 可允许符号链接命令路径（例如 Homebrew shims）。OpenClaw 会验证解析后的目标路径。
• 将 allowSymlinkCommand 与 trustedDirs 搭配用于包管理器路径（例如 ["/opt/homebrew"]）。
• 支持超时、无输出超时、输出字节限制、环境变量允许列表和可信目录。
• Windows fail-closed 注意事项：如果命令路径无法执行 ACL 验证，则解析失败。仅对可信路径，可在该提供商上设置 allowInsecurePath: true 以绕过路径安全检查。

请求载荷（stdin）：

{ "protocolVersion": 1, "provider": "vault", "ids": ["providers/openai/apiKey"] }

响应载荷（stdout）：

{ "protocolVersion": 1, "values": { "providers/openai/apiKey": "<openai-api-key>" } } // pragma: allowlist secret

可选的按 id 错误：

{
  "protocolVersion": 1,
  "values": {},
  "errors": { "providers/openai/apiKey": { "message": "not found" } }
}

{
  secrets: {
    providers: {
      onepassword_openai: {
        source: "exec",
        command: "/opt/homebrew/bin/op",
        allowSymlinkCommand: true, // required for Homebrew symlinked binaries
        trustedDirs: ["/opt/homebrew"],
        args: ["read", "op://Personal/OpenClaw QA API Key/password"],
        passEnv: ["HOME"],
        jsonOnly: false,
      },
    },
  },
  models: {
    providers: {
      openai: {
        baseUrl: "https://api.openai.com/v1",
        models: [{ id: "gpt-5", name: "gpt-5" }],
        apiKey: { source: "exec", provider: "onepassword_openai", id: "value" },
      },
    },
  },
}

{
  secrets: {
    providers: {
      vault_openai: {
        source: "exec",
        command: "/opt/homebrew/bin/vault",
        allowSymlinkCommand: true, // required for Homebrew symlinked binaries
        trustedDirs: ["/opt/homebrew"],
        args: ["kv", "get", "-field=OPENAI_API_KEY", "secret/openclaw"],
        passEnv: ["VAULT_ADDR", "VAULT_TOKEN"],
        jsonOnly: false,
      },
    },
  },
  models: {
    providers: {
      openai: {
        baseUrl: "https://api.openai.com/v1",
        models: [{ id: "gpt-5", name: "gpt-5" }],
        apiKey: { source: "exec", provider: "vault_openai", id: "value" },
      },
    },
  },
}

{
  secrets: {
    providers: {
      sops_openai: {
        source: "exec",
        command: "/opt/homebrew/bin/sops",
        allowSymlinkCommand: true, // required for Homebrew symlinked binaries
        trustedDirs: ["/opt/homebrew"],
        args: ["-d", "--extract", '["providers"]["openai"]["apiKey"]', "/path/to/secrets.enc.json"],
        passEnv: ["SOPS_AGE_KEY_FILE"],
        jsonOnly: false,
      },
    },
  },
  models: {
    providers: {
      openai: {
        baseUrl: "https://api.openai.com/v1",
        models: [{ id: "gpt-5", name: "gpt-5" }],
        apiKey: { source: "exec", provider: "sops_openai", id: "value" },
      },
    },
  },
}

发现项包括：

• 静态存储的明文值（openclaw.json、auth-profiles.json、.env，以及生成的 agents/*/agent/models.json）
• 生成的 models.json 条目中残留的明文敏感提供商标头
• 未解析的引用
• 优先级遮蔽（auth-profiles.json 优先于 openclaw.json 引用）
• 旧版残留（auth.json、OAuth 提醒）

Exec 说明：

• 默认情况下，审计会跳过 exec SecretRef 可解析性检查，以避免命令副作用。
• 使用 openclaw secrets audit --allow-exec 可在审计期间执行 exec 提供商。

标头残留说明：

• 敏感提供商标头检测基于名称启发式规则（常见认证/凭证标头名称和片段，例如 authorization、x-api-key、token、secret、password 和 credential）。

交互式辅助工具会：

• 先配置 secrets.providers（env/file/exec，添加/编辑/移除）
• 让你为一个智能体范围选择 openclaw.json 加 auth-profiles.json 中受支持的带 secret 字段
• 可以直接在目标选择器中创建新的 auth-profiles.json 映射
• 捕获 SecretRef 详细信息（source、provider、id）
• 运行预检解析
• 可以立即应用

Exec 说明：

• 除非设置 --allow-exec，否则预检会跳过 exec SecretRef 检查。
• 如果你直接从 configure --apply 应用，并且计划包含 exec 引用/提供商，也要为应用步骤保留 --allow-exec。

有用模式：

• openclaw secrets configure --providers-only
• openclaw secrets configure --skip-provider-setup
• openclaw secrets configure --agent <id>

configure 应用默认行为：

• 从 auth-profiles.json 中清除目标提供商匹配的静态凭证
• 从 auth.json 中清除旧版静态 api_key 条目
• 从 <config-dir>/.env 中清除匹配的已知 secret 行

应用已保存的计划：

openclaw secrets apply --from /tmp/openclaw-secrets-plan.json
openclaw secrets apply --from /tmp/openclaw-secrets-plan.json --allow-exec
openclaw secrets apply --from /tmp/openclaw-secrets-plan.json --dry-run
openclaw secrets apply --from /tmp/openclaw-secrets-plan.json --dry-run --allow-exec

Exec 说明：

• dry-run 会跳过 exec 检查，除非设置了 --allow-exec。
• 写入模式会拒绝包含 exec SecretRefs/提供商的计划，除非设置了 --allow-exec。

有关严格目标/路径契约详情和精确拒绝规则，请参阅 Secrets Apply Plan Contract。