OpenClaw-China-Docker Dockerfile构建解析如何把Chromium、Linuxbrew与4大IM插件打进一个镜像【免费下载链接】openclaw-china-dockerOpenClaw 的中国IM平台整合Docker版本预装并配置了飞书、钉钉、QQ机器人、企业微信等主流中国IM软件的插件让您可以快速部署一个支持多个中国IM平台的 AI 机器人网关项目地址: https://gitcode.com/gh_mirrors/op/openclaw-china-dockerOpenClaw-China-Docker 是一个面向中国 IM 场景的 OpenClaw Docker 整合镜像一份 Dockerfile 构建完成后Chromium 浏览器、Linuxbrew 工具链与微信、钉钉、QQ 机器人、企业微信 4 大 IM 插件就已预装其中docker compose up -d即可得到一个可用的多平台 AI 机器人网关。本文带你逐段读懂 Dockerfile 的构建流程与几个实用的镜像瘦身技巧。 镜像里预装了哪些核心组件组件具体内容作用运行时Node.js 22、Python 3.12、Bun、uv承载 OpenClaw 网关与各类插件脚本浏览器Chromium Playwright 依赖AI 网页自动化与内容抓取系统工具FFmpeg、git、socat、tini、gosu、jq、中文字体音视频处理、进程管理与中文渲染LinuxbrewHomebrew for Linux按 macOS 习惯在容器内安装命令行工具全局 npm 包openclaw、opencode-ai、playwright、tobilu/qmd 等OpenClaw 本体、AI 编码工具与记忆后端IM 插件napcat微信、soimy/dingtalk钉钉、tencent-connect/openclaw-qqbotQQ 机器人、sunnoy/wecom企业微信四大中国 IM 平台接入飞书走的是预置配置骨架 容器内一键安装官方插件的路线安装方法见 docs/quick-start.md 的进入容器一节微信接入则参考 docs/wechat.md。️ Dockerfile 构建流程三个阶段的执行顺序整个构建分为三层职责清晰、互不交叉第一阶段系统依赖与 Chromium 如何装进镜像root 用户从 Dockerfile#L1-L5 可以看到基础镜像的选型以node:22-slim为基底再从 Python 官方镜像中拷贝 Python 3.12——两个镜像同为 Debian Bookworm保证系统库版本一致避免跨发行版水土不服。紧接着是一个合并了全部安装步骤的大 RUNDockerfile#L16-L58一口气完成四件事装系统包apt 安装chromium、docker.io支持 Docker-in-Docker 沙箱、ffmpeg、中文字体fonts-noto-cjk、表情字体等十几个包配环境与换源配置en_US.UTF-8本地化注释里还记录了 slim 镜像中update-locale会报错的小坑改用直接写配置文件解决并把 npm 源切换到国内镜像加速装全局工具固定版本安装openclaw2026.4.9、opencode-ai、playwright、tobilu/qmd等核心包再用官方脚本安装 Bun 与 uv执行npx playwright install chromium --with-deps补齐浏览器依赖统一清理最后集中清理 apt 列表、npm 缓存与临时文件把镜像擦干净。第二阶段Linuxbrew 与 4 大 IM 插件安装步骤node 用户这一层先切到非 root 的node用户Dockerfile#L64-L66原因写在注释里让文件的主人从一开始就写入文件避免后期做 chown 权限修复从而防止镜像膨胀。主要工作有三步安装 Linuxbrew浅克隆 brew 仓库--depth 1到/home/node/.linuxbrew/Homebrew软链brew命令并放开组写权限Dockerfile#L69-L74安装 4 大 IM 插件openclaw plugins install依次装好钉钉、QQ 机器人、企业微信插件微信则由 git 克隆固定版本的 napcat 后本地安装Dockerfile#L79-L86。每条命令都包了timeout 300 ... || true——网络偶发失败不会中断整个构建瘦身与留种删除插件目录里的.git把整个extensions目录移进.openclaw-seed种子目录并写入版本标记2026.4.9-f1与 version.txt 一致Dockerfile#L91-L93。第三阶段环境变量与 Gateway 端口配置root 用户收尾层Dockerfile#L96-L123只干三件事拷入 init.sh 初始化脚本统一把 CRLF 换行符改成 LF 并加上执行权限设置PATH把 Linuxbrew 目录加进去、LANG、NODE_PATH等运行环境变量并用HOMEBREW_NO_AUTO_UPDATE关闭 Homebrew 自动更新以节省时间EXPOSE 18789暴露 Gateway 端口并把ENTRYPOINT指向初始化脚本。 值得借鉴的 Docker 镜像瘦身与工程化技巧合并 RUN、集中清理缓存所有安装压缩在同一个层里最后统一apt-get clean并删除缓存层数少、体积可控让文件生而正确插件安装前先把目录chown给node全程非 root 写入省掉事后修复权限的额外层版本钉死openclaw2026.4.9、napcat 固定 tag、qmd 固定版本保证构建结果可复现构建参数兜底CLAWHUB_TOKEN以ARG传入传入则自动登录安装私有包不传也不影响构建Dockerfile#L76-L77插件 Seed 机制预装插件不直接放在运行时目录而是放入.openclaw-seed种子目录由 init.sh 在容器启动时按版本同步到真实插件目录——升级镜像时用户自己安装的插件不会被覆盖还支持missing只补缺失、overwrite强制覆盖、seed-version按版本号智能同步三种策略。 构建完成之后容器启动时做了什么镜像只是弹药init.sh 才是点火器。容器启动时它会依次执行创建必要目录 → 根据环境变量生成 openclaw.json 配置骨架 → 修复宿主机挂载卷权限以 root 启动、随后降权到 node 运行网关→ 同步 Seed 插件 → 启动 OpenClaw Gateway。完整的开发者视角说明见 docs/developer-notes.md。 快速上手拉取或构建你的镜像绝大多数用户直接拉取预构建镜像即可docker pull justlikemaki/openclaw-docker-cn-im:latest如需自行构建或定制镜像构建时可传入CLAWHUB_TOKEN等参数在仓库根目录执行git clone https://gitcode.com/gh_mirrors/op/openclaw-china-docker cd openclaw-china-docker docker build -t openclaw-cn-im:local .之后参考 docs/quick-start.md 配置环境变量用 docker-compose.yml 一键启动。 相关文件索引文件说明Dockerfile镜像构建定义本文主角init.sh容器启动初始化与插件 Seed 同步脚本docker-compose.yml默认部署编排与独立工具容器openclaw.json.example默认配置结构示例version.txt当前镜像版本标记docs/developer-notes.md构建与启动流程开发者文档docs/quick-start.md新手部署指南【免费下载链接】openclaw-china-dockerOpenClaw 的中国IM平台整合Docker版本预装并配置了飞书、钉钉、QQ机器人、企业微信等主流中国IM软件的插件让您可以快速部署一个支持多个中国IM平台的 AI 机器人网关项目地址: https://gitcode.com/gh_mirrors/op/openclaw-china-docker创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考