OpenClaw(龙虾)可以接本地模型,但不要默认以为“能聊天”就等于“能做 Agent”。本地 OpenAI-compatible 后端如果小请求能通、OpenClaw agent turn 却失败,通常是消息格式、工具调用或上下文长度不兼容。
先做三层测试
- 直接打本地
/v1/chat/completions,确认后端可用。 - 用
openclaw infer model run测模型在 OpenClaw 里能否完成基础回复。 - 再让 Agent 调一次简单工具,例如读一个小文件或执行安全命令。
常见兼容修法
- 报
messages[].content需要字符串:给该模型加compat.requiresStringContent: true。 - 普通聊天可以、工具调用失败:考虑设置
compat.supportsTools: false,不要让它承担工具型任务。 - 小 prompt 可以、大上下文崩溃:这是模型或服务端限制,减少上下文或换后端。
本地模型适合隐私、离线和低成本场景,但复杂工具链更吃模型稳定性。建议把本地模型放在低风险任务或 fallback 里,关键自动化仍用强模型兜底。
官方开源地址:https://github.com/openclaw/openclaw。
最稳的做法是给本地模型单独建一个测试 agent,只允许低风险工具。确认它能稳定处理上下文、工具调用和错误恢复后,再把它放到主 agent 的 fallback 里。