OpenClaw配置API Key后须立即验证连通性与权限，否则LLM调用将静默失败；需启动服务并确认控制台显示【Server started】、无连接错误，再在Web界面正确填写服务商、API Key、Base URL及严格匹配的Model Name，保存后通过“say hello”测试，10秒内出现“Hello!”和“✅ LLM call succeeded”，且Network中/api/agent/events响应含"observation": "run"与"exit_code": 0。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw配置API Key后需要立即验证连通性与权限，否则后续所有任务都会卡在LLM调用环节，出现“model not responding”或空响应等静默失败现象。
启动OpenClaw服务并确认基础运行状态
打开终端，执行启动命令：docker run -it --rm -p 3000:3000 -v /var/run/docker.sock:/var/run/docker.sock ghcr.io/ai-devs/openclaw:latest。这一步必须看到控制台输出中包含 【Server started on http://0.0.0.0:3000】 字样，且无 Failed to connect to LLM 类报错。
若端口被占用，会提示 Bind for 0.0.0.0:3000 failed，此时需先执行 lsof -i :3000 | grep LISTEN 查进程并 kill，不能跳过。
在Web界面完成API Key填写与保存
浏览器访问 http://localhost:3000（或部署机IP:3000），首次进入会强制跳转至设置页。
在「LLM Provider」下拉菜单中选择你实际使用的模型服务商（如 OpenAI、DeepSeek、Qwen 等），对应填入 API Key、Base URL（非OpenAI官方需填）、Model Name（例如 deepseek-chat 或 qwen2.5-72b-instruct）。
【Model Name 必须与服务商文档中公布的名称完全一致，大小写、中划线、版本号都不能错，否则测试必失败】
点击「Save Configuration」按钮。页面不会跳转或弹窗，仅右上角短暂显示绿色“Saved”，这是正常反馈。
发起最小化测试请求并观察响应流
第一步：新建对话 → 输入极简指令 “say hello” → 按回车。
第二步：紧盯左侧消息流区域。成功时会在10秒内出现两段连续响应：第一段是 AI 返回的纯文本 “Hello!”，第二段是系统自动追加的灰色小字 “✅ LLM call succeeded”。
第三步：打开浏览器开发者工具（F12）→ 切换到 Network 标签 → 过滤 XHR → 找到名为 /api/agent/events 的请求 → 点击查看 Response → 滚动到底部，确认 JSON 中存在 "observation": "run" 和 "exit_code": 0 字段。这表示沙箱内命令已执行完毕，不是前端假响应。
如果超过15秒仍卡在 “Thinking…” 或直接返回空内容，说明 API Key 未生效，需立刻检查 Base URL 是否漏掉 /v1 后缀、Key 是否复制了多余空格、服务商是否已开通对应模型权限。
