OpenClaw 多Agent员工创建与飞书打通完整指南OpenClaw 多Agent员工创建与飞书打通完整指南 📋

OpenClaw 多Agent员工创建与飞书打通完整指南

本指南面向小白用户，手把手教你创建多个专用AI员工并与飞书打通，实现企业级AI助手系统。

📋 目录

准备工作
创建Agent员工
配置飞书机器人
打通飞书通道
Agent间通信配置
完整配置参考
常见问题

1. 准备工作

1.1 环境要求

OpenClaw 已安装并运行
飞书企业账号（或创建测试企业）
基本的命令行操作知识

1.2 检查OpenClaw状态


# 检查OpenClaw服务状态

openclaw gateway status

  


# 如果未运行，启动服务

openclaw gateway start

1.3 确认飞书插件已安装

OpenClaw 自带飞书插件，无需额外安装。但需要确认插件可用：


# 检查飞书插件是否可用

# 方法1：查看OpenClaw扩展目录

ls -la /www/server/nodejs/v22.22.0/lib/node_modules/openclaw/extensions/ | grep -i feishu

  


# 方法2：检查插件配置

openclaw plugins list 2>/dev/null || echo "使用默认插件配置"

飞书插件状态说明：

✅ 已内置：OpenClaw默认包含飞书插件
✅ 无需安装：开箱即用，无需额外安装步骤
✅ 支持长链接：插件支持飞书长链接方式，无需Webhook配置
✅ 多账户支持：支持配置多个飞书应用账户

1.4 启用飞书插件（如果需要）

如果飞书插件未自动启用，可以在配置文件中启用：

编辑 ~/.openclaw/openclaw.json，在 plugins 部分添加：


"plugins": {

"entries": {

"feishu": {

"enabled": true

}

}

}

1.5 创建基础目录


# 创建Agent存储目录

mkdir -p ~/.openclaw/agents

2. 创建Agent员工

2.1 设计你的Agent团队

在开始前，先规划好需要哪些Agent。例如：

| Agent名称 | ID | 职责 | 适合模型 |

|-----------|----|------|----------|

2.2 创建Agent目录结构


# 为每个Agent创建目录

for agent in logistics-an customer-service-pig recruitment-assistant kang-lian-jia-promoter; do

mkdir -p ~/.openclaw/agents/$agent/agent

mkdir -p ~/.openclaw/agents/$agent/workspace

done

2.3 创建Agent配置文件

每个Agent需要两个配置文件：

1) Agent主配置 (`~/.openclaw/agents/<agent-id>/agent/agent.json`)


{

"id": "logistics-an",

"name": "后勤小安",

"description": "后勤专员，负责整理文件、自动定时生成图文视频内容",

"model": "deepseek/deepseek-coder",

"personality": "细心、有条理、高效，喜欢整理和规划"

}

2) 工作空间身份文件 (`~/.openclaw/agents/<agent-id>/workspace/IDENTITY.md`)


# IDENTITY.md - 后勤小安

  


- **姓名：** 后勤小安

- **职位：** 后勤专员

- **性格：** 细心、有条理、高效、喜欢整理和规划

- **Emoji：** 📁📅🎬

- **职责：**

1. 文件整理和分类

2. 自动定时生成图文内容

3. 视频内容策划和生成

4. 工作流程优化

  


- **口号：** "有条不紊，高效后勤！"

2.4 更新OpenClaw主配置

编辑 ~/.openclaw/openclaw.json，在 agents.list 数组中添加你的Agent：


"agents": {

"defaults": {

// ... 保持原有配置

},

"list": [

{

"id": "main",

"name": "唐吉可达鸭",

"workspace": "/root/.openclaw/workspace-main",

"agentDir": "/root/.openclaw/agents/main/agent",

"default": true

},

{

"id": "logistics-an",

"name": "后勤小安",

"workspace": "/root/.openclaw/agents/logistics-an/workspace",

"agentDir": "/root/.openclaw/agents/logistics-an/agent",

"model": "deepseek/deepseek-coder"

},

{

"id": "customer-service-pig",

"name": "客服小猪",

"workspace": "/root/.openclaw/agents/customer-service-pig/workspace",

"agentDir": "/root/.openclaw/agents/customer-service-pig/agent",

"model": "deepseek/deepseek-chat"

},

{

"id": "recruitment-assistant",

"name": "Boss招小助",

"workspace": "/root/.openclaw/agents/recruitment-assistant/workspace",

"agentDir": "/root/.openclaw/agents/recruitment-assistant/agent",

"model": "deepseek/deepseek-chat"

},

{

"id": "kang-lian-jia-promoter",

"name": "APP小推",

"workspace": "/root/.openclaw/agents/kang-lian-jia-promoter/workspace",

"agentDir": "/root/.openclaw/agents/kang-lian-jia-promoter/agent",

"model": "deepseek/deepseek-coder"

}

]

}

3. 配置飞书机器人

3.1 创建飞书应用

对每个Agent，都需要在飞书开放平台创建独立应用：

访问飞书开放平台：open.feishu.cn/app
创建企业自建应用
填写应用信息：

应用名称：后勤小安
应用描述：后勤专员AI助手
应用图标：上传合适的图标

3.2 获取应用凭证

在应用详情页的 凭证与基础信息 中获取：

App ID（格式如 cli_xxx）
App Secret

记录下每个应用的凭证（请替换为你的实际凭证）：

| Agent | App ID | App Secret |

|-------|--------|------------|

| 后勤小安 | cli_a9xxxxxxxxxxxxxx | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |

| 客服小猪 | cli_a9xxxxxxxxxxxxxx | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |

| Boss招小助 | cli_a9xxxxxxxxxxxxxx | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |

| APP小推 | cli_a9xxxxxxxxxxxxxx | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |

注意： App ID格式通常为 cli_ 开头，App Secret为32位随机字符串。请妥善保管你的App Secret，不要泄露给他人。

3.3 配置应用权限

在 权限管理 页面，点击 批量导入，粘贴以下权限配置：


{

"scopes": {

"tenant": [

"aily:file:read",

"aily:file:write",

"application:application.app_message_stats.overview:readonly",

"application:application:self_manage",

"application:bot.menu:write",

"cardkit:card:write",

"contact:user.employee_id:readonly",

"corehr:file:download",

"docs:document.content:read",

"event:ip_list",

"im:chat",

"im:chat.access_event.bot_p2p_chat:read",

"im:chat.members:bot_access",

"im:message",

"im:message.group_at_msg:readonly",

"im:message.group_msg",

"im:message.p2p_msg:readonly",

"im:message:readonly",

"im:message:send_as_bot",

"im:resource",

"sheets:spreadsheet",

"wiki:wiki:readonly"

],

"user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]

}

}

3.4 启用机器人能力

在 应用能力 > 机器人 页面：

开启机器人能力
配置机器人名称（与Agent名称一致）

3.5 配置飞书事件与回调（关键步骤！）

重要提示：必须先完成OpenClaw飞书通道配置并重启服务，才能配置事件与回调。

步骤1：确保OpenClaw配置正确

在配置飞书事件与回调前，必须确保：

OpenClaw Gateway正在运行：openclaw gateway status
飞书通道配置已完成（参考第4节）
Gateway已重启：openclaw gateway restart

步骤2：配置事件订阅

在飞书应用管理后台的 事件与回调 页面：

选择订阅方式：

点击"启用"事件订阅
订阅方式选择：长链接（这是关键！）
OpenClaw支持长链接方式，无需配置Webhook URL

验证配置：

如果OpenClaw飞书消息通道配置正确，页面会显示"连接成功"
如果配置错误，会显示"连接失败"，无法保存
无法保存说明OpenClaw配置有问题，需要检查：
Gateway是否运行
App ID/Secret是否正确
网络连接是否正常

添加事件权限：

连接成功后，可以添加事件权限。特别关注IM相关事件：

必选的事件权限：


✅ 接收消息

✅ 群组消息

✅ 单聊消息

✅ 消息已读事件

✅ 进群事件

✅ 群配置更新事件

✅ 机器人被移除事件

具体权限配置：

im:message - 接收用户发送的消息
im:message.group_at_msg:readonly - 接收群聊中@机器人的消息
im:message.p2p_msg:readonly - 接收单聊消息
im:chat.access_event.bot_p2p_chat:read - 机器人被用户添加到单聊
im:chat.members:bot_access - 机器人被添加到群聊
im:chat - 群组相关事件

保存配置：

添加完事件权限后，点击"保存"
系统会提示"配置成功"
可能需要等待1-2分钟生效

步骤3：测试事件接收

配置完成后，测试事件是否正常接收：

单聊测试：

在飞书中找到机器人，发送消息
查看OpenClaw日志：openclaw logs --follow
应该能看到消息接收日志

群聊测试：

将机器人添加到群聊
在群聊中@机器人发送消息
确认机器人能正常回复

事件验证：

查看Gateway日志，确认各种事件正常接收
如：用户进群、消息已读等事件

步骤4：权限申请与审核

部分高级权限可能需要管理员审核：

提交权限申请：

在权限管理页面提交申请
填写使用理由（如：用于智能客服、自动回复等）

管理员审核：

企业管理员在飞书管理后台审核
审核通过后权限生效

常见问题：

Q: 为什么无法保存事件订阅配置？

A: 检查以下几点：

OpenClaw Gateway是否正在运行
App ID和App Secret是否正确
网络连接是否正常
是否选择了"长链接"方式

Q: 收不到消息怎么办？

A: 排查步骤：

检查事件权限是否已添加
查看OpenClaw日志是否有错误
确认机器人是否被启用
测试网络连接

Q: 部分事件收不到？

A: 确保已添加对应的事件权限，部分事件需要特定权限才能接收。

配置完成标志：

✅ 事件订阅页面显示"连接成功"
✅ 可以正常保存配置
✅ 机器人能接收和回复消息
✅ Gateway日志显示正常的事件接收

4. 打通飞书通道

4.1 为每个Agent创建飞书凭证配置

为每个Agent创建 auth-profiles.json 文件：


# 后勤小安的飞书凭证配置

cat > ~/.openclaw/agents/logistics-an/agent/auth-profiles.json << 'EOF'

{

"feishu": {

"logistics-an": {

"appId": "cli_a9xxxxxxxxxxxxxx",

"appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",

"description": "后勤小安 - 飞书机器人"

}

}

}

EOF

  


# 其他Agent类似创建...

4.2 更新OpenClaw主配置

在 ~/.openclaw/openclaw.json 中添加飞书通道配置：


"channels": {

"feishu": {

"accounts": {

"logistics-an": {

"appId": "cli_a9xxxxxxxxxxxxxx",

"appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

},

"customer-service-pig": {

"appId": "cli_a9xxxxxxxxxxxxxx",

"appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

},

"recruitment-assistant": {

"appId": "cli_a9xxxxxxxxxxxxxx",

"appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

},

"kang-lian-jia-promoter": {

"appId": "cli_a9xxxxxxxxxxxxxx",

"appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

}

}

}

},

"bindings": [

{

"agentId": "logistics-an",

"match": {

"channel": "feishu",

"accountId": "logistics-an"

}

},

{

"agentId": "customer-service-pig",

"match": {

"channel": "feishu",

"accountId": "customer-service-pig"

}

},

{

"agentId": "recruitment-assistant",

"match": {

"channel": "feishu",

"accountId": "recruitment-assistant"

}

},

{

"agentId": "kang-lian-jia-promoter",

"match": {

"channel": "feishu",

"accountId": "kang-lian-jia-promoter"

}

}

]

4.3 重启OpenClaw服务


# 重启服务使配置生效

openclaw gateway restart

  


# 检查服务状态

openclaw gateway status

4.4 测试飞书机器人

在飞书中搜索你创建的机器人
发送消息测试
确认收到正确的Agent回复

5. Agent间通信配置

5.1 启用Agent间通信

在 ~/.openclaw/openclaw.json 的 tools 部分添加：


"tools": {

"profile": "coding",

"agentToAgent": {

"enabled": true,

"allow": [

"logistics-an",

"customer-service-pig",

"recruitment-assistant",

"kang-lian-jia-promoter",

"main"

]

}

}

5.2 创建通信协议文档

为每个Agent创建通信指南：


# 后勤小安的通信指南

cat > ~/.openclaw/agents/logistics-an/workspace/COMMUNICATION_GUIDE.md << 'EOF'

# 后勤小安 - 通信指南

  


## 🤝 我可以联系的伙伴

1. **唐吉可达鸭** (main) - 总协调

2. **客服小猪** (customer-service-pig) - 提供客户支持材料

3. **Boss招小助** (recruitment-assistant) - 提供招聘相关文件

4. **APP小推** (kang-lian-jia-promoter) - 提供推广素材

  


## 📤 我提供的服务

- 📁 文件整理和分类

- 📅 日程安排和提醒

- 🎬 内容生成和编辑

- 📊 数据整理和分析

  


## 📥 我需要的帮助

- 遇到复杂客户问题 → 咨询 **客服小猪**

- 需要招聘数据分析 → 咨询 **Boss招小助**

- 需要推广效果评估 → 咨询 **APP小推**

- 系统问题或协调 → 联系 **唐吉可达鸭**

EOF

5.3 重启服务并验证配置

完成所有配置后，需要重启服务并验证：


# 1. 重启OpenClaw Gateway

openclaw gateway restart

  


# 2. 检查服务状态

openclaw gateway status

  


# 3. 查看启动日志

openclaw logs --follow --lines 50

  


# 4. 验证飞书连接

# 在日志中搜索"feishu"确认连接成功

5.4 测试Agent间通信

重启服务后，可以通过以下方式测试：

唐吉可达鸭发送消息给后勤小安
客服小猪请求后勤小安提供资料
验证消息是否能正确传递

5.5 完整系统测试清单

配置完成后，建议进行以下测试：

✅ 基础功能测试

Gateway服务正常运行
飞书插件加载成功
所有Agent配置正确加载

✅ 飞书通道测试

飞书机器人能正常接收消息
机器人能正确回复消息
单聊和群聊功能正常
事件订阅配置正确

✅ Agent功能测试

各Agent能独立处理对应任务
Agent间通信功能正常
消息路由正确

✅ 性能测试

多消息并发处理
长时间运行稳定性
资源使用情况监控

6. 完整配置参考

6.1 完整的 `openclaw.json` 配置


{

"agents": {

"defaults": {

"model": {

"primary": "deepseek/deepseek-chat"

},

"models": {

"deepseek/deepseek-chat": {

"alias": "deepseek"

},

"deepseek/deepseek-coder": {},

"bailian/qwen3-max-2026-01-23": {

"alias": "bailian"

}

},

"workspace": "/root/.openclaw/workspace",

"compaction": {

"mode": "safeguard"

},

"maxConcurrent": 4,

"subagents": {

"maxConcurrent": 8

}

},

"list": [

{

"id": "main",

"name": "唐吉可达鸭",

"workspace": "/root/.openclaw/workspace-main",

"agentDir": "/root/.openclaw/agents/main/agent",

"default": true

},

{

"id": "logistics-an",

"name": "后勤小安",

"workspace": "/root/.openclaw/agents/logistics-an/workspace",

"agentDir": "/root/.openclaw/agents/logistics-an/agent",

"model": "deepseek/deepseek-coder"

},

{

"id": "customer-service-pig",

"name": "客服小猪",

"workspace": "/root/.openclaw/agents/customer-service-pig/workspace",

"agentDir": "/root/.openclaw/agents/customer-service-pig/agent",

"model": "deepseek/deepseek-chat"

},

{

"id": "recruitment-assistant",

"name": "Boss招小助",

"workspace": "/root/.openclaw/agents/recruitment-assistant/workspace",

"agentDir": "/root/.openclaw/agents/recruitment-assistant/agent",

"model": "deepseek/deepseek-chat"

},

{

"id": "kang-lian-jia-promoter",

"name": "APP小推",

"workspace": "/root/.openclaw/agents/kang-lian-jia-promoter/workspace",

"agentDir": "/root/.openclaw/agents/kang-lian-jia-promoter/agent",

"model": "deepseek/deepseek-coder"

}

]

},

"tools": {

"profile": "coding",

"agentToAgent": {

"enabled": true,

"allow": [

"logistics-an",

"customer-service-pig",

"recruitment-assistant",

"kang-lian-jia-promoter",

"main"

]

}

},

"channels": {

"feishu": {

"accounts": {

"logistics-an": {

"appId": "cli_a9xxxxxxxxxxxxxx",

"appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

},

"customer-service-pig": {

"appId": "cli_a9xxxxxxxxxxxxxx",

"appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

},

"recruitment-assistant": {

"appId": "cli_a9xxxxxxxxxxxxxx",

"appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

},

"kang-lian-jia-promoter": {

"appId": "cli_a9xxxxxxxxxxxxxx",

"appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

}

}

}

},

"bindings": [

{

"agentId": "logistics-an",

"match": {

"channel": "feishu",

"accountId": "logistics-an"

}

},

{

"agent### 5.1 启用Agent间通信

在 `~/.openclaw/openclaw.json` 的 `tools` 部分添加：

  


```json

"tools": {

"profile": "coding",

"agentToAgent": {

"enabled": true,

"allow": [

"logistics-an",

"customer-service-pig",

"recruitment-assistant",

"kang-lian-jia-promoter",

"main"

]

}

}

5.2 创建通信协议文档

为每个Agent创建通信指南：


# 后勤小安的通信指南

cat > ~/.openclaw/agents/logistics-an/workspace/COMMUNICATION_GUIDE.md << 'EOF'

# 后勤小安 - 通信指南

  


"compaction": {

"mode": "safeguard"

},

"maxConcurrent": 4,

"subagents": {

"maxConcurrent": 8

}

},

"list": [

{

"id": "main",

"name": "唐吉可达鸭",

"workspace": "/root/.openclaw/workspace-main",

"agentDir": "/root/.openclaw/agents/main/agent",

"default": true

},

{

"id": "logistics-an",

"name": "后勤小安",

"workspace": "/root/.openclaw/agents/logistics-an/workspace",

"agentDir": "/root/.openclaw/agents/logistics-an/agent",

"model": "deepseek/deepseek-coder"

},

{

"id": "customer-service-pig",

"name": "客服小猪",

"workspace": "/root/.openclaw/agents/customer-service-pig/workspace",

"agentDir": "/root/.openclaw/agents/customer-service-pig/agent",

"model": "deepseek/deepseek-chat"

},

{

"id": "recruitment-assistant",

"name": "Boss招小助",

"workspace": "/root/.openclaw/agents/recruitment-assistant/workspace",

"agentDir": "/root/.openclaw/agents/recruitment-assistant/agent",

"model": "deepseek/deepseek-chat"

},

{

"id": "kang-lian-jia-promoter",

"name": "APP小推",

"workspace": "/root/.openclaw/agents/kang-lian-jia-promoter/workspace",

"agentDir": "/root/.openclaw/agents/kang-lian-jia-promoter/agent",

"model": "deepseek/deepseek-coder"

}

]

},

"tools": {

"profile": "coding",

"agentToAgent": {

"enabled": true,

"allow": [

"logistics-an",

"customer-service-pig",

"recruitment-assistant",

"kang-lian-jia-promoter",

"main"

]

}

},

"channels": {

"feishu": {

"accounts": {

"logistics-an": {

"appId": "cli_a9xxxxxxxxxxxxxx",

"appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

},

"customer-service-pig": {

"appId": "cli_a9xxxxxxxxxxxxxx",

"appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

},

"recruitment-assistant": {

"appId": "cli_a9xxxxxxxxxxxxxx",

"appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

},

"kang-lian-jia-promoter": {

"appId": "cli_a9xxxxxxxxxxxxxx",

"appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

}

}

}

},

"bindings": [

{

"agentId": "logistics-an",

"match": {

"channel": "feishu",

"accountId": "logistics-an"

}

},

{

"agentId": "customer-service-pig",

"match": {

"channel": "feishu",

"accountId": "customer-service-pig"

}

},

{

"agentId": "recruitment-assistant",

"match": {

"channel": "feishu",

"accountId": "recruitment-assistant"

}

},

{

"agentId": "kang-lian-jia-promoter",

"match": {

"channel": "feishu",

"accountId": "kang-lian-jia-promoter"

}

}

],

"messages": {

"ackReactionScope": "group-mentions"

},

"commands": {

"native": "auto",

"nativeSkills": "auto",

"restart": true,

"ownerDisplay": "raw"

},

"session": {

"dmScope": "per-channel-peer"

},

"gateway": {

"port": 18789,

"mode": "local",

"bind": "loopback",

"auth": {

"mode": "token",

"token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

}

},

"plugins": {

"entries": {}

}

}

6.2 各Agent的完整配置示例

后勤小安 (`logistics-an`)

1) Agent配置 (~/.openclaw/agents/logistics-an/agent/agent.json):


{

"id": "logistics-an",

"name": "后勤小安",

"description": "后勤专员，负责整理文件、自动定时生成图文视频内容",

"model": "deepseek/deepseek-coder",

"personality": "细心、有条理、高效，喜欢整理和规划",

"avatar": "avatars/logistics-an.png"

}

2) 飞书凭证 (~/.openclaw/agents/logistics-an/agent/auth-profiles.json):


{

"feishu": {

"logistics-an": {

"appId": "cli_a9xxxxxxxxxxxxxx", // 替换为你的实际App ID

"appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", // 替换为你的实际App Secret

"description": "后勤小安 - 飞书机器人"

}

}

}

3) 身份文件 (~/.openclaw/agents/logistics-an/workspace/IDENTITY.md):


# IDENTITY.md - 后勤小安

  


- **姓名：** 后勤小安

- **职位：** 后勤专员

- **性格：** 细心、有条理、高效、喜欢整理和规划

- **Emoji：** 📁📅🎬

- **职责：**

1. 文件整理和分类

2. 自动定时生成图文内容

3. 视频内容策划和生成

4. 工作流程优化

  


- **口号：** "有条不紊，高效后勤！"

7. 常见问题

Q1: 飞书机器人收不到消息怎么办？

检查步骤：

确认OpenClaw Gateway正在运行：openclaw gateway status
检查飞书应用权限是否配置正确
查看Gateway日志：openclaw logs --follow
确认网络连接正常

Q2: Agent间通信失败怎么办？

排查方法：

确认 agentToAgent.enabled 设置为 true
检查Agent ID是否在 allow 列表中
重启OpenClaw服务：openclaw gateway restart
查看会话日志确认消息路由

Q3: 如何添加新的Agent？

步骤：

创建Agent目录：mkdir -p ~/.openclaw/agents/<new-agent-id>/agent
创建配置文件（参考6.2节）
在 openclaw.json 的 agents.list 中添加新Agent
在飞书开放平台创建对应应用
更新 channels.feishu.accounts 和 bindings
重启服务

Q4: 如何备份配置？

备份命令：


# 备份整个配置目录

cp -r ~/.openclaw ~/.openclaw-backup-$(date +%Y%m%d)

  


# 备份关键配置文件

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup

Q5: 飞书事件与回调配置失败怎么办？

常见问题及解决方案：

问题1: 无法保存事件订阅配置

原因： OpenClaw配置不正确或Gateway未运行

解决：

检查Gateway状态：openclaw gateway status
确认飞书通道配置正确（App ID/Secret）
重启Gateway：openclaw gateway restart
查看日志：openclaw logs --follow 查看错误信息

问题2: 收不到飞书消息

原因： 事件权限未正确配置

解决：

确认已添加IM相关事件权限
检查是否选择了"长链接"方式
验证机器人是否被启用
测试单聊和群聊消息

问题3: 部分事件收不到

原因： 缺少对应的事件权限

解决：

检查事件权限列表，确保已添加：

im:message - 接收消息
im:message.group_at_msg:readonly - 群聊@消息
im:message.p2p_msg:readonly - 单聊消息
im:chat.members:bot_access - 进群事件

部分权限可能需要管理员审核

问题4: 连接显示成功但收不到消息

解决：

检查OpenClaw绑定配置是否正确
确认Agent ID与飞书账户ID匹配
测试发送消息，查看Gateway日志
检查网络连接和防火墙设置

Q6: 飞书插件相关问题

常见问题及解决方案：

问题1: 飞书插件未找到

解决：


# 检查飞书插件是否安装

find /www/server/nodejs/v22.22.0/lib/node_modules/openclaw -name "*feishu*" -type f

  


# 如果未找到，OpenClaw版本可能较旧

# 建议升级到最新版本：npm update -g openclaw

问题2: 如何确认飞书插件已启用

解决：

检查配置文件中的plugins部分
查看Gateway启动日志
测试飞书通道配置

问题3: 飞书插件支持哪些功能

功能列表：

✅ 长链接消息接收
✅ 多账户支持
✅ 事件订阅管理
✅ 消息发送和回复
✅ 群组管理
✅ 文件上传和下载

Q7: 如何监控系统状态？

监控命令：


# 查看Gateway状态

openclaw gateway status

  


# 查看实时日志

openclaw logs --follow

  


# 查看活跃会话

openclaw sessions list

  


# 查看Agent状态

openclaw agents list

  


# 查看飞书连接状态

# 在Gateway日志中搜索"feishu"相关日志

🎉 完成！

恭喜！你已经成功创建了一个完整的多Agent AI员工系统，并与飞书打通。现在你可以：

在飞书中与各个AI员工聊天
实现跨Agent的工作流协作
根据业务需求扩展更多Agent
定制每个Agent的专业技能

下一步建议：

为每个Agent配置专用技能（从ClawHub安装）
设置定时任务和自动化工作流
配置监控和告警系统
定期备份重要配置和数据

文档版本： v1.2

最后更新： 2026-03-12

更新内容：

添加飞书事件与回调配置详细说明
补充飞书插件安装和启用说明
增加飞书插件相关问题解答

作者： 唐吉可达鸭 🐥

适用OpenClaw版本： v0.14.0+

如有问题，欢迎在OpenClaw社区交流：discord.com/invite/claw…

OpenClaw 多Agent员工创建与飞书打通完整指南