openclaw需通过docker容器运行，先验证docker≥26.0.0、守护进程运行及docker.sock存在；再拉取runtime和openhands镜像；最后用指定命令启动服务并绑定ollama本地模型。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想用OpenClaw快速搭建一个专属AI助手，让它能读代码、改文件、跑命令、查文档，而不是只在聊天框里回答问题。这个过程不需要写一行Python，但必须严格按容器运行逻辑来操作，否则启动后界面打不开或模型根本连不上。
确认基础环境是否达标
先打开终端，逐条执行这三行命令：
docker --version → 查看Docker版本是否≥26.0.0；
docker ps → 确认Docker守护进程正在运行；
ls /var/run/docker.sock → 检查socket文件是否存在且可读。如果任一命令报错，【必须先解决Docker问题，否则后续所有步骤都无效】。
拉取并启动OpenClaw核心镜像
OpenClaw目前没有独立镜像仓库，它复用OpenHands的底层架构，所以你要拉取的是OpenHands官方维护的runtime和openhands主服务镜像：
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镜像才是UI和任务调度中枢。漏掉runtime会导致AI代理无法执行任何命令，界面卡在“Initializing sandbox…”不动。
用单条命令启动完整服务
复制粘贴以下命令（注意：不要换行，不要删空格，所有反斜杠是Linux/macOS换行符，Windows PowerShell用户请改用 `^`）：
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
这条命令里【-v ~/.openhands-state:/.openhands-state】是持久化关键路径，删掉会导致每次重启都丢失对话历史和文件修改记录】。启动后终端会持续输出日志，看到“INFO: Application startup complete”即表示服务就绪。
首次访问并绑定本地大模型
浏览器打开 http://localhost:3000；
页面弹出设置窗口时，Provider选“Ollama”，Model填“qwen2.5:7b”（或其他你本地已pull好的Ollama模型名）；
Base URL填 http://host.docker.internal:11434/api/chat；
点击Save。
Ollama必须已在本机运行且监听11434端口，否则Save后界面会卡在加载状态。验证方式：curl http://localhost:11434/health 返回{"status":"ok"}才算正常。
创建第一个AI助手任务
第一步：点击左上角“+ New Task”按钮；
第二步：在输入框中写下自然语言指令，例如：“分析当前目录下的requirements.txt，把所有包升级到最新兼容版本，并生成upgrade_report.md”；
第三步：点击Submit，左侧任务面板出现进度条，右侧开始自动执行shell命令、读取文件、调用模型推理；
第四步：等待状态变为“✅ Completed”，点击结果中的upgrade_report.md即可查看AI生成的升级建议。
