SuperAPI AI 工具集

model-switch

智能体与模型

查看项目

更新于 10-15 19:52

技能介绍

用途:切换 Manager Agent 自身使用的 LLM 模型,适用于人类管理员要求更换 Manager 模型的场景。

主要能力:脚本先对模型做连通性测试,再修改 openclaw.json。它会去掉模型名中的 hiclaw-gateway/ 前缀;通过 AI Gateway 的 POST /v1/chat/completions 测试模型,不可达则报错退出;若模型已在 models 数组中,则切换 agents.defaults.model.primary,若为新模型则先加入数组再切换;始终输出 RESTART_REQUIRED。

用法:bash /opt/hiclaw/agent/skills/model-switch/scripts/update-manager-model.sh <MODEL_ID> [--context-window <SIZE>] [--no-reasoning]。示例:bash /opt/hiclaw/agent/skills/model-switch/scripts/update-manager-model.sh claude-sonnet-4-6;bash /opt/hiclaw/agent/skills/model-switch/scripts/update-manager-model.sh my-custom-model --context-window 300000;bash /opt/hiclaw/agent/skills/model-switch/scripts/update-manager-model.sh deepseek-chat --no-reasoning。

运行后:脚本始终输出 RESTART_REQUIRED,需执行 openclaw gateway restart 使更改生效,然后告知管理员切换完成。默认启用推理(扩展思考),传 --no-reasoning 可禁用。

失败处理:若网关测试非 200,脚本输出 ERROR: MODEL_NOT_REACHABLE 并退出,不修改 openclaw.json。此时应告知管理员:当前默认 AI Provider 可能不支持该模型,需在 Higress Console 中为该模型厂商新建 AI Provider,并新建带模型名前缀谓词的 AI Route(如 provider kimi → 匹配 kimi-*),使该前缀请求路由到新 provider,未匹配的仍走默认路由;不要修改默认 AI Provider,它由初始化配置管理,重启会被覆盖。管理员确认配置后可重试。

限制:该技能切换的是持久化在 openclaw.json 中的主模型,必须重启网关生效;管理员也可用 /model 斜杠命令即时切换当前会话模型,但不持久化且仅支持预配置模型。切换到未知模型时,必须先询问管理员上下文窗口大小(token)以及是否支持推理,再带相应参数运行;若管理员不知道上下文窗口,可省略 --context-window 使用默认值 150,000;不支持推理则加 --no-reasoning。资料中列出的预配置模型及上下文窗口、最大 token 数仅供参考。