openclaw不存在，实际需配置openhands备用模型；删除默认[llm]节后，在config.toml中定义多个[llm."代号"]区块，通过--llm-model参数切换，默认模型由全局[llm].model指定。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw本身并不存在——当前开源生态中没有名为“OpenClaw”的AI Agent框架或开发者代理平台，你实际想配置的是OpenHands的备用模型。官方文档、GitHub仓库（https://github.com/All-Hands-AI/OpenHands）、以及所有最新部署指南（截至2026年7月）均未收录OpenClaw项目，常见混淆源于名称拼写近似或旧版fork分支误传。确认使用OpenHands后，备用模型配置本质是通过TOML配置文件定义多个LLM入口，并在运行时按需切换。
确认配置文件位置与基础结构
进入OpenHands项目根目录，检查是否存在config.toml。若只有config.template.toml，先复制为正式配置：cp config.template.toml config.toml。该文件是模型配置的唯一生效源，环境变量或UI设置无法覆盖其中定义的备用模型列表。
【必须删除默认的[llm]节】——原模板中单个[llm]块会强制覆盖所有备用模型加载逻辑，不删将导致后续添加的模型全部失效。
添加多个独立模型配置块
在config.toml中，为每个备用模型创建独立的命名区块，格式严格为[llm."模型代号"]，代号只能含字母、数字、下划线，不能有空格或短横线。例如：
当用户请求“启用语义缓存”、“缓存LLM响应”、“降低API成本”、“加速AI响应”、“配置LangCache”、“搜索语义缓存”、“存储响应到缓存”，或提及Redis LangCache、语义相似性缓存、LLM响应缓存时使用此技能。提供与Redis LangCache托管服务的集成，用于对提示和响应进行语义缓存。
[llm.gpt4o]model = "gpt-4o"api_key = "sk-xxx"base_url = "https://api.openai.com/v1"
[llm.qwen]model = "qwen2.5-72b-instruct"api_key = "xxx"base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"
每个区块必须包含model和api_key，base_url在调用非OpenAI兼容接口时为必填项。遗漏api_key会导致启动时报错“API key is required”，且错误信息不会明确提示是哪个模型区块缺失。
指定默认模型与运行时切换
第一步：在文件顶部添加全局默认声明[llm]model = "gpt4o"
这行中的"gpt4o"必须与上方某个[llm."xxx"]的代号完全一致，大小写敏感。
第二步：启动服务时通过参数指定备用模型poetry run openhands --llm-model qwen
此时会跳过[llm]声明，直接加载[llm.qwen]区块配置。不加--llm-model参数则始终使用[llm].model指定的默认模型。
注意：Web UI界面中无法动态切换备用模型，所有模型选择必须通过命令行参数触发，UI仅反映当前启动所用模型的实际响应。
