要在OpenClaw中支持多API Key调用,需修改config.toml文件,在[llm]下新增独立模型段落(如[llm.ernie]),配置对应model、base_url、api_key等参数,保存后通过Web GUI、CLI(--model ernie)或自然语言指令(如“用文心模型”)指定调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在OpenClaw中同时配置多个API Key以支持不同模型或服务提供商的灵活调用,必须修改其底层配置文件并启用多模型路由能力,否则所有请求将默认走单一密钥通道,导致部分模型调用失败或被限流。
确认配置文件位置与基础结构
进入OpenClaw项目根目录,找到 config.toml 文件(若不存在则复制 config.template.toml 并重命名)。
该文件是OpenClaw运行时唯一读取的配置源,【修改前务必备份原文件】,因为错误语法会导致服务启动失败且无明确报错提示。
检查文件顶部是否包含 [llm] 表头——这是单模型配置区;多Key配置需在此之下新增独立模型段落,不能写在同级。
OpenClaw专家 — 用于任何OpenClaw问题或需求,包括配置错误、网关崩溃、网关未启动、斜杠指令、频道路由等。
添加第二个API Key(以百度文心为例)
在 config.toml 文件末尾新增以下内容:
[llm.ernie]model = "ernie-bot-4"base_url = "https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/completions"api_key = "your_actual_baidu_api_key_here"temperature = 0.3
注意:段落名 [llm.ernie] 中的 ernie 是自定义标识符,后续调用时需显式指定此名称;【base_url 必须与百度官方文档完全一致,少一个斜杠都会返回404】。
保存文件后,无需重启服务——OpenClaw在每次任务初始化时动态加载配置,但新Key仅对后续新建会话生效。
切换使用指定Key执行任务
方法一:通过Web GUI选择模型
打开浏览器访问 http://localhost:3000 → 新建任务 → 在模型下拉菜单中选择 “ernie-bot-4” → 输入指令提交。
方法二:通过CLI命令行强制指定
执行:openhands --model ernie --task "分析当前目录下的requirements.txt"。
此处 --model ernie 中的 ernie 必须与配置段落名 [llm.ernie] 完全一致,大小写敏感。
方法三:在任务指令中内嵌模型声明
直接输入自然语言指令:“请用文心模型生成一段Python爬虫代码”,OpenClaw会自动匹配到 [llm.ernie] 段并调用对应Key——该机制依赖于内置的模型关键词映射表,仅支持预设别名(如“文心”“千问”“混元”)。

















