OpenClaw 开源桌面 Agent 完整部署与飞书钉钉集成指南

步骤 4：验证部署

1. 浏览器打开地址：http://localhost:18789
2. 输入步骤 3 设置的 Token（如 OpenClaw@2026），点击「连接」
3. 进入控制台即部署成功，本地/局域网访问地址：http://本机 IP:18789

方案 2：阿里云一键部署

步骤 1：购买轻量服务器

1. 访问阿里云 ECS 页面。
2. 选择默认配置（2 核 2G+40G SSD），地域选「中国香港/美国弗吉尼亚」（免 ICP 备案）。
3. 完成支付，等待实例状态变为「运行中」。

步骤 2：配置大模型 API-Key

1. 打开阿里云百炼平台，创建并复制 API-Key（Access Key ID+Secret）。
2. 进入阿里云服务器控制台→应用详情→执行命令，粘贴 API-Key 完成配置。

步骤 3：验证访问

1. 控制台复制服务器公网 IP，浏览器打开：http://公网 IP:18789
2. 复制控制台生成的 Token，输入后即可访问。

飞书集成

步骤 1：飞书开放平台创建企业自建应用

1. 打开飞书开发者后台，登录企业账号→「企业自建应用」→「创建应用」。
2. 填写应用名称（如 OpenClaw-Agent），选择「机器人」类型，提交创建。
3. 进入应用→「设置」→「凭证与基础信息」，复制 AppID、AppSecret 保存。
4. 进入「事件与回调」，开启「回调」，配置：
   • 请求地址：http://你的 IP:18789/feishu（本机/服务器 IP）
   • Token/EncodingAESKey：点击「随机生成」，复制保存。

步骤 2：容器内配置飞书插件

# 进入 OpenClaw 容器
docker exec -it openclaw-local bash

# 启用飞书插件
openclaw plugin enable feishu

# 配置飞书参数（替换为自己的 AppID/AppSecret/Token/AESKey）
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：发布应用 + 测试交互

1. 飞书开发者后台→「版本管理与发布」→「创建版本」→「发布到企业」。
2. 飞书端搜索应用名称，添加到群聊/个人对话。
3. 发送消息「你好」，OpenClaw 自动回复即集成成功，支持「@机器人 + 指令」触发自动化。

钉钉集成

步骤 1：钉钉开放平台创建企业内部应用

1. 打开钉钉开放平台，登录→「应用开发」→「钉钉应用」→「创建应用」。
2. 选择「企业内部应用」→「机器人」，填写名称后提交。
3. 进入应用→「凭证与基础信息」，复制 Client ID、Client Secret 保存。
4. 进入「卡片平台」→「新建模板」，选择「消息卡片」，直接保存发布，复制模板 ID 保存。

步骤 2：配置阿里云 AppFlow 连接流

1. 打开阿里云 AppFlow，选择模板「钉钉群聊 - 流式调用百炼应用」→「立即使用」。
2. 账户授权：
   • OpenClaw 凭证：添加 Token（部署时设置的 OpenClaw Token）
   • 钉钉凭证：添加 Client ID/Client Secret（步骤 1 复制）
3. 填写模板 ID（步骤 1 复制），生成 WebhookUrl，复制保存。

步骤 3：配置钉钉机器人 + 测试

1. 钉钉开放平台→应用→「添加应用能力」→「机器人」→「添加」。
2. 消息接收模式选「HTTP 模式」，接收地址填写生成的 WebhookUrl。
3. 发布应用，添加到钉钉群聊，@机器人发送「你好」，自动回复即集成成功。

自动化实战

实战 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 被占用

# Ubuntu/Linux 查找并杀死占用进程
sudo lsof -i:18789 | grep -v PID | awk '{print $2}' | xargs sudo kill -9

# Windows（管理员 PowerShell）
netstat -ano | findstr 18789
taskkill /f /pid 对应 PID

# 重启 OpenClaw
docker compose restart

2. 报错：Docker 镜像拉取/构建失败

• 解决方案：重新执行「一、1.3」国内镜像源配置，关闭防火墙/代理，重新构建：docker build -t openclaw:latest .

3. 飞书/钉钉集成无响应

1. 检查 IP/端口是否正确，服务器需放行 18789 端口（阿里云控制台→安全组→一键放通）。
2. 检查插件是否启用：docker exec -it openclaw-local openclaw plugin list（确认 feishu/dingtalk 为 enabled）。
3. 重启服务：docker compose restart。

4. 大模型响应慢/无结果

• 解决方案：更换大模型 API-Key（Kimi K2.5：https://ark.volces.com/），容器内配置：`openclaw config set model.api_key 你的新 API-Key`

进阶优化

1. 后台运行 + 开机自启

# Docker 默认已后台运行，设置开机自启 Docker
sudo systemctl enable docker
sudo systemctl enable docker-compose@openclaw（需将 docker-compose.yml 移至/etc/docker/compose/）

2. 数据持久化备份

# 备份 OpenClaw 数据卷到本地
docker run --rm -v openclaw-data:/source -v /本地备份路径:/target alpine cp -r /source/* /target/

3. 多模型切换

# 容器内配置自定义模型（如 Kimi/通义千问/文心一言）
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. 权限管控

# 仅允许指定 IP 访问（替换为你的 IP，多个 IP 用逗号分隔）
docker exec -it openclaw-local bash
openclaw config set gateway.allow_ips 192.168.1.100,139.xxx.xxx.xxx
openclaw gateway restart

功能特性

1. OpenClaw 核心能力：自然语言解析 + 任务自动化 + 多工具集成，支持本地文件/网络/IM 工具全管控。
2. 支持的插件：飞书/钉钉/企业微信/邮箱/日历，后续将新增微信/QQ/抖音集成，无需更新部署，直接启用插件。
3. 本地部署数据完全私有化，无上传风险，适合企业/个人隐私敏感场景。
4. 阿里云部署支持弹性扩容，4 核 8G 配置可支撑 10 人以下团队协作，按需升级即可。