OpenClaw-China-Docker部署教程docker-compose与.env环境变量完全指南附极简起步清单【免费下载链接】openclaw-china-dockerOpenClaw 的中国IM平台整合Docker版本预装并配置了飞书、钉钉、QQ机器人、企业微信等主流中国IM软件的插件让您可以快速部署一个支持多个中国IM平台的 AI 机器人网关项目地址: https://gitcode.com/gh_mirrors/op/openclaw-china-dockerOpenClaw-China-Docker 是面向中国 IM 场景的 OpenClaw Docker 整合镜像预装飞书、钉钉、QQ 机器人、企业微信等主流 IM 插件通过 docker-compose 编排与 .env 环境变量驱动可快速部署一个支持多平台的 AI 机器人网关。本教程面向新手用最短路径带你完成部署并附极简起步清单让你 10 分钟内跑起自己的机器人网关。一、部署前准备3 项检查清单在开始之前请确认以下 3 项避免部署中途卡壳检查项说明 已安装 Docker宿主机需安装 Docker 与 Docker Compose 插件 已准备 AI 模型 API至少一组MODEL_ID、BASE_URL、API_KEY 已确认数据目录默认挂载到~/.openclaw需保证容器可写 项目采用配置驱动设计容器首次启动时会读取.env环境变量自动生成openclaw.json配置无需手动编写 JSON。二、docker-compose 三步快速部署以下步骤基于仓库内的 docker-compose.yml 与 .env.example 模板是最推荐的部署方式。1. 克隆仓库获取部署文件git clone https://gitcode.com/gh_mirrors/op/openclaw-china-docker cd openclaw-china-docker建议直接克隆整个仓库而不是只下载单个文件方便后续升级时同步README.md、docker-compose.yml与.env.example的变更。2. 初始化 .env 环境变量项目提供两版模板新手推荐从精简版起步# 极简起步仅核心参数推荐新手 cp .env.minimal .env完整版.env.example包含所有可选配置及详细注释精简版.env.minimal仅包含运行必需的核心参数打开.env至少填写模型三件套MODEL_IDgpt-4o BASE_URLhttps://api.openai.com/v1 API_KEYsk-your-key-hereIM 平台变量飞书、钉钉等此时留空即可后续按需再启用。3. 启动服务并验证docker compose up -d # 后台启动 docker compose logs -f # 查看启动日志部署后建议检查 4 项来自 docs/quick-start.md 的检查清单✅ 端口18789Gateway 默认端口已被占用✅.env中模型相关变量已填写✅ 宿主机数据目录~/.openclaw对容器可写✅ 日志中出现渠道同步、配置同步完成等提示需要停止服务时执行docker compose down即可。三、.env 环境变量完全指南.env是本项目唯一的操作入口下面按重要程度分组讲解完整变量列表见 .env.example变量如何映射到最终配置请参考 docs/configuration.md。1. 核心模型配置必配变量说明示例MODEL_ID模型名称多个用逗号分隔gpt-4oBASE_URL模型服务地址OpenAI 兼容接口通常带/v1https://api.openai.com/v1API_KEY模型服务密钥sk-xxxAPI_PROTOCOL协议类型openai-completionsCONTEXT_WINDOW上下文窗口大小128000MAX_TOKENS最大输出 token 数4096协议类型共 4 种可选openai-completions最常见、openai-responses、google-generative-ai、anthropic-messages。填错协议是连接失败的头号原因配置指南中有 docs/faq.md 的排查建议。2. IM 平台渠道变量按需启用每个渠道缺少必需变量时会被启动脚本自动禁用因此填多少启用多少不会报错平台必需变量 飞书FEISHU_APP_IDFEISHU_APP_SECRET 钉钉DINGTALK_CLIENT_IDDINGTALK_CLIENT_SECRET QQ 机器人QQBOT_APP_IDQQBOT_CLIENT_SECRET 企业微信WECOM_BOT_IDWECOM_SECRET多账号 / 多机器人场景可使用FEISHU_ACCOUNTS_JSON、DINGTALK_ACCOUNTS_JSON、QQBOT_BOTS_JSON、WECOM_ACCOUNTS_JSON等 JSON 变量。另外微信平台的接入可单独参考 docs/wechat.md。3. Gateway 与高级选项可选变量说明默认值OPENCLAW_GATEWAY_TOKEN网关访问令牌123456OPENCLAW_GATEWAY_PORT网关端口18789DOCKER_BIND端口绑定 IP仅本地访问建议设127.0.0.10.0.0.0OPENCLAW_DATA_DIR宿主机数据挂载目录~/.openclawOPENCLAW_SANDBOX_MODEDocker 沙箱模式off/non-main/alloff⚠️ 安全提示默认DOCKER_BIND0.0.0.0意味着端口监听所有网卡。如果服务器暴露在公网建议设置为127.0.0.1并配合反向代理。四、常见问题排查改了环境变量不生效怎么办这是新手最高频的困惑。容器启动时 init.sh 会根据环境变量同步生成配置但以下情况会导致没生效容器未重建修改.env后务必重建容器而不是仅restartdocker compose up -d --force-recreate变量缺失被自动禁用查看日志中渠道同步、已禁用渠道、未提供环境变量等关键词docker compose logs -f openclaw-gateway权限问题出现Permission denied通常是宿主机目录权限与容器用户不一致可参照 docs/faq.md 修复。更多故障排查如 401/403 错误、飞书收不到消息均已收录在 docs/faq.md。五、极简起步清单速查部署完成后把这张清单收藏起来步骤命令 / 操作1️⃣ 克隆仓库git clone后进入目录2️⃣ 生成 .envcp .env.minimal .env并填写模型三件套3️⃣ 启动docker compose up -d4️⃣ 验证docker compose logs -f看同步日志5️⃣ 接入 IM在.env补填对应渠道变量后--force-recreate重建6️⃣ 升级git pull→docker compose pull→up -d --force-recreate相关文件导航快速部署与升级docs/quick-start.md环境变量详解docs/configuration.md高级运行方式docker run、数据持久化docs/advanced.mdAIClient 对接解决 Token 焦虑docs/aiclient-2-api.md配置结构参考openclaw.json.example按照以上步骤你就已经完成了一个支持飞书、钉钉、QQ 机器人、企业微信等多平台的中国 IM AI 机器人网关部署。后续只需按需补充.env中的渠道变量并重建容器即可逐个点亮更多平台。【免费下载链接】openclaw-china-dockerOpenClaw 的中国IM平台整合Docker版本预装并配置了飞书、钉钉、QQ机器人、企业微信等主流中国IM软件的插件让您可以快速部署一个支持多个中国IM平台的 AI 机器人网关项目地址: https://gitcode.com/gh_mirrors/op/openclaw-china-docker创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
