OpenHands是EPAM开源的自主AI软件工程师平台,支持代码生成、测试执行、依赖安装、浏览器操作及PR提交等完整开发流程,通过ReAct循环与沙箱环境实现安全可控的自动化开发。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenClaw不是OpenHands的官方子项目或关联模型,当前所有权威文档、GitHub仓库(All-Hands-AI/OpenHands)、官方文档(docs.all-hands.dev)及主流部署教程中均未出现“OpenClaw”这一名称。你很可能混淆了项目名——实际想配置的是OpenHands对接免费大模型(如Ollama本地模型、Qwen、DeepSeek-R1、ERNIE Bot等)所需的API Key与服务地址。
确认你要配的是OpenHands,不是OpenClaw
OpenClaw在GitHub、HuggingFace、ModelScope及主流AI开发社区中无对应开源仓库、模型卡或API服务。截至2026年7月28日,不存在名为OpenClaw的、被OpenHands官方支持的免费模型API服务。若你在某篇非官方教程或二手博客中看到“OpenClaw”,大概率是笔误、虚构名称或已下线的私有分支。
【请立即停止搜索OpenClaw API Key】——它不存在,也不会生成有效密钥。继续尝试将导致配置失败、界面卡在“Loading agent…”、或报错LLM provider not found。
用Ollama本地运行Qwen2.5-7B,零API Key启动OpenHands
这是目前最稳妥的免费方案:不依赖任何云API,全部在本机运行,无需注册、无需填Key。
第一步:安装Ollama并拉取Qwen2.5-7B
打开终端,执行:curl -fsSL https://ollama.com/install.sh | sh → 然后运行 ollama pull qwen2.5:7b
第二步:验证模型可调用
执行 ollama list,确认输出中包含 qwen2.5:7b 且状态为 latest。若没有,请重试拉取;若提示端口占用,先执行 ollama serve 再另开终端操作。
第三步:启动OpenHands并指向Ollama
此技能为 OpenClaw 安装并配置 Tablestore Mem0 插件。Tablestore Mem0使用阿里云表格存储作为向量存储后端。
运行以下命令(关键参数已加粗):docker run -it --rm -e LLM_MODEL="qwen2.5:7b" -e LLM_BASE_URL="http://host.docker.internal:11434/v1" -e LLM_API_KEY="ollama" -v ~/.openhands-state:/root/.openhands-state -p 3000:3000 --add-host host.docker.internal:host-gateway docker.all-hands.dev/all-hands-ai/openhands:0.39
【注意:LLM_API_KEY必须填"ollama"(小写,不能留空或填其他值)】——这是Ollama硬编码的认证方式,填错会导致连接拒绝。
用百度千帆ERNIE Bot 4免费版配OpenHands
方法一:改config.template.toml再挂载进容器(推荐给熟悉TOML格式者)
下载最新OpenHands源码后,打开config.template.toml,定位到[llm.ernie]区块,填入:
model = "ernie-bot-4"base_url = "https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/completions"api_key = "你的百度千帆API Key"
保存为my-config.toml,启动时加挂载参数:-v $(pwd)/my-config.toml:/app/config.toml
方法二:首次运行Web UI时手动填写(适合只想快速验证)
浏览器打开localhost:3000 → 等待弹出设置窗口 → Provider选ERNIE → Model填ernie-bot-4 → Base URL粘贴上面那串地址 → API Key填百度千帆控制台生成的真实密钥 → Save。
【百度API Key需在千帆平台开通ERNIE Bot 4服务后生成,仅限实名认证用户,个人开发者免费额度每月5万Token】

















