openclaw配置api key后必须显式指定default_model,否则启动报错;需在~/.openclaw/.env写入对应密钥,在config.yaml中正确定义default_model及models区块,并通过openclaw models status和测试调用验证生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenClaw配置API Key后,必须显式指定默认模型才能正常调用,否则启动时会报错“no model configured”或触发空模型 fallback 行为,导致所有请求失败。
确认API Key已正确写入配置文件
打开 ~/.openclaw/.env 文件,检查是否已写入对应提供商的密钥,例如:
OPENAI_API_KEY=sk-xxx
ANTHROPIC_API_KEY=sk-xxx
KIMI_API_KEY=xxx(注意:Kimi 实际提供商为 Moonshot,密钥格式为 【moonshot-xxx】)
豆包(Doubao)密钥需为 【volc_XXX】 格式,且必须通过火山引擎控制台获取,不能使用飞书或豆包App内Token。
修改OpenClaw模型配置文件
进入 OpenClaw 配置目录:cd ~/.openclaw
编辑主配置文件:nano config.yaml(若不存在则新建)
在文件顶部添加或修改 【default_model】 字段,值必须与后续定义的模型别名完全一致:
default_model: kimi-pro
在配置中声明可用模型及其参数
继续在 config.yaml 中添加模型定义区块,确保字段完整、缩进正确(YAML 对空格敏感):
方法一:配置 Kimi(Moonshot)模型
models: kimi-pro: provider: moonshot model: moonshot-v1-32k api_key_env: KIMI_API_KEY temperature: 0.3
字节跳动正式推出了其最新的智能图像创作模型——Seedream 5.0 Lite。作为豆包大模型2.0系列的重要组成部分,该模型不仅在理解、推理和生成能力上实现了全面跃升,更针对企业级视觉创作需求进行了深度优化,标志着AI生图技术向“实用化”与“智能化”迈出了关键一步。
方法二:配置豆包(Doubao / VolcEngine)模型
doubao-pro: provider: volcengine model: doubao-pro-32k api_key_env: DOUBAO_API_KEY base_url: https://ark.cn-beijing.volces.com/api/v1
注意:volcengine 的 【base_url 必须显式指定】,否则请求会超时;且 DOUBAO_API_KEY 必须已在 .env 中定义并匹配此处的 api_key_env 值。
验证默认模型是否生效
第一步:重启 OpenClaw 网关服务systemctl restart openclaw-gateway
第二步:执行状态检查命令openclaw models status
第三步:观察输出中 default 列是否显示为 kimi-pro 或 doubao-pro,同时该模型的 status 应为 online;若显示 offline,说明 API Key 无效或网络不可达。
第四步:发起一次测试调用openclaw llm chat --model kimi-pro "你好,请用中文简单介绍你自己"
这一步操作起来很简单,直接回车即可。如果返回正常响应,说明默认模型设置完成。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!









