OpenClaw 配置踩坑记：那些差点把我送走的问题#
踩了整整两天，记录下来希望别再踩第二次。
1. 模型配置那些破事#
1.1 模型名写错了#
写配置的时候顺手就写：
"primary": "claude-sonnet-4-6"
结果直接报错：
Unknown model: anthropic-local/claude-sonnet-4-6
后来才搞明白，得写成完整路径：
"primary": "anthropic-local/claude-sonnet-4-6"
而且 providers 里得先定义好这个模型。
1.2 本地模型认证#
用 anthropic-local 的时候一直提示：
No API key found for provider "anthropic-local"
后来发现认证要在两个地方都配置：
~/.openclaw/agents/main/agent/auth-profiles.json（优先）openclaw.json的 providers 里
本地模型其实不用 key，但配置格式要对。
1.3 模型回退#
有时候主力模型挂了，配置了 fallback 但不生效。后来发现是 fallback 模型的 provider 也要在列表里定义，光写名字没用。
2. 消息与频道#
2.1 频道配置#
配置 Telegram 的时候一直连不上，后来发现是 chat_id 格式写错了。
正确的格式：
{
"channels": {
"telegram": {
"botToken": "xxx",
" chats": {
"allowed": ["xxx"]
}
}
}
}
2.2 群组mention#
群组里 @机器人一直不回，后来才知道要开 requireMention: true。
3. Cron 任务#
3.1 模型字段#
定时任务里的 agentTurn 必须带 model 字段，不然直接报错不跑。
{
"payload": {
"kind": "agentTurn",
"message": "xxx",
"model": "anthropic-local/claude-sonnet-4-6"
}
}
systemEvent 不用带 model。
3.2 任务超时#
任务跑一半就停了，后来发现是超时时间设太短。复杂任务建议设 300 秒以上。
4. MCP 相关#
4.1 MCP 服务启动失败#
MCP 服务一直起不来，日志里全是路径错误。
后来发现是配置文件路径问题，本机要用绝对路径。
4.2 MCP 调用格式#
之前一直用 JSON 格式调用，后来发现简化的 key=value 格式也能用：
# 完整格式
mcporter call mcp-server command='{"name":"xxx"}'
# 简化格式
mcporter call playwright.browser_navigate url="https://xxx"
5. Skills#
5.1 加载路径#
Skills 加载不到，配置路径写的是相对路径。本机一定要用绝对路径：
{
"skills": {
"load": {
"extraDirs": ["/Users/johny/.agents/skills"]
}
}
}
5.2 Skill 调用#
同一个 Skill 换了个名字就调用不到了，后来发现是 skill 名大小写敏感。
6. 总结#
配置类的问题大多出在：
- 路径用相对路径
- 模型名写不全
- 认证配置漏配
建议跑之前先跑 openclaw status 检查下配置有没有问题，很多错误能提前发现。
有问题欢迎交流，踩坑真的很难受。