TOPIC / RESOURCE

OpenClaw 配置模板中心:极简、小团队、路由和预算控制四套起手式

这页不是给你一套万能配置模板,而是提供极简、小团队、路由和预算控制四种最常见的起手式,帮助你先决定复杂度该拉到哪一档。每套模板都说明了适用场景、关键字段和扩展方向,让你在动手配置之前就清楚当前适合从哪一档开始、后续该往哪个方向收敛,避免一开始就把配置拉得太复杂。

适合谁

  • 已经知道自己不需要一份"大而全"配置
  • 想先按极简、小团队、路由和预算四档选择复杂度
  • 希望从思路模板开始,而不是先抄一份过大的配置

先把复杂度分层,再写配置

模板页的作用不是让你直接抄一份“大而全”配置,而是先帮你决定:你现在只需要哪一档复杂度。

模板 1:极简配置

适合:

  • 第一次上手
  • 单模型
  • 单渠道
  • 先验证闭环
{
  "goal": "先跑通最小闭环",
  "channel": "只接一个真实渠道",
  "model": "只保留一条稳定模型路线",
  "skills": "只保留当前任务必要能力",
  "auth": "显式设置认证方式",
  "budget": {
    "daily": 5,
    "monthly": 50
  }
}

模板 2:小团队配置

适合:

  • 团队内部协作
  • 有飞书或钉钉入口
  • 需要文档和消息回传
{
  "goal": "先把团队内部协作跑稳",
  "channel": "团队主聊天入口",
  "model": "优先可获得且稳定的路线",
  "skills": ["文档整理", "消息回传", "结构化输出"],
  "safety": "权限从最小范围开始",
  "environments": ["dev", "staging", "prod"]
}

模板 3:路由配置

适合:

  • 已经明确需要 fallback
  • 任务开始分层
  • 你知道哪些任务该去更强模型
{
  "primary": "默认主模型",
  "fallback": "只在主模型失败时启用",
  "routing": {
    "high_value_tasks": "更强模型",
    "routine_tasks": "更便宜模型"
  },
  "alerts": "fallback 触发时保留日志或报警"
}

模板 4:预算控制配置

适合:

  • 已经开始担心账单
  • 长上下文和工具调用变多
  • 需要先收复杂度
{
  "budgetMode": "conservative",
  "contextPolicy": "限制不必要的长历史",
  "toolPolicy": "减少同时挂载的工具和技能",
  "fallbackPolicy": "仅在失败时触发",
  "limits": {
    "hourly": "先给小时级阈值",
    "daily": "再给日限额",
    "monthly": "最后给月度硬阈值"
  }
}

先用哪一套

如果你现在还在问“我该选哪份”,答案通常是:

  1. 先用极简配置
  2. 跑稳后再上小团队配置
  3. 真的需要时再补路由和预算模板

还有两个模板思路,很多人会在第二阶段用到

压缩 / 缓存模板

适合:

  • 对话越来越长
  • 工具越来越多
  • 系统提示已经相对稳定
{
  "promptCaching": {
    "enabled": true,
    "cacheSystemPrompt": true,
    "cacheTools": true
  },
  "compaction": {
    "mode": "safeguard",
    "compressionModel": "便宜模型"
  }
}

多 Agent 分工模板

适合:

  • 已经有明确角色分工
  • 知道每个 Agent 该做什么
  • 不再想把所有能力塞进一个工作区
{
  "agents": [
    "researcher",
    "writer",
    "reviewer"
  ],
  "rule": "每个 Agent 独立 workspace 和 agentDir",
  "coordination": "传摘要,不传整包上下文"
}

模板 5:性能与调试观察模板

适合:

  • 已经开始跑定时任务
  • 日志开始变多
  • 想先知道问题出在哪一层
openclaw config set cache.enabled true
openclaw config set cache.ttl 3600
openclaw config set ai.maxConcurrentRequests 3
openclaw config set ai.timeout 30000
openclaw config set logging.level "debug"
openclaw logs

这组配置的目的不是一次调到最优,而是先建立三件事:

  • 缓存先开起来
  • 并发和超时先收稳
  • 日志先能看懂

模板 6:预算与观察模板

适合:

  • 已经担心 API 调用成本
  • 想先防止意外高额账单
  • 准备观察一周真实使用量
openclaw config set ai.dailyLimit 1000
openclaw config set ai.monthlyBudget 50
openclaw stats usage
openclaw stats cost

第一版更值的是先把“看 usage、看 cost、设限额”做成习惯,而不是一开始就精细抠每个模型的单价。

下一步建议

FAQ

本页常见问题

不一定。它们更像思路模板,用来帮助你决定字段该往哪类配置上收,最终仍要回当前版本支持的写法。

因为第一次最容易犯的错,就是复杂度过高。配置模板更适合按场景分层,而不是追求一个大全文件。