必须先确保Docker服务运行并拉取镜像，创建持久化数据卷openclaw-data后执行docker run或docker-compose启动命令，端口18789访问控制台，token需通过docker exec获取。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在本地快速启动 OpenClaw 容器并立即访问控制界面，必须先确保 Docker 服务已运行，且镜像拉取完成；直接执行启动命令但忽略数据卷挂载会导致配置重启即丢，后续无法保存模型设置或工具状态。
用 docker run 一键启动（适合首次体验）
第一步：拉取最新稳定镜像
执行 docker pull openclaw/openclaw:latest，国内用户建议加 --registry-mirror https://docker.1ms.run 加速。
第二步：创建持久化数据卷
运行 docker volume create openclaw-data。这一步不能跳过——【不创建卷会导致所有配置、模型缓存、会话记录在容器删除后彻底丢失】。
第三步：启动容器
执行以下完整命令：docker run -d --name openclaw -p 18789:18789 -v openclaw-data:/root/.openclaw -e OPENCLAW_GATEWAY_PORT=18789 openclaw/openclaw:latest
第四步：验证服务是否就绪
等约 15 秒后，执行 docker logs openclaw | tail -5，看到 ✓ Gateway is running on port 18789 即表示启动成功。
用 docker-compose 启动（推荐生产/长期使用）
方法一：直接使用最小化 compose 文件
新建文件 docker-compose.yml，内容如下：
services:<br> openclaw:<br> image: openclaw/openclaw:latest<br> container_name: openclaw<br> ports:<br> - "18789:18789"<br> volumes:<br> - openclaw-data:/root/.openclaw<br> environment:<br> - OPENCLAW_GATEWAY_PORT=18789<br> restart: unless-stopped
自动备份 OpenClaw 整体配置到远程存储（支持任意 rclone 后端：COS、S3、FTP、SFTP、WebDAV等）。 触发场景： - 创建/配置自动备份任务 - 设置备份周期、保留份数、目标目录 - 手动触发备份 - 查看/恢复备份 - OpenClaw 运行异常时的提醒
然后在该文件所在目录执行：docker compose up -d
方法二：带日志与健康检查的增强版（适合运维监控）
将 environment 块替换为：
environment:<br> - OPENCLAW_GATEWAY_PORT=18789<br> - NODE_ENV=production<br> healthcheck:<br> test: ["CMD", "curl", "-f", "http://localhost:18789/health"]<br> interval: 30s<br> timeout: 10s<br> retries: 3
注意：【healthcheck 中的 /health 路径必须存在，旧版镜像不支持，务必确认镜像标签为 latest 或 v2026.4+】
启动后立刻访问控制台
打开浏览器，访问 http://localhost:18789。
若提示输入 token，进入容器执行：docker exec -it openclaw openclaw dashboard --no-open
输出中的 URL 含 token 参数，直接复制整条 URL 粘贴到浏览器地址栏即可登录。
