openclaw ai助手是服务启动后自动生成的默认agent实例,无需手动创建;只需拉取指定registry的匹配版本镜像、正确挂载路径并首次登录配置llm即可初始化运行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想用 Docker 在本地快速创建一个可交互的 OpenClaw AI 助手,但官方文档里没有明确说明“助手”是独立实体——它其实是 OpenClaw 服务启动后自动生成的默认 Agent 实例,不需要手动创建,只需完成容器部署并首次登录配置即可触发初始化。
确认 OpenClaw 镜像源与版本
OpenClaw 当前稳定镜像托管在 docker.all-hands.dev,不是 Docker Hub 默认源。直接执行 pull 命令会失败,必须显式指定完整 registry 地址。
运行以下命令拉取 runtime 镜像(这是沙箱执行环境的基础):
docker pull docker.all-hands.dev/all-hands-ai/runtime:0.39-nikolaik
再拉取主服务镜像:
docker pull docker.all-hands.dev/all-hands-ai/openhands:0.39
【必须用完全匹配的版本号,runtime 和 openhands 的版本号不一致会导致容器启动后立即崩溃】
启动容器并挂载关键路径
执行这条单行命令启动 OpenClaw 服务:
为 OpenClaw 创建可直接分流的 GitHub issue 草稿,用于报告代理缓慢、损坏、无响应、工具匮乏、性能下降或“不够智能”等问题。使用 ...
docker run -it --rm --pull=always -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.39-nikolaik -e LOG_ALL_EVENTS=true -v /var/run/docker.sock:/var/run/docker.sock -v ~/.openhands-state:/.openhands-state -p 3000:3000 --add-host host.docker.internal:host-gateway --name openclaw-app docker.all-hands.dev/all-hands-ai/openhands:0.39
这一步会自动创建名为 openclaw-app 的容器,并把状态持久化到你家目录下的 .openhands-state 文件夹。
注意:如果你的系统中 /var/run/docker.sock 权限不足,容器会卡在初始化阶段,页面加载空白——此时需先执行 sudo usermod -aG docker $USER 并重启终端。
首次访问 Web 界面并完成 Agent 初始化
打开浏览器,访问 http://localhost:3000。
页面加载完成后,你会看到一个空工作区和「Setup LLM」按钮。
点击该按钮,填入你已有的 LLM API Key(如 Anthropic、OpenAI 或 Ollama 本地地址),选择模型名称,保存配置。
保存后页面自动刷新,底部状态栏显示 “Agent initialized”,此时一个具备完整执行能力的 AI 助手就已生成——它不是文件也不是配置项,而是服务内存中实时运行的 Agent 实例。
你可以立刻输入第一条指令,例如:“新建一个 Python 文件,写一个打印 ‘Hello, OpenClaw’ 的函数”,它将自动创建文件、写入代码、执行并返回结果。









