OpenClaw配置详解.md | 活死人の行知路

模型设置

全局默认（defaults）

打开 ~/.openclaw/openclaw.json，设置模型，如智谱，配置片段：

{
  env: { ZAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "zai/glm-4.5-air" } } },
}

defaults: 当前配置是全局默认（defaults）。这意味着所有没有单独指定模型的 agent 都会默认使用 glm-4.5-air。

飞书渠道配置

agents: {
  defaults: {
    model: {
      primary: 'zai/glm-5',           // 全局后备
      fallbacks: ['zai/glm-4.7']      // 可选，全局降级链
    },
    // 其他全局默认...
  },

  list: [
    {
      id: 'coding',                     // 内部ID
      name: '代码助手',
      // 可以覆盖全局
      model: {
        primary: 'anthropic/claude-sonnet-4-6',   // 这个 agent 用更强的模型
        fallbacks: ['openai/gpt-5.2-mini']
      }
    },
    {
      id: 'research',
      name: '研究助手',
      model: {
        primary: 'google/gemini-3-pro'            // 用另一个供应商的模型
      }
    },
    {
      id: 'cheap-tasks',
      name: '快速杂务',
      model: {
        primary: 'openai/gpt-5.2-mini'            // 故意用便宜快速模型
      }
    }
    // ... 可以继续加更多
  ]
}

primary 的作用是什么？为什么叫 primary？

primary 是首选模型（first choice）。
当 primary 不可用（限额、超时、403等）时，才会按顺序尝试 fallbacks 里的模型。
所以你看到叫 primary，就是因为它支持多层 failover（主模型 + 降级链）设计。

全局的 agents.defaults.model 只是“没特别指定的 agent”用的默认值。

每个具体 agent 都可以通过 agents.list[].model.primary（以及 fallbacks）来覆盖。