openclaw（即openhands）本地部署后无法调用大模型是因为未配置api key；需通过web ui或config.toml文件配置服务商、模型名、api key及base url，保存后验证llm连接状态并测试指令响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw本地部署后无法调用大模型，是因为还没配置可用的API Key——没有它，代理连“思考”都做不到，所有指令都会卡在初始化阶段。
确认当前运行环境是否支持API Key配置
打开终端，执行 docker ps 查看 OpenClaw 容器是否正在运行。若容器未启动，先按标准流程拉取镜像并启动：docker run -it --rm -p 3000:3000 -v ~/.openhands-state:/.openhands-state docker.all-hands.dev/all-hands-ai/openhands:0.39（注意：OpenClaw 实为 OpenHands 项目曾用名，当前所有部署文档与镜像均指向 OpenHands）。
访问 http://localhost:3000，若页面加载成功但弹出空白设置窗口或提示“LLM provider not configured”，说明环境就绪，可进入下一步。
首次访问时通过Web UI配置API Key
浏览器打开 http://localhost:3000 后，页面会自动弹出 LLM 配置弹窗。
在 Provider 下拉菜单中选择你已准备好的服务商，例如 【Anthropic】、【OpenAI】 或国内可选的 【Qwen】（需提前注册对应平台并获取 API Key）。
填写对应字段：Model 名称（如 claude-3-5-sonnet-latest）、API Key（粘贴你从服务商控制台复制的密钥）、Base URL（如使用非官方代理或本地部署模型，必须填；默认留空即走官方接口）。
【切勿将 API Key 直接写在 URL 栏或浏览器控制台中——这会导致密钥明文暴露并可能被日志记录】
点击 Save，页面自动跳转回主界面。此时左下角状态栏应显示 “LLM connected” 或类似提示。
通过 config.toml 文件手动配置（适用于二次部署或批量管理）
方法一：挂载自定义配置文件启动
在宿主机创建 config.toml，内容如下：
OpenClaw 原生 PDF/文档处理技能，适用于 Nutrient DWS，帮助用户完成 PDF 转换、OCR、文字/表格提取、PII 脱敏等功能。
[llm]
model = "gpt-4o"
api_key = "sk-xxx-your-real-key-here"
base_url = ""
temperature = 0.1
启动命令中加入挂载参数：-v $(pwd)/config.toml:/app/config.toml，完整命令示例：
docker run -it --rm -p 3000:3000 -v ~/.openhands-state:/.openhands-state -v $(pwd)/config.toml:/app/config.toml docker.all-hands.dev/all-hands-ai/openhands:0.39
方法二：进入容器内部修改（仅调试用，不推荐生产）
执行 docker exec -it openhands-app sh 进入容器 → 运行 vi /app/config.toml → 修改 api_key 字段 → 按 Esc + :wq 保存退出 → 执行 kill 1 重启进程。
注意：容器重启后，未挂载的内部文件修改会被丢弃，此法仅限临时验证。
验证API Key是否生效
第一步：在对话框输入“你是谁”，发送。
第二步：观察右侧响应区域是否返回合理回答（如“我是 OpenHands AI 编程助手…”），而非报错信息 Unauthorized 或 Invalid API key。
第三步：执行一条需调用模型的指令，例如：“生成一个 Python 函数，接收列表并返回去重后的排序结果。”
若代码块正常输出且无红色错误提示，说明 API Key 已成功接入并可通过沙箱环境调用。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
