必须用可验证的交互动作确认响应流畅通无阻:第一步检查config.yaml字段完整性及环境变量值;第二步通过openclaw tui发起真实问答并观察响应;第三步在网页控制台点击test connection验证连通性;第四步用curl或python脚本调用api端点获取success响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

当你在OpenClaw中填完阿里云百炼或DeepSeek的免费API密钥后,界面没报错不代表模型真能用——可能卡在密钥权限不足、端点地址拼错、环境变量未加载或模型别名不匹配等隐蔽环节,必须用可验证的交互动作确认响应流畅通无阻。
第一步:确认配置已落盘且格式合法
打开终端,执行 cat ~/.openclaw/config.yaml,检查是否存在 models: 区块,且其中至少有一项包含 name、endpoint、api_key(或引用环境变量如 ${BAILIAN_API_KEY})和 context_window 四个字段。缺任意一项都会导致热加载失败。
若使用环境变量方式配置,运行 echo $BAILIAN_API_KEY 和 echo $DEEPSEEK_API_KEY,确保返回值非空且长度合理(阿里云密钥为40位字符串,DeepSeek为sk-开头+32位)。【空值或截断会导致后续所有测试静默失败】
第二步:用TUI终端发起真实问答请求
在终端中执行 openclaw tui 进入交互界面。
输入 /model list 查看当前已加载模型列表,确认你的目标模型名(如 bailian-qwen2.5)出现在 Active model 行或可用列表中。
若未出现,立即退出TUI,执行 openclaw model reload --name bailian-qwen2.5(将 bailian-qwen2.5 替换为你实际配置的 name 值),等待输出 reloaded successfully。
重新进入 openclaw tui,直接输入一句短问:“你好,请用中文回答。” 观察三秒内是否返回非空文本。若超时、返回 Model not found 或 Unauthorized,说明密钥无效或端点不可达;若返回乱码或 JSON 错误,则大概率是 endpoint 地址末尾漏了 /v1/chat/completions。
第三步:网页控制台一键连通性探测
浏览器访问 http://localhost:18789(本地部署)或你的服务器公网IP加端口。
免提语音助手,支持 OpenClaw ESP32‑S3‑BOX‑3,本地唤醒,可切换 xAI Grok / ElevenLabs 语音识别与合成,无需 Home Assistant。
点击左侧【Models】→ 在“Available Models”中找到你配置的模型 → 点击右侧 Test Connection 按钮。
等待状态变为绿色 Connected 且下方显示 Response time: XX ms。这一步会真实发送一个最小 payload 到远端 API,比单纯 ping 更可靠。
成功后勾选启用开关 → 点击顶部 Set as Active → 切换到【Chat】页,输入“请输出数字42”,立刻提交。响应内容必须是纯数字 42 或含该数字的自然语言句子,不能是模板话术或错误堆栈。
第四步:调用API端点做自动化探针
方法一:用curl命令直连健康检查接口
curl -X POST http://localhost:18789/api/v1/model/test -H "Content-Type: application/json" -d '{"model": "bailian-qwen2.5", "prompt": "hi"}'
方法二:用Python脚本验证(需安装requests)
import requests; r = requests.post("http://localhost:18789/api/v1/model/test", json={"model": "bailian-qwen2.5", "prompt": "hi"}); print(r.json())
两种方式都必须返回 {"status": "success", "response": "...", "latency_ms": ...} 结构。若返回 503 Service Unavailable,说明模型服务未启动;若返回 401 Unauthorized,说明密钥未被正确注入到运行时上下文。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!









