模型与提供商

配置 OpenClaw 模型提供商、provider-qualified model refs、OAuth/API 凭证、fallback、用量报告和 SecretRef-backed auth。

OpenClaw 把 Agent runtime 和模型提供商分开。一个 Gateway 可以为不同 Agent、任务或 fallback 使用不同 provider。

Model References

模型引用通常带 provider 前缀：

anthropic/claude-opus-4-6
openai/gpt-5
openrouter/moonshotai/kimi-k2
ollama/llama3

这样可以减少不同 provider 模型同名时的歧义。

凭证路径

OpenClaw 支持：

• API keys
• OAuth 或 subscription-backed profiles
• provider-specific auth profiles
• 指向 env/file/command 的 SecretRefs
• plugin/provider managed auth

优先使用 SecretRefs 或 auth profiles，不要把 secrets 写进 config 或 prompt 文件。

openclaw secrets audit
openclaw models status
openclaw models list

Per-Agent Models

{
  "agents": {
    "list": [
      { "id": "main", "model": "anthropic/claude-opus-4-6" },
      { "id": "quick", "model": "openai/gpt-5-mini" },
      { "id": "local", "model": "ollama/llama3" }
    ]
  }
}

按任务选模型：

• 强推理用于规划、编码、恢复
• 便宜模型用于分类
• 本地模型用于隐私或低风险任务
• 媒体 provider 用于图片、音频、视频

Fallbacks 与 Routing

Fallback 在 provider 限流、故障或缺能力时有用，但必须显式配置和测试。

检查：

1. provider ID 是否规范
2. tool schema 是否兼容
3. tool-heavy session replay 是否安全
4. credential 是否 profile-aware
5. 用量和成本是否可见

用量报告

openclaw status --usage
openclaw sessions list --usage

聊天里也可以控制：

/usage tokens
/usage full
/usage off

Provider dashboard 仍然是计费事实来源。

本地模型

ollama pull llama3
openclaw models list

本地模型不一定支持所有工具 schema、上下文窗口或媒体能力。使用前要实际测试。

Provider Selection Checklist

• Provider 是否支持 OpenClaw 需要的工具 schema？
• 是否支持所需上下文窗口？
• 凭证是否 scoped 到正确 Agent？
• 是否有 fallback？
• 是否能看到用量？
• 媒体或 web-grounded tools 是否 provider-specific？
• Provider 是否适合敏感数据？