前置准备
1.1 硬件要求
- CPU:≥2 核(Intel i3/i5、AMD Ryzen 3/5 及以上)
- 内存:≥4G(推荐 8G,避免多任务卡顿)
- 存储:SSD 剩余≥10G(仅存储镜像/配置,无大文件)
- 网络:可正常联网(国内网络即可,已适配国内镜像源)
1.2 软件要求
- 操作系统:Windows10+/macOS12+/Linux(Ubuntu22.04 最佳,Windows 推荐 WSL2)
- 核心工具:Docker≥24.0 + Docker Compose≥2.20、Git≥2.40
- 可选凭证:大模型 API-Key(阿里云百炼/Kimi K2.5,用于增强自然语言能力,本地部署可省略)
- 浏览器:Chrome/Edge 最新版(用于访问控制台)
1.3 国内镜像源配置
mkdir -p /etc/docker
cat > /etc/docker/daemon.json << EOF
{
"registry-mirrors": ["https://docker.mirrors.ustc.edu.cn", "https://hub-mirror.c.163.com"]
}
EOF
systemctl daemon-reload && systemctl restart docker
git config --global url."https://ghproxy.com/https://github.com/".insteadOf "https://github.com/"
核心部署方案
方案 1:Docker 一键部署
步骤 1:安装 Docker 和 Git
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
sudo apt install git -y
步骤 2:拉取源码 + 构建镜像
git clone https://ghproxy.com/https://github.com/OpenClawChinese/OpenClaw.git
cd OpenClaw
docker build -t openclaw:latest .
docker volume create openclaw-data
步骤 3:初始化配置 + 启动服务
docker run --rm -v openclaw-data:/root/.openclaw openclaw:latest openclaw setup
docker run --rm -v openclaw-data:/root/.openclaw openclaw:latest openclaw config set gateway.bind lan
docker run --rm -v openclaw-data:/root/.openclaw openclaw:latest openclaw config set gateway.auth.token OpenClaw@2026
cat > docker-compose.yml << EOF
version: '3.8'
services:
openclaw:
image: openclaw:latest
container_name: openclaw-local
ports:
- "18789:18789"
volumes:
- openclaw-data:/root/.openclaw
restart: unless-stopped
command: openclaw gateway run --allow-unconfigured
volumes:
openclaw-data:
name: openclaw-data
EOF
docker compose up -d
步骤 4:验证部署
- 浏览器打开地址:
http://localhost:18789
- 输入步骤 3 设置的 Token(如 OpenClaw@2026),点击「连接」
- 进入控制台即部署成功,本地/局域网访问地址:
http://本机 IP:18789
方案 2:阿里云一键部署
步骤 1:购买轻量服务器
- 访问阿里云 ECS 页面。
- 选择默认配置(2 核 2G+40G SSD),地域选「中国香港/美国弗吉尼亚」(免 ICP 备案)。
- 完成支付,等待实例状态变为「运行中」。
步骤 2:配置大模型 API-Key
- 打开阿里云百炼平台,创建并复制 API-Key(Access Key ID+Secret)。
- 进入阿里云服务器控制台→应用详情→执行命令,粘贴 API-Key 完成配置。
步骤 3:验证访问
- 控制台复制服务器公网 IP,浏览器打开:
http://公网 IP:18789
- 复制控制台生成的 Token,输入后即可访问。
飞书集成
步骤 1:飞书开放平台创建企业自建应用
- 打开飞书开发者后台,登录企业账号→「企业自建应用」→「创建应用」。
- 填写应用名称(如 OpenClaw-Agent),选择「机器人」类型,提交创建。
- 进入应用→「设置」→「凭证与基础信息」,复制 AppID、AppSecret 保存。
- 进入「事件与回调」,开启「回调」,配置:
- 请求地址:
http://你的 IP:18789/feishu(本机/服务器 IP)
- Token/EncodingAESKey:点击「随机生成」,复制保存。
步骤 2:容器内配置飞书插件
docker exec -it openclaw-local bash
openclaw plugin enable feishu
openclaw config set feishu.token 你的飞书回调 Token
openclaw config set feishu.aes_key 你的飞书 EncodingAESKey
openclaw config set feishu.app_id 你的飞书 AppID
openclaw config set feishu.app_secret 你的飞书 AppSecret
openclaw gateway restart
exit
步骤 3:发布应用 + 测试交互
- 飞书开发者后台→「版本管理与发布」→「创建版本」→「发布到企业」。
- 飞书端搜索应用名称,添加到群聊/个人对话。
- 发送消息「你好」,OpenClaw 自动回复即集成成功,支持「@机器人 + 指令」触发自动化。
钉钉集成
步骤 1:钉钉开放平台创建企业内部应用
- 打开钉钉开放平台,登录→「应用开发」→「钉钉应用」→「创建应用」。
- 选择「企业内部应用」→「机器人」,填写名称后提交。
- 进入应用→「凭证与基础信息」,复制 Client ID、Client Secret 保存。
- 进入「卡片平台」→「新建模板」,选择「消息卡片」,直接保存发布,复制模板 ID 保存。
步骤 2:配置阿里云 AppFlow 连接流
- 打开阿里云 AppFlow,选择模板「钉钉群聊 - 流式调用百炼应用」→「立即使用」。
- 账户授权:
- OpenClaw 凭证:添加 Token(部署时设置的 OpenClaw Token)
- 钉钉凭证:添加 Client ID/Client Secret(步骤 1 复制)
- 填写模板 ID(步骤 1 复制),生成 WebhookUrl,复制保存。
步骤 3:配置钉钉机器人 + 测试
- 钉钉开放平台→应用→「添加应用能力」→「机器人」→「添加」。
- 消息接收模式选「HTTP 模式」,接收地址填写生成的 WebhookUrl。
- 发布应用,添加到钉钉群聊,@机器人发送「你好」,自动回复即集成成功。
自动化实战
实战 1:本地文件自动整理
- 触发方式:飞书/钉钉发送指令:
整理 D 盘/桌面的文件,按文档/图片/视频分类,按修改时间命名
- 核心效果:自动扫描指定目录,支持 PDF/Word/Excel/图片/视频等所有格式;分类创建文件夹,文件重命名为「时间 - 原名称」。
实战 2:飞书/钉钉消息自动回复
docker exec -it openclaw-local bash
openclaw config set auto_reply.key1 "加班 | 请假"
openclaw config set auto_reply.value1 "加班申请请发送至 XX 邮箱,请假流程参考飞书审批"
openclaw config set auto_reply.enable true
openclaw gateway restart
- 触发方式:飞书/钉钉发送包含「加班/请假」的消息,机器人自动回复预设内容。
实战 3:定时生成工作报表
- 触发指令:飞书/钉钉发送:
每天下午 6 点统计今日飞书群聊消息数量,按部门生成报表,推送到 XX 群
- 核心效果:按预设时间自动执行,支持按人/部门/关键词统计消息/文件/任务;生成 Excel/图片报表,自动推送至指定群聊/个人。
常见问题排查
1. 报错:端口 18789 被占用
sudo lsof -i:18789 | grep -v PID | awk '{print $2}' | xargs sudo kill -9
netstat -ano | findstr 18789
taskkill /f /pid 对应 PID
docker compose restart
2. 报错:Docker 镜像拉取/构建失败
- 解决方案:重新执行「一、1.3」国内镜像源配置,关闭防火墙/代理,重新构建:
docker build -t openclaw:latest .
3. 飞书/钉钉集成无响应
- 检查 IP/端口是否正确,服务器需放行 18789 端口(阿里云控制台→安全组→一键放通)。
- 检查插件是否启用:
docker exec -it openclaw-local openclaw plugin list(确认 feishu/dingtalk 为 enabled)。
- 重启服务:
docker compose restart。
4. 大模型响应慢/无结果
进阶优化
1. 后台运行 + 开机自启
sudo systemctl enable docker
sudo systemctl enable docker-compose@openclaw(需将 docker-compose.yml 移至/etc/docker/compose/)
2. 数据持久化备份
docker run --rm -v openclaw-data:/source -v /本地备份路径:/target alpine cp -r /source/* /target/
3. 多模型切换
docker exec -it openclaw-local bash
openclaw config set model.base_url 模型 API 地址(如 Kimi:https://ark.cn-beijing.volces.com/api/coding)
openclaw config set model.api_key 模型 API-Key
openclaw gateway restart
4. 权限管控
docker exec -it openclaw-local bash
openclaw config set gateway.allow_ips 192.168.1.100,139.xxx.xxx.xxx
openclaw gateway restart
功能特性
- OpenClaw 核心能力:自然语言解析 + 任务自动化 + 多工具集成,支持本地文件/网络/IM 工具全管控。
- 支持的插件:飞书/钉钉/企业微信/邮箱/日历,后续将新增微信/QQ/抖音集成,无需更新部署,直接启用插件。
- 本地部署数据完全私有化,无上传风险,适合企业/个人隐私敏感场景。
- 阿里云部署支持弹性扩容,4 核 8G 配置可支撑 10 人以下团队协作,按需升级即可。