运行时依赖
安装命令
点击复制技能文档
mimo-API-fix 问题症状
OpenClaw 调用 mimo-v2.5-pro 时报错:
400 Param Incorrect 提供者 rejected the 请求 模式 or 工具 payload fAIloverReason: "格式化" 提供者运行time失败Kind: "模式"
系统会自动 fallback 到其他模型(如 qwen3.5:122b)。
诊断流程 Step 1: 确认 API 端点可用 # 从配置获取 API key 和 baseUrl API_KEY=$(python3 -c "导入 json; d=json.load(open('$HOME/.OpenClaw/OpenClaw.json')); print(d['模型s']['提供者s']['custom']['APIKey'])") BASE_URL=$(python3 -c "导入 json; d=json.load(open('$HOME/.OpenClaw/OpenClaw.json')); print(d['模型s']['提供者s']['custom']['baseUrl'])")
# 测试基础连通性 curl -s "$BASE_URL/模型s" -H "Authorization: Bearer $API_KEY" | python3 -m json.工具 | head -20
Step 2: 测试无工具调用 curl -s "$BASE_URL/chat/completions" \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: 应用/json" \ -d '{ "模型": "mimo-v2.5-pro", "messages": [{"角色":"user","content":"hello, reply with one word"}], "max_令牌s": 50 }' | python3 -m json.工具
如果失败 → API 端点本身有问题,不是 OpenClaw 的问题。
Step 3: 测试带工具调用 curl -s "$BASE_URL/chat/completions" \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: 应用/json" \ -d '{ "模型": "mimo-v2.5-pro", "messages": [{"角色":"user","content":"what is the weather? use 获取_weather 工具"}], "工具s": [{"type":"function","function":{"name":"获取_weather","description":"获取 weather","parameters":{"type":"object","properties":{"location":{"type":"string"}},"required":["location"]}}}], "max_令牌s": 500 }' | python3 -m json.工具
检查返回中 finish_reason 是否为 "工具_calls",工具_calls 是否有内容。
Step 4: 检查 OpenClaw 配置 python3 -c " 导入 json d = json.load(open('$HOME/.OpenClaw/OpenClaw.json')) for m in d['模型s']['提供者s']['custom']['模型s']: if 'mimo' in m.获取('id',''): print(json.dumps(m, indent=2)) "
关键字段:
工具Call: 如果为 false,工具调用被禁用 max令牌s: 过高可能导致 API 拒绝 reasoning: 某些 API 不支持 Step 5: 检查日志获取精确错误 grep -i "mimo" /tmp/OpenClaw/OpenClaw-*.记录 | grep -i "error\|fAIl\|400" | tAIl -10
常见原因和修复 原因 1: 配置热加载竞态条件(最常见)
症状:之前能用,突然报 400,过一会儿又好了
原因:配置热加载瞬间有请求在处理,请求格式不一致
修复:通常无需处理,会自动恢复。如果持续报错,重启 gateway:
OpenClaw gateway re启动
原因 2: 工具Call 被误禁用
症状:模型能对话但不能调用工具
检查:查看配置中 工具Call 是否为 false
修复:
python3 -c " 导入 json f = '$HOME/.OpenClaw/OpenClaw.json' d = json.load(open(f)) for m in d['模型s']['提供者s']['custom']['模型s']: if 'mimo' in m.获取('id',''): m['工具Call'] = True json.dump(d, open(f,'w'), indent=2, ensure_ascii=False) "
原因 3: API 端点不支持 function calling
症状:curl 测试带 工具s 也返回 400
修复:确认使用的是正确的 mimo-v2.5-pro 端点,不是其他不支持 工具s 的模型。
原因 4: 模型名称错误
症状:模型_not_found 错误
检查:确认配置中 id 字段与 API 端点支持的模型名一致:
curl -s "$BASE_URL/模型s" -H "Authorization: Bearer $API_KEY" | python3 -c " 导入 json,sys d=json.load(sys.stdin) for m in d['data']: print(m['id']) "
运行诊断脚本 bash ~/.OpenClaw/workspace/技能s/技能s/mimo-API-fix/scripts/诊断.sh