openhands是当前主流开源ai开发代理平台，非官方项目名“openclaw”属误传；需通过docker images确认镜像为all-hands-ai/openhands，启动后访问localhost:3000，在首次配置弹窗中选择提供商并准确填写api key（禁空格换行），保存后输入指令验证响应即生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw 并非官方项目名称，当前主流开源 AI 开发代理平台是 OpenHands（原 OpenDevin），GitHub 仓库、文档、镜像源及所有部署教程均指向 OpenHands。所谓“OpenClaw”极大概率是误传、拼写错误或混淆了项目名，直接按 OpenClaw 搜索将无法获取有效镜像、配置项或 API Key 填写入口。
确认你实际要部署的是 OpenHands
打开终端执行：docker images | grep -i open。如果看到镜像名含 all-hands-ai/openhands 或 ghcr.io/all-hands-ai/openhands，说明你拉的是 OpenHands 官方镜像；若显示空或只有第三方非标镜像，则尚未正确获取 OpenHands。
官方唯一可信镜像源为：
• docker.all-hands.dev/all-hands-ai/openhands:<version></version>
• 或 ghcr.io/all-hands-ai/openhands:main
启动容器后首次访问 Web 界面
浏览器打开 http://localhost:3000（Docker 默认映射 3000 端口）。页面加载完成后，会自动弹出【首次配置弹窗】，此窗口不可跳过，也无隐藏按钮——它就是填写 API Key 的唯一入口。
若页面空白、卡在加载状态或提示“Connection refused”，请先检查容器是否正在运行：docker ps | grep openhands。没有输出说明容器已退出，需回看启动命令中的 -v /var/run/docker.sock:/var/run/docker.sock 是否遗漏，该挂载缺失会导致容器启动失败。
在设置界面填写 LLM API Key
弹窗中依次操作：
- 从下拉菜单选择 LLM 提供商（如 Anthropic、OpenAI、Google、Ollama、Azure OpenAI 等）；
- 在对应 Provider 的输入框中粘贴你的 API Key；
- 如使用自托管模型（如本地 Ollama 或 vLLM），需手动填写 Model Name（如
qwen2.5:7b）和 Base URL（如http://host.docker.internal:11434/v1）； - 点击 Save 按钮提交配置。
注意：API Key 输入框【不支持空格或换行符】。复制时若末尾带换行，会导致认证失败且无明确报错提示，仅表现为后续任务一直卡在“thinking”状态。
验证 Key 是否生效
保存后页面自动跳转至主聊天界面。输入任意简单指令，例如：“写一个 Python 函数，接收一个列表并返回其长度。”
若 10 秒内出现代码块输出，说明 API Key 已成功验证；
若持续显示“Loading…”超 30 秒，或控制台（浏览器开发者工具 → Console）报 401 Unauthorized，则 Key 无效或 Provider 选错。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
