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

前置准备

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 国内镜像源配置

# 配置 Docker 国内镜像源（Windows/macOS/Linux 通用）
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 国内镜像（拉取源码加速）
git config --global url."https://ghproxy.com/https://github.com/".insteadOf "https://github.com/"

核心部署方案

方案 1：Docker 一键部署

步骤 1：安装 Docker 和 Git

# Windows/macOS/Linux 通用一键安装脚本（内置国内源）
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

# 安装 Git
sudo apt install git -y # Ubuntu/Linux
# Windows 直接下载：https://git-scm.com/download/win（默认安装即可）

步骤 2：拉取源码 + 构建镜像

# 1. 克隆 OpenClaw 中文开源版源码
git clone https://ghproxy.com/https://github.com/OpenClawChinese/OpenClaw.git
cd OpenClaw

# 2. 构建 Docker 镜像
docker build -t openclaw:latest .

# 3. 创建数据持久化卷
docker volume create openclaw-data

步骤 3：初始化配置 + 启动服务

# 1. 初始化默认配置
docker run --rm -v openclaw-data:/root/.openclaw openclaw:latest openclaw setup

# 2. 配置远程/局域网访问
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

# 3. 创建 docker-compose.yml 并启动
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：容器内配置飞书插件

# 进入 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：发布应用 + 测试交互

飞书开发者后台→「版本管理与发布」→「创建版本」→「发布到企业」。
飞书端搜索应用名称，添加到群聊/个人对话。
发送消息「你好」，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 被占用

# 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. 飞书/钉钉集成无响应

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

功能特性

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

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

前置准备

1.1 硬件要求

1.2 软件要求

1.3 国内镜像源配置

核心部署方案

方案 1：Docker 一键部署

步骤 1：安装 Docker 和 Git

步骤 2：拉取源码 + 构建镜像

步骤 3：初始化配置 + 启动服务

步骤 4：验证部署

方案 2：阿里云一键部署

步骤 1：购买轻量服务器

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

步骤 3：验证访问

飞书集成

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

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

步骤 3：发布应用 + 测试交互

钉钉集成

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

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

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

自动化实战

实战 1：本地文件自动整理

实战 2：飞书/钉钉消息自动回复

实战 3：定时生成工作报表

常见问题排查

1. 报错：端口 18789 被占用

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

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

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

进阶优化

1. 后台运行 + 开机自启

2. 数据持久化备份

3. 多模型切换

4. 权限管控

功能特性

更多推荐文章

相关免费在线工具

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

前置准备

1.1 硬件要求

1.2 软件要求

1.3 国内镜像源配置

核心部署方案

方案 1：Docker 一键部署

步骤 1：安装 Docker 和 Git

步骤 2：拉取源码 + 构建镜像

步骤 3：初始化配置 + 启动服务

步骤 4：验证部署

方案 2：阿里云一键部署

步骤 1：购买轻量服务器

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

步骤 3：验证访问

飞书集成

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

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

步骤 3：发布应用 + 测试交互

钉钉集成

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

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

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

自动化实战

实战 1：本地文件自动整理

实战 2：飞书/钉钉消息自动回复

实战 3：定时生成工作报表

常见问题排查

1. 报错：端口 18789 被占用

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

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

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

进阶优化

1. 后台运行 + 开机自启

2. 数据持久化备份

3. 多模型切换

4. 权限管控

功能特性

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具