<svg xmlns="http://www.w3.org/2000/svg" style="display: none;"> <path stroke-linecap="round" d="M5,0 0,2.5 5,5z" id="raphael-marker-block" style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);"></path> </svg>
文档版本: 1.0
调试时间: 2026年3月2日-3日(约14小时)
系统环境: Windows 10/11 + PowerShell
OpenClaw版本: 2026.2.26
错误 1:MiniMax API Key 未找到
日志信息:
GPT plus 代充 只需 145
出现场景: 初始配置时使用了 MiniMax,但未配置 API Key
解决方案:
交互记录:
用户: 换成 kimi API key 如何配置
助手: 执行 ,选择 ,输入 API Key
错误 2:OpenRouter 模型 ID 格式错误
日志信息:
GPT plus 代充 只需 145
出现场景: 使用了错误的 OpenRouter 模型 ID 格式
正确格式对比:
解决方案:
交互记录:
用户: 怎么确定调用的是 Kimi 2.5 呢
助手: 必须指定具体模型,不能用 。修改 为
错误 3:OpenRouter 免费额度不足
日志信息:
GPT plus 代充 只需 145
出现场景: 免费账户调用 Kimi 2.5,token 需求超过额度
额度对比:
解决方案:
方案 A:改用 Auto 模式
方案 B:降低 max_tokens(尝试)
GPT plus 代充 只需 145
方案 C:使用 Moonshot 官方 API
交互记录:
用户: 我只给了你 Openrouter 的 key
助手: 你的 OpenRouter 免费额度只能支持 6855 tokens,而 Kimi 2.5 需要 32000。建议改用 模式或 Moonshot 官方。
错误 4:API Key 自动恢复旧值(关键 Bug)
日志信息:
GPT plus 代充 只需 145
出现场景: 修改 后,运行 自动恢复旧值
根本原因: OpenClaw 从隐藏缓存或同步机制强制覆盖
排查过程:
最终结论: OpenClaw 内部同步机制 bug,未找到隐藏缓存位置
解决方案:
方案 A:使用环境变量覆盖(部分有效)
方案 B:使用 openrouter agent(推荐)
GPT plus 代充 只需 145
方案 C:删除 main agent
交互记录:
用户: 一运行 openclaw dashboard,main agent 的文件 API value 就恢复到原来的 value 数值?这个太诡异了
助手: 这是 OpenClaw 的内部同步机制 bug。建议设置环境变量覆盖,或改用 openrouter agent。
错误 5:飞书配对授权失败
日志信息:
GPT plus 代充 只需 145
出现场景: 用户首次使用飞书 bot,未授权
解决方案:
交互记录:
系统: OpenClaw: access not configured. Pairing code: AQSVTFZA
助手: 执行 批准配对
错误 6:飞书插件重复
日志信息:
GPT plus 代充 只需 145
出现场景: 系统级插件和用户级插件同时存在
插件位置:
解决方案:
交互记录:
用户: 先把飞书这两个 plug-in,有重复的 plug-in 先解决一下
助手: 删除用户级插件,保留系统级官方插件
2.1 查看配置
GPT plus 代充 只需 145
2.2 修改配置
2.3 文件替换
GPT plus 代充 只需 145
2.4 启动命令
GPT plus 代充 只需 145
4.1 模型选择建议
4.2 配置优先级(从高到低)
- 环境变量: (最高优先级)
- 全局配置: 中的
- Agent 列表: 中的 (会覆盖 defaults)
- 文件配置: (会被 dashboard 覆盖)
4.3 已知 Bug
5.1 测试:OpenRouter Auto
5.2 测试:Moonshot 官方
GPT plus 代充 只需 145
5.3 飞书完整配置
文档结束
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/214297.html