需使用openhands官方镜像ghcr.io/all-hands-ai/openhands:main运行openclaw，通过环境变量或config.yaml注入openai的api key、base url和精确模型名（如gpt-4o-2024-08-06），确保支持tool-calling，并在web ui中验证llm provider为openai且模型名匹配。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想在本地跑通 OpenClaw 并让它调用 OpenAI 的 API 来执行编程任务，而不是依赖内置小模型或远程托管服务。这需要绕过默认配置，手动注入 OpenAI 的 endpoint、key 和模型名，并确保 OpenClaw 容器能稳定访问公网 API。
确认 OpenClaw 镜像与启动方式
OpenClaw 目前未发布独立镜像，实际部署需使用其上游项目 OpenHands 的官方镜像（ghcr.io/all-hands-ai/openhands:main），因为 OpenClaw 是 OpenHands 的实验性分支，共享同一套容器化入口。直接拉取 OpenHands 镜像即可，无需额外构建。
运行以下命令验证镜像可拉取：docker pull ghcr.io/all-hands-ai/openhands:main
如果提示 unauthorized 或 401 错误，说明你尚未登录 GitHub Container Registry。执行 docker login ghcr.io 并输入 GitHub PAT（Personal Access Token），权限需勾选 read:packages。
准备 OpenAI API 凭据与端点
登录 OpenAI Platform，生成一个新的 Secret Key。注意：该 key 必须具备 【调用 gpt-4o、gpt-4-turbo 或 o1 系列模型的权限】，旧版仅限 chat-completion 的 key 无法触发 OpenClaw 所需的 tool-calling 能力。
记下三项关键信息：
• API Key（以 sk-... 开头）
• Base URL（默认为 https://api.openai.com/v1，若使用 Azure 或代理需替换）
• 模型名称（如 gpt-4o-2024-08-06，必须与 OpenAI 文档中当前支持的最新 tool-calling 模型完全一致）
启动容器并注入 OpenAI 配置
方法一：环境变量注入（推荐，最简路径）
执行以下命令，将 OpenAI 凭据以环境变量形式传入容器：
WORKSPACE_BASE=$(pwd)/openhands-workspace && mkdir -p $WORKSPACE_BASE && docker run -it --rm \<br> -e LLM_MODEL_NAME=gpt-4o-2024-08-06 \<br> -e LLM_API_KEY=sk-xxx \<br> -e LLM_BASE_URL=https://api.openai.com/v1 \<br> -e SANDBOX_USER_ID=$(id -u) \<br> -e WORKSPACE_MOUNT_PATH=$WORKSPACE_BASE \<br> -v $WORKSPACE_BASE:/opt/workspace_base \<br> -v /var/run/docker.sock:/var/run/docker.sock \<br> -p 3000:3000 \<br> --add-host host.docker.internal:host-gateway \<br> ghcr.io/all-hands-ai/openhands:main
⚠️ 注意：LLM_MODEL_NAME 值必须与 OpenAI 官网文档中当前启用 tool calling 的模型名严格一致，大小写、连字符、日期后缀均不可省略。填错会导致 Agent 启动失败并报 model not found。
方法二：挂载自定义 config.yaml（适合多模型切换）
在宿主机创建 config.yaml，内容如下：
llm:<br> model: gpt-4o-2024-08-06<br> api_key: sk-xxx<br> base_url: https://api.openai.com/v1<br> temperature: 0.1
然后启动时挂载该文件：-v $(pwd)/config.yaml:/app/agenthub/config.yaml 加入原 docker run 命令末尾。
验证 OpenAI 接入是否生效
第一步：浏览器打开 http://localhost:3000，等待页面加载完成（约 15 秒）。
第二步：在右上角点击 ⚙️ Settings → 查看 “LLM Provider” 是否显示为 openai，下方 “Model Name” 是否为你填入的完整模型标识（如 gpt-4o-2024-08-06）。
第三步：在任务输入框中输入：创建一个 Python 脚本，打印 'Hello from OpenClaw + OpenAI'
第四步：点击 Submit。观察左侧 terminal 日志流——若出现 Using model gpt-4o-2024-08-06 及后续 tool_calls 字段解析日志，且最终生成并执行了正确脚本，则接入成功。
