首页/新闻资讯/正文详情

OpenClaw-China-Docker部署教程:docker-compose与.env环境变量完全指南,附极简起步清单

发布时间:2026/9/25 6:50:05 来源:云帆数科 栏目:资讯中心
OpenClaw-China-Docker部署教程:docker-compose与.env环境变量完全指南,附极简起步清单
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),仅供参考

相关推荐

Apache DataFusion 语义规范解读:逻辑/物理平面不变量与输出字段名生成规则
Apache DataFusion 语义规范解读:逻辑/物理平面不变量与输出字段名生成规则

大数据数据分析后端 【免费下载链接】datafusion Apache DataFusion SQL Query Engine 项目地址: https://gitcode.com/gh_mirrors/datafu/datafusion 点击查看 免费下载 本文围绕 Apache DataFusion 官方规格说明(Specification)体系&#… · 2026/9/25 6:49:59

RocketRide media_inspect 节点实战:流式媒体的探测、响度测量与 JPEG 截帧
RocketRide media_inspect 节点实战:流式媒体的探测、响度测量与 JPEG 截帧

【免费下载链接】rocketride-server High-performance AI pipeline engine with a C core and 50 Python-extensible nodes. Build, debug, and scale LLM workflows with 13 model providers, 8 vector databases, and agent orchestration, all from your IDE. Includes VS C… · 2026/9/25 6:49:59

Pyro 杂项算子库(pyro.ops)完全指南:从 HMC 数值工具到高斯收缩与流式统计
Pyro 杂项算子库(pyro.ops)完全指南:从 HMC 数值工具到高斯收缩与流式统计

人工智能机器学习深度学习概率编程 【免费下载链接】pyro Deep universal probabilistic programming with Python and PyTorch 项目地址: https://gitcode.com/gh_mirrors/py/pyro 点击查看 免费下载 Pyro 的 pyro.ops 模块实现了一整套与概率编程主体解耦的张量数… · 2026/9/25 6:49:59

PHP: The Right Way —— 用 Vagrant 为 PHP 项目构建可复现的虚拟开发环境
PHP: The Right Way —— 用 Vagrant 为 PHP 项目构建可复现的虚拟开发环境

文档教程 【免费下载链接】php-the-right-way An easy-to-read, quick reference for PHP best practices, accepted coding standards, and links to authoritative tutorials around the Web 项目地址: https://gitcode.com/gh_mirrors/ph/php-the-right-way 点击… · 2026/9/25 7:20:46

Atlas 300V 24G推理加速卡YOLO部署实战:从环境搭建到性能调优
Atlas 300V 24G推理加速卡YOLO部署实战:从环境搭建到性能调优

从去年开始,不少做视觉检测的同行陆续在群里问“Atlas 300V 24G是不是运算加速卡”这个问题。说实话,我第一次拿到这张卡也被绕了一下——它的外观和常见的GPU不太一样,官方文档里又把它归类为“AI推理加速卡”,但跑起YOLO来性能又… · 2026/9/25 7:20:46

kv4cj API参考手册:MMKV类全接口速查(附常用示例代码)
kv4cj API参考手册:MMKV类全接口速查(附常用示例代码)

kv4cj API参考手册:MMKV类全接口速查(附常用示例代码) 【免费下载链接】kv4cj 一个轻量级的键值存储库 项目地址: https://gitcode.com/Cangjie-TPC/kv4cj kv4cj 是一个用仓颉语言(Cangjie)封装的高性能键值存储… · 2026/9/25 7:20:40

电商数据库设计实战:7张表+事务+索引+审计
电商数据库设计实战:7张表+事务+索引+审计

简介:本资源是一套面向数据库初学者与Web开发学习者的MySQL实战项目资料,聚焦购物网站系统(MyShop商城)的数据库设计与实现,解决电商类应用中用户、商品、购物车、订单等核心模块的数据建模与业务逻辑支撑问题。压缩包… · 2026/9/25 7:20:28

Atlas 300V 24G昇腾AI推理卡部署YOLO模型实战:从环境搭建到性能调优
Atlas 300V 24G昇腾AI推理卡部署YOLO模型实战:从环境搭建到性能调优

1. 项目背景:Atlas 300V 24G到底是不是一张运算加速卡先回答那个被问得最多的问题:Atlas 300V 24G是运算加速卡吗?是,但它不是那种你在个人电脑里见过的显卡。Atlas 300V是华为昇腾生态下的AI推理加速卡,核心芯片用的是… · 2026/9/25 7:20:22

Atlas 300V部署YOLO实战:从环境配置到多路视频推理调优
Atlas 300V部署YOLO实战:从环境配置到多路视频推理调优

早两个月我把一张Atlas 300V插进服务器的时候,第一反应是:这卡到底算不算运算加速卡?插上去之后系统里没有nvidia-smi,没有CUDA,连安装包都换了一整套名字。查了一圈才搞明白,它确实是运算加速卡&#xff0… · 2026/9/25 7:20:22

数值优化(Numerical Optimization)学习系列-03-共轭梯度方法(Conjugate Gradient)
数值优化(Numerical Optimization)学习系列-03-共轭梯度方法(Conjugate Gradient)

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 1:00:31

创维E900V22D刷机全攻略:S905L3SB芯片兼容性解析与救砖实战
创维E900V22D刷机全攻略:S905L3SB芯片兼容性解析与救砖实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 1:00:31

MQTT协议原理与Broker服务器搭建实战:从Mosquitto到EMQX
MQTT协议原理与Broker服务器搭建实战:从Mosquitto到EMQX

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 1:00:37

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码