openclaw无法响应时,需检查api密钥配置:先在阿里云百炼和deepseek平台获取并验证密钥有效性;再通过环境变量或config.yaml配置密钥与端点;最后用/openclaw tui测试模型连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您已成功部署OpenClaw,但其无法生成有效响应或提示“模型不可用”,则很可能是大模型API未正确配置。以下是完成OpenClaw与阿里云百炼、DeepSeek V3.2等主流大模型API对接的完整操作流程:
一、获取并验证API密钥有效性
API密钥是OpenClaw调用远程大模型服务的身份凭证,必须确保其处于激活状态且具备对应模型调用权限。密钥泄露将导致账户异常调用风险,需严格隔离存储。
1、访问阿里云百炼控制台(https://bailian.console.aliyun.com),进入“密钥管理”页面,点击“创建API Key”;
2、复制生成的API Key字符串,立即保存至本地加密文本文件,切勿截图上传或明文粘贴至聊天窗口;
3、访问DeepSeek开放平台(https://platform.deepseek.com),登录后进入“API密钥”页,确认账户已完成实名认证并启用V3.2模型调用权限;
4、在DeepSeek平台点击“新建密钥”,勾选“deepseek-v3.2”模型权限,生成并安全保存该密钥。
二、配置OpenClaw环境变量(推荐方式)
通过系统级环境变量注入API密钥,可避免密钥硬编码进配置文件,降低误提交或日志泄露风险,适用于阿里云服务器及本地Linux/macOS环境。
1、使用SSH或终端连接目标部署环境,执行命令进入用户主目录:cd ~;
2、编辑Shell配置文件:nano ~/.bashrc(Linux/macOS)或在PowerShell中执行:$PROFILE(Windows WSL2);
3、在文件末尾新增两行(请替换为实际密钥):
export BAILIAN_API_KEY="your_aliyun_bailian_key_here"
export DEEPSEEK_API_KEY="your_deepseek_v32_key_here"
4、使配置生效:source ~/.bashrc(Linux/macOS)或重新启动PowerShell(Windows);
5、验证变量是否加载成功:echo $BAILIAN_API_KEY应返回非空字符串。
三、修改OpenClaw配置文件(备用方式)
当环境变量不可用(如部分Windows GUI环境或容器化部署)时,可直接编辑OpenClaw核心配置文件,该方式需配合服务重启生效。
1、定位配置路径:~/.openclaw/config.yaml(首次运行后自动生成);
2、使用文本编辑器打开该文件,找到providers:区块,在其下添加以下YAML结构(注意缩进为2个空格):
providers:
bailian:
api_key: "your_aliyun_bailian_key_here"
endpoint: "https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation"
deepseek:
api_key: "your_deepseek_v32_key_here"
endpoint: "https://api.deepseek.com/v1/chat/completions"
3、保存文件后,执行命令重启网关服务:openclaw gateway restart;
4、检查服务状态:openclaw gateway status,确认“Provider Status”字段显示bailian与deepseek均为active。
四、验证模型连通性与默认绑定
配置完成后需主动触发一次模型调用,验证API密钥、网络策略与模型路由是否协同正常,避免静默失败。
1、启动交互终端:openclaw tui;
2、输入指令查看当前可用模型:/models,确认输出中包含bailian/qwen-plus与deepseek/deepseek-v3.2条目;
3、手动切换至DeepSeek模型并发起测试请求:/model deepseek/deepseek-v3.2,随后发送任意短句如“你好”;
4、观察响应延迟与内容完整性,若返回正常文本且/status中显示Token消耗增长,则API链路已就绪;
5、如遇401错误,立即核查密钥是否过期或权限未开启;如遇403,检查阿里云百炼是否已开通服务、DeepSeek平台是否启用V3.2配额。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











