openclaw多模型名称填写错误会导致模型加载失败、任务启动中断或代理报错退出,必须严格遵循命名规范:模块名以llm.开头且仅含字母数字下划线;model字段按api类型区分,公网模型不加前缀,ollama本地模型须加ollama/前缀;运行时引用模块名而非model值。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

确认模型配置模块名
打开 config.toml 文件,定位到你要配置的模型区块,例如:
[llm.ollama] 或 [llm.qwen] 或 [llm.ernie]。
【模块名必须以 llm. 开头,且只能包含字母、数字、下划线】,不能含空格、点号(.)、连字符(-)或中文。
若写成 [llm.my-model] 或 [llm.gpt-4o],OpenHands 会因非法字符拒绝解析该段,后续所有参数将被忽略。
模型名称字段填写规则
在已确认合法的模块块内,填写 model 参数时需区分两类场景:
方法一:调用 OpenAI 兼容 API 的模型
直接填模型服务商规定的完整模型标识符,例如:model = "qwen/qwen2.5-72b" 或 model = "ernie-bot-4"。
注意:此处不加 vendor 前缀(如 ollama/、openai/),除非服务商明确要求。
OpenClaw配置管理最佳实践与常见陷阱。适用场景:(1) 修改配置,(2) 询问路径或结构,(3) 遇到配置错误,(4) 添加渠道,(5) 修改前避免路径错误或直接编辑JSON等常见错误。
方法二:调用本地 Ollama 模型
必须带 ollama/ 前缀,例如:model = "ollama/qwen2:7b" 或 model = "ollama/llama3.2:3b"。
不加前缀会导致 LiteLLM 无法识别为本地模型,转而尝试走 OpenAI 路径并报 404。
多模型共存时的命名实践
第一步:为每个模型分配唯一且语义清晰的模块名
例如:
[llm.qwen_online] → 调用千问公网 API
[llm.qwen_local] → 调用本机 Ollama 的 qwen2:7b
[llm.claude_sonnet] → 调用 Anthropic Sonnet
第二步:确保各模块的 model 字段值与实际部署一致
比如 [llm.qwen_local] 下写 model = "ollama/qwen2:7b",而 [llm.qwen_online] 下写 model = "qwen/qwen2.5-72b",二者不可混用。
第三步:在运行命令中正确引用模块名
执行评估脚本时,必须用模块名而非 model 字段值:./scripts/run_infer.sh qwen_local swe-bench-lite ...
【这里填的是 llm.qwen_local 中的 qwen_local,不是 model 字段里的 ollama/qwen2:7b】









