openclaw配置多模型需为每个模型提供model、api_key和base_url三项参数,缺一不可;model须严格匹配厂商命名规范,api_key为私有密钥,base_url在非openai接口或自定义网关时必须显式声明。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenClaw配置多模型时,必须为每个接入的模型准备对应厂商的API凭证与访问端点,缺一不可——没有合法API密钥或错误的base_url会导致代理启动失败、任务卡在initialize阶段,且日志中仅显示generic connection timeout而无具体错误源。
必需的API要素清单
每个模型至少需提供三项硬性参数:
• 【model】:精确到厂商命名规范的模型标识符,例如"anthropic/claude-3-5-sonnet-20241022"或"deepseek/deepseek-coder-33b-instruct",拼写错误或版本号不匹配将导致404错误;
• 【api_key】:由服务商发放的私有密钥,明文写入配置文件,不可为空;
• base_url:仅当使用非OpenAI原生API(如Ollama、vLLM、华为ModelArts、百度千帆)时必须显式声明,格式为"http://localhost:8000/v1"或"https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/completions";
OpenAI兼容接口可省略base_url,但若部署了自定义网关(如LiteLLM proxy),仍需填写该字段。
不同厂商API获取路径
方法一:OpenAI
登录https://platform.openai.com/api-keys → 点击“Create new secret key” → 复制密钥(仅显示一次,丢失需重生成);
方法二:Anthropic
访问https://console.anthropic.com/settings/keys → “Add Key” → 命名后生成,key前缀为sk-ant-api03-;
方法三:DeepSeek(通过MaaS平台)
进入华为开发者空间→选择“ModelHub”→定位DeepSeek-R1→点击“服务详情”→在“API调用”页签复制Endpoint URL与API Key;
方法四:百度千帆
登录百度智能云→进入“千帆大模型平台”→左侧菜单“模型服务”→选中ERNIE Bot→右上角“API Key管理”→创建并启用新密钥;
注意:百度千帆的base_url必须带/v1结尾,漏掉会返回404而非认证失败。
验证API可用性的最小测试命令
第一步:安装curl与jq(如未安装)→ sudo apt install curl jq(Ubuntu)或 brew install curl jq(macOS);
第二步:执行直连测试(以OpenAI为例)→
curl -X POST https://api.openai.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"model":"gpt-4o","messages":[{"role":"user","content":"hi"}]}' | jq '.choices[0].message.content';
若返回"hi"或类似响应体,说明API凭证与网络通路正常;返回"error": "invalid_api_key"则密钥无效,返回"error": "model_not_found"则model名称错误。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!









