Docker-CN

如果你更想要开箱即用，这条社区 Docker 路线会更省心。

这篇讲的是 Docker-CN-IM 社区增强路线，不是官方标准 Docker 主路线。它更适合中国用户的原因很直接：预集成国内 IM 相关能力、容器化部署更整齐、迁移和重建也更方便。

社区增强路线 10-20 分钟国内 IM 友好

Before You Start

开始前先把边界看清楚

这条路线很好用，但一定要先知道它和官方 Docker 路线不是一回事。

这是社区项目，不是官方镜像 它适合中国用户，但镜像来源、更新频率和安全策略都应该按社区项目来理解。

GitHub 和 Docker Hub 名字不一样 GitHub 仓库是 justlovemaki/OpenClaw-Docker-CN-IM，Docker 镜像是 justlikemaki/openclaw-docker-cn-im:latest。

最适合长期跑和隔离环境 如果你想把环境和本机彻底分开、后面还打算迁移到服务器，Docker 确实很方便。

公网部署别直接裸开 Dashboard 社区默认配置更偏本地或私网测试，服务器上依然要优先考虑 SSH 隧道或更安全的访问方式。

Overview

整个部署过程就是这 5 步

你可以先扫一遍，再按顺序执行。

01 准备 Docker 和 Compose 先确保宿主机已经有 Docker 运行环境。

02 下载 Compose 和环境文件 把社区仓库里的部署文件拉到本地目录。

03 编辑 .env 至少把模型 API 和基础参数填进去。

04 启动容器并看日志 确认容器真正启动，不是起了又退。

05 验证 Dashboard 和数据目录 确认系统已经可用，并知道数据保存在哪里。

跟着做就行

第 1 步：先准备 Docker 和 Compose

你需要先有可用的 Docker 环境：

Windows / macOS：可以直接用 Docker Desktop
Linux：可以装 Docker Engine + Compose v2

如果你在 Linux 上还没装 Docker，可以先执行：

curl -fsSL https://get.docker.com | sudo bash

后面教程优先使用 docker compose 这一套写法。

第 2 步：新建目录并下载部署文件

先建一个干净目录，然后把社区仓库里的部署文件拉下来：

mkdir ~/openclaw-cn
cd ~/openclaw-cn
wget https://raw.githubusercontent.com/justlovemaki/OpenClaw-Docker-CN-IM/main/docker-compose.yml
wget https://raw.githubusercontent.com/justlovemaki/OpenClaw-Docker-CN-IM/main/.env.example

这样你后面迁移、备份和重建都会更清楚，不容易把环境文件丢在系统里各处。

第 3 步：复制并编辑环境变量

cp .env.example .env
nano .env

第一次至少先改下面这几项：

MODEL_ID：模型名
BASE_URL：模型 API 地址
API_KEY：模型 API Key

飞书、钉钉、企业微信、QQ 这类参数可以先留空，后面进入渠道章节再逐个配置。

第 4 步：启动容器

现在就可以正式启动容器了：

docker compose up -d

如果你用的是主流 Compose v2，这就是最推荐的写法。老教程里常见的 docker-compose 也能见到，但这里不建议继续沿用旧写法。

第 5 步：检查容器状态和日志

启动完成后，不要直接跳去浏览器，先确认容器有没有正常起来：

docker compose ps
docker compose logs -f

只要容器状态正常，没有持续报权限错误或模型配置错误，说明部署已经基本成功。

第 6 步：访问 Dashboard，本地和服务器分开看

如果你在本机电脑上跑 Docker

直接打开：

http://127.0.0.1:18789/

如果你在云服务器上跑 Docker

这里要特别小心。社区项目默认配置更偏本地或私网测试，不适合直接把 Dashboard 裸露到公网。

更稳的做法是先通过 SSH 隧道访问：

ssh -N -L 18789:127.0.0.1:18789 your_user@your_server_ip

然后在你自己的本地浏览器打开：

http://127.0.0.1:18789/

Data

数据到底保存在哪里

这一步非常重要，因为它直接关系到后面的备份、迁移和权限问题。

主数据目录

社区 Compose 默认会把宿主机的 ~/.openclaw 挂到容器里的 /home/node/.openclaw。

里面包含什么

配置文件、工作区、部分插件数据都会在这个目录里，不是分别拆成两个宿主目录。

扩展目录

部分扩展资源还会额外放在命名卷 openclaw-extensions 里。

为什么要提前知道

因为迁移、备份和排权限问题时，你第一时间就知道该看哪里。

Troubleshooting

Docker-CN 最常见的 4 个问题

社区增强路线通常不是“装不上”，而是下面这几类细节容易卡住。

权限报错 如果宿主机目录和容器运行用户不一致，容易出现 Permission denied。最直接的修法是 sudo chown -R 1000:1000 ~/.openclaw。

想更稳地固定运行用户 可以在 .env 里加 OPENCLAW_RUN_USER=1000:1000，再重启容器。

镜像拉取慢 可以先手动执行 docker pull justlikemaki/openclaw-docker-cn-im:latest，或者提前配置 Docker 镜像加速。

想进容器调试 先执行 docker compose exec openclaw-gateway /bin/bash，如果需要再切到 node 用户。

Common Commands

以后最常用的几个 Docker 命令

Docker 路线后面主要就维护这几条命令。

docker compose down
docker compose restart
docker compose logs -f
docker compose exec openclaw-gateway /bin/bash

Not For Everyone

什么时候不建议选这条路

社区增强路线很好用，但不是所有人都适合从它开始。

只想走最纯官方路线 那就回安装总览，优先看官方安装脚本和官方 Docker 文档。

对第三方预装内容比较敏感 如果你更重视来源可控和最小化依赖，这条社区路线就不一定适合你。

只是临时试玩一下 如果只是想先体验，官方安装脚本通常更快，不一定要先上 Docker。

不打算长期跑 容器化的最大价值在于长期运行、迁移和重建，如果你暂时不需要，这条路线的优势感也会弱一点。

社区 Docker 路线

一句话总结

Docker-CN 这条路最适合中国用户想要“开箱即用 + 容器隔离 + 后面好迁移”的场景。但它是社区增强路线，不是官方标准镜像，所以使用时要同时把便利性和安全边界看清楚。

装完继续：首次配置 & Onboarding 遇到问题：社区安装经验分享重新选路：安装部署总览