乐于分享
好东西不私藏

〖OpenClaw系列〗飞书与企业微信接入:从应用创建到审批集成与数据合规

〖OpenClaw系列〗飞书与企业微信接入:从应用创建到审批集成与数据合规

上篇回顾

第22篇 〖OpenClaw系列〗Slack 渠道接入:从 App 创建到 Block Kit 与工作流集成我们完成了 Slack 渠道接入:

  • Slack App 创建与 OAuth 权限配置
  • Socket Mode 与 HTTP Mode 对比
  • Block Kit 富消息格式
  • 斜杠命令与工作流集成
  • 多工作区管理与监控告警

本文转向国内主流平台——飞书(Feishu/Lark)和企业微信(WeCom),它们在国内企业市场占据主导地位。


前置条件

在开始飞书/企业微信接入之前,确保已具备以下条件:

条件
飞书
企业微信
OpenClaw 已部署
必需
必需
企业认证
企业自建应用需认证
企业需已完成认证
管理员权限
需要企业管理员或开发者权限
需要企业管理员权限
认证周期
1-3 个工作日
1-5 个工作日
服务器
国内服务器或代理
国内服务器或代理

如果你是个人开发者,建议先完成第22篇的 Slack 接入进行测试——Slack 不需要企业认证,3 分钟即可跑通。


国内 vs 海外企业平台选型

做国内项目的同学直接看这张表就够了。

维度
飞书
企业微信
Slack
结论
国内可用
原生可用
原生可用
需代理
国内选飞书/企微
用户基数
字节系+互联网公司
微信生态全覆盖
海外为主
传统行业选企微,互联网选飞书
审批/OA
原生审批流
原生审批+微信红包
需集成
需要OA选国内平台
开放能力
开放API完善
API较完善
最完善
二次开发 Slack 最强
消息格式
卡片消息(灵活)
图文消息(基础)
Block Kit(最灵活)
富交互选飞书/Slack
AI集成
原生AI助手
微信AI接口
Workflow Builder
飞书原生AI能力最强
部署要求
需企业认证
需企业认证
无需认证
个人开发者用Slack更方便
API 速率限制*
50次/秒(App级)
20000次/天(基础)
按Tier分级
高并发场景注意限制
消息体大小*
30KB(卡片)
2048字节(文本)
4000字符(Block Kit)
企微文本限制较严
文件上传限制*
30MB
20MB
1GB(付费)
大文件场景注意限制

*量化指标截至写作时,可能随平台版本更新变化,请以官方文档为准。

国内企业二选一建议:互联网/科技公司首选飞书(开放能力更强、卡片消息更灵活);传统企业/政企/覆盖微信生态选企业微信(用户基数大、与微信互通)。

先用一张图看清两大平台的核心差异——认证体系、消息格式、特色功能一目了然:


典型使用场景

场景一:飞书智能知识库

员工在飞书群 @Bot 提问 → Bot 搜索飞书文档/知识库 → 返回答案+来源链接 → 员工点击直接打开文档

配置要点:启用 tools: { doc: true, wiki: true },结合飞书文档权限,让 Bot 直接搜索和引用企业知识库。员工不再在多个文档间搜索,Bot 直接从知识库中找到答案并附上来源链接。

场景二:企业微信 IT 服务台

员工在企微向 Bot 发消息 → Bot 创建工单 → 通知对应部门 → 处理完成后关闭工单

配置要点:departments 限制特定部门访问,审批回调 approval 对接企业 OA 流程。适合传统企业的 IT 支持场景——员工无需离开企微即可完成报修、查询等操作。

场景三:双平台统一 AI 助手

飞书用户 @Bot → OpenClaw 路由到 feishu 渠道 → 统一 Agent 处理
企微用户 @Bot  → OpenClaw 路由到 wecom 渠道 → 同一 Agent 处理
→ 两个平台共享同一套 AI 能力和知识库

配置要点:飞书和企微同时 enabled: true,共用同一 agentId,实现双平台统一入口。跨团队协作时,无论员工用哪个平台都能获得一致的 AI 服务。


飞书(Feishu/Lark)接入:应用创建、权限配置与卡片消息

接下来以飞书为第一个国内平台,完整走一遍”创建应用 → 配置权限 → 获取凭证 → 事件订阅 → 验证接入”的流程——和第22篇 Slack 的节奏相似,核心差异在凭证体系。

飞书开放平台概述

飞书提供两套 API:

  • 国内版:open.feishu.cn
  • 国际版(Lark):open.larksuite.com

OpenClaw 的飞书扩展同时支持两个版本,配置方式相同。

创建飞书应用

步骤

1. 访问飞书开放平台(open.feishu.cn)
2. 登录后进入「开发者后台」
3. 点击「创建企业自建应用」
4. 填写应用名称(如:OpenClaw助手)
5. 选择应用类型:企业自建应用

配置权限

在「权限管理」中申请以下权限:

消息与群组

- im:chat:readonly# 获取群组信息
- im:message:send          # 发送消息
- im:message:send_as_bot   # 以 Bot 身份发送
- im:history:readonly# 读取消息历史

用户与组织

- contact:user.department:readonly# 获取用户部门信息
- contact:user.department_tree:readonly# 获取部门架构

文档与表格(可选)

- docx:document:readonly# 读取文档
- docx:document:write      # 编辑文档
- bitable:app:readonly# 读取多维表格

获取凭证

在「凭证与基础信息」页面:

1. 复制 App ID(如:cli_xxxxxxxx)
2. 复制 App Secret(点击显示)
3. 进入「事件订阅」,获取 Encrypt Key 和 Verification Token

凭证角色

  • App ID:应用身份证,标识”你是谁”——类似工号
  • App Secret:应用密码,证明”你真的是谁”——类似工号对应的密码,绝不公开
  • Encrypt Key:事件加密钥匙,确保收到的消息没有被篡改——类似银行U盾
  • Verification Token:验证令牌,向飞书证明”这个URL确实是你的”——类似快递取件码

把这 4 步做成流程卡——和 Slack 的节奏相似,核心差异在凭证体系:

OpenClaw 飞书配置

{
  channels: {
    feishu: {
      enabled: true,

      // ========== 认证配置 ==========
      appId: "${FEISHU_APP_ID}",           // cli_xxx
      appSecret: "${FEISHU_APP_SECRET}",   // 应用密钥
      encryptKey: "${FEISHU_ENCRYPT_KEY}", // 事件订阅加密密钥
      verificationToken: "${FEISHU_VERIFICATION_TOKEN}",

      // ========== 基础策略 ==========
      dmPolicy: "allowlist",
      allowFrom: ["ou_xxxxxxxxxxxxxxxx"],     // 飞书用户 Open ID

      // ========== 群组配置 ==========
      groupPolicy: "allowlist",
      groupAllowFrom: ["oc_xxxxxxxxxxxxxxxx"],  // 群组 ID

      // ========== 消息处理 ==========
      historyLimit: 50,

      // ========== 功能开关 ==========
      actions: {
        reactions: true,          // 表情回应
        messages: true,           // 发送消息
        cards: true               // 发送卡片消息
      },

      // ========== 文档工具(可选)==========
      tools: {
        doc: true,                // 飞书文档
        bitable: true,           // 多维表格
        wiki: true               // 知识库
      }
    }
  }
}

跨平台差异:飞书的 allowFrom 使用 Open ID(ou_xxx 格式),与 Slack 的用户ID(Uxxx 格式)和企微的用户名格式不同。获取方式参见 FAQ Q2。

事件订阅配置

在飞书后台「事件订阅」页面:

1. 设置 Request URL: https://your-domain.com/feishu/events
2. 订阅以下事件:
   - im.message.receive_v1      # 接收消息
   - im.message.reaction.created_v1  # 表情回应
   - im.chat.disbanded_v1       # 群组解散

验证飞书接入

配置完成后,立即验证连接是否正常:

# 1. 检查连接状态
openclaw channels status --channel feishu

# 预期输出
# Channel: feishu
# Status: connected
# App: OpenClaw助手
# Mode: event
# Tenant: 你的企业名称

# 2. 查看实时日志
openclaw channels logs --channel feishu

# 预期输出
# [INFO] Feishu event subscription verified
# [INFO] Bot online as: OpenClaw助手

# 3. 在飞书中测试
# - 在飞书搜索栏搜索你的应用名称
# - 打开应用对话框,发送"你好"
# - 应收到 Bot 回复

如果 openclaw channels status --channel feishu 显示 disconnected,参考下方”踩坑”章节排查。

飞书特有的富交互

飞书支持卡片消息(Card),OpenClaw 自动将 AI 回复转换为卡片格式:

{
  channels: {
    feishu: {
      // 启用卡片消息
      cardMessage: {
        enabled: true,
        template: "blue"          // blue | green | red | orange
      }
    }
  }
}

卡片消息特性:

  • 标题和副标题
  • 多列布局
  • 按钮和操作
  • 图片和图标
  • @提及用户

飞书卡片消息在用户侧呈现效果:

┌─────────────────────────────────────────┐
│ 🔵 OpenClaw 助手                        │  ← 卡片头部(主题色)
│ ─────────────────────────────────────── │
│ 代码审查结果:                           │  ← 标题
│                                         │
│ ✅ 规范检查    🟡 性能建议    ❌ 安全问题 │  ← 多列布局
│ 3项通过       2项建议       1项需修复    │
│                                         │
│ [查看详情]  [一键修复]  [忽略]           │  ← 按钮操作
│                                         │
│ 📎 来源:PR #42 · main分支 · 3个文件    │  ← 上下文信息
└─────────────────────────────────────────┘

与 Slack Block Kit 对比:飞书卡片和 Slack Block Kit 都支持按钮、多列、图片等交互组件。主要差异:飞书卡片支持主题色(blue/green/red/orange),Block Kit 不限制颜色;飞书卡片的布局由模版控制,Block Kit 的布局由 Block 顺序决定;飞书卡片按钮交互需配置回调地址,Block Kit 按钮交互走 Slack 的交互事件流。


企业微信(WeCom)接入:自建应用开发与消息加解密

飞书配置完成后,来看企业微信——流程相似,但凭证体系(CorpID + AgentID + Secret)和消息加解密方式不同。

企业微信开发概述

企业微信提供两种集成方式:

  • 自建应用:企业内部开发,功能完整
  • 第三方应用:上架应用市场,供其他企业使用

OpenClaw 使用自建应用方式接入。

创建企业微信应用

步骤

1. 登录企业微信管理后台(work.weixin.qq.com)
2. 进入「应用管理」
3. 点击「创建应用」
4. 上传应用图标,填写应用名称
5. 选择可见成员(哪些员工可以使用)

获取凭证

在应用详情页:

1. 复制 AgentId(如:1000002)
2. 查看 Secret(点击发送给管理员)
3. 进入「我的企业」页面,复制企业ID(CorpID)

凭证角色

  • CorpID:企业唯一标识——类似公司的统一社会信用代码
  • AgentId:应用ID,企业内区分不同应用——类似公司内不同部门的分机号
  • Secret:应用密钥——类似部门分机号的密码
  • Token + EncodingAESKey:消息加解密对——Token 验证来源(类似信封上的火漆印),AES Key 加密内容(类似信件内容加密)

配置接收消息

在应用详情页「接收消息」:

1. 设置 URL: https://your-domain.com/wecom/events
2. 设置 Token(随机生成)
3. 设置 EncodingAESKey(随机生成)
4. 选择消息加解密方式:
   - 明文模式(开发测试)
   - 兼容模式
   - 安全模式(推荐生产环境)

OpenClaw 企业微信配置

{
  channels: {
    wecom: {
      enabled: true,

      // ========== 认证配置 ==========
      corpId: "${WECOM_CORP_ID}",           // 企业ID
      agentId: "${WECOM_AGENT_ID}",         // 应用ID
      secret: "${WECOM_SECRET}",            // 应用密钥
      token: "${WECOM_TOKEN}",              // 接收消息Token
      encodingAesKey: "${WECOM_AES_KEY}",   // 消息加密密钥

      // ========== 基础策略 ==========
      dmPolicy: "allowlist",
      allowFrom: ["ZhangSan"],              // 企业微信用户名

      // ========== 部门限制(可选)==========
      departments: [1, 2],                  // 仅允许特定部门

      // ========== 消息处理 ==========
      historyLimit: 50,
      textChunkLimit: 2048,                 // 企业微信限制

      // ========== 功能开关 ==========
      actions: {
        messages: true,
        media: true,                        // 图片/文件
        markdown: true                      // Markdown消息
      }
    }
  }
}

跨平台差异:企微的 allowFrom 使用用户名(如 "ZhangSan"),与飞书的 Open ID(ou_xxx)和 Slack 的用户ID(Uxxx)格式均不同。此外,企微特有的 textChunkLimit: 2048 限制单条消息最大长度——超出会自动分段发送,这是与飞书/Slack 的重要差异。

验证企业微信接入

配置完成后,验证连接是否正常:

# 1. 检查连接状态
openclaw channels status --channel wecom

# 预期输出
# Channel: wecom
# Status: connected
# Corp: 你的企业名称
# Agent: OpenClaw助手

# 2. 查看实时日志
openclaw channels logs --channel wecom

# 预期输出
# [INFO] WeCom callback verified
# [INFO] Bot online as: OpenClaw助手

# 3. 在企业微信中测试
# - 在工作台找到你的应用
# - 打开应用,发送"你好"
# - 应收到 Bot 回复

如果验证失败,参考下方”踩坑”章节排查。

企业微信消息格式

企业微信支持的消息类型:

类型
说明
OpenClaw支持
文本
纯文本消息
Markdown
富文本
图片
图片消息
图文
图文卡片
文件
文件上传
语音
语音消息
✅ 接收

OpenClaw 自动处理:文本和 Markdown 消息由 Agent 直接处理;图片和文件通过 media 功能自动上传/下载;语音消息自动转写为文本后处理(需启用语音转写功能)。textChunkLimit: 2048 限制单条消息最大长度,超出自动分段发送。


国内平台特殊考虑:网络、备案与数据合规

飞书和企微都配好了,但国内平台有几件事必须在上线前想清楚——网络、备案、数据合规,漏掉任何一项都可能导致服务中断。

网络环境

问题:国内平台 API 可能存在网络限制

解决

{
  channels: {
    feishu: {
      // 配置代理(如需要)
      proxy: "http://proxy.company.com:8080"
    },
    wecom: {
      proxy: "http://proxy.company.com:8080"
    }
  }
}

连接模式选择

考虑因素
长连接/WebSocket
回调URL/Webhook
公网IP
不需要(飞书/企微主动推送到客户端)
需要(飞书/企微推送事件到你的服务器)
备案要求
无需域名备案
需要ICP备案
部署复杂度
低(无需配置公网)
中(需配置HTTPS和域名)
可扩展性
受限于单连接
可横向扩展
建议场景
开发测试、内网部署
生产环境、高可用

建议:开发阶段使用长连接模式快速跑通,生产环境切换到回调 URL 模式以获得更好的可观测性和扩展性。回调 URL 模式需完成域名 ICP 备案。

备案要求

如果使用 HTTP Mode(Webhook),需要:

  • 域名已备案(ICP备案)
  • 服务器位于国内或使用 CDN

建议:使用长连接模式或轮询避免备案问题。

数据合规

企业微信和飞书都有数据出境限制:

  • 用户数据不能存储在境外服务器
  • 消息内容需要本地化处理

合规要点

  • 《个人信息保护法》要求:处理个人信息需取得用户同意,OpenClaw 的 allowFrom 白名单机制可作为授权依据
  • 《数据安全法》要求:重要数据需在境内存储,OpenClaw 建议部署在国内服务器
  • 《网络安全法》要求:网络运营者需留存网络日志不少于6个月

OpenClaw 建议部署

  • 企业自有服务器
  • 私有云环境
  • 确保数据不出境

这 3 个合规关注点是国内平台和海外平台的最大差异——提前规划能省很多弯路:

国内平台 3 大关注点:网络环境 / 备案要求 / 数据合规

组织架构同步:飞书部门映射与企业微信部门限制

飞书组织架构

OpenClaw 可以读取飞书部门架构:

{
  channels: {
    feishu: {
      // 启用组织架构同步
      directorySync: {
        enabled: true,
        intervalHours: 24,        // 每天同步一次

        // 部门映射
        departmentMapping: {
          "0": "root",            // 根部门
          "12345": "engineering", // 工程部
          "12346": "sales"        // 销售部
        }
      }
    }
  }
}

组织架构同步后,allowFrom 可直接使用部门名称而非 Open ID,简化权限管理。

企业微信部门限制

限制 Bot 仅响应特定部门:

{
  channels: {
    wecom: {
      // 仅允许特定部门访问
      departments: [1, 2, 3],       // 部门ID列表

      // 或按标签
      tags: [1, 2]                 // 标签ID
    }
  }
}

跨平台差异:飞书通过 directorySync 主动同步组织架构并映射到逻辑名称;企微通过 departments 和 tags 做访问控制,无需主动同步。两种方式各有所长——飞书适合需要按组织架构动态调整权限的场景,企微适合部门结构相对固定的场景。


审批流程集成:飞书审批回调与企业微信审批模板

飞书审批

将 OpenClaw 集成到飞书审批流程:

{
  channels: {
    feishu: {
      // 审批回调配置
      approval: {
        enabled: true,
        // 审批通过后通知 Bot
        callbackUrl: "/feishu/approval",

        // 支持的审批类型
        types: ["leave", "expense", "purchase"]
      }
    }
  }
}

审批类型与 Bot 角色

审批类型
说明
Bot 角色
leave
请假审批
评估请假合理性、查询剩余假期
expense
报销审批
校验报销金额、核对发票信息
purchase
采购审批
查询历史价格、评估采购合理性

Bot 在审批流程中的角色是辅助评估——收到审批回调后,根据上下文信息给出建议(如”该员工本月已请假3天””此项采购价格高于历史均价15%”),最终审批决定仍由审批人做出。

企业微信审批

{
  channels: {
    wecom: {
      approval: {
        enabled: true,
        templateIds: ["3Tka43eF6oH6sVf70y6MF7s2sZxvi2h9"]
      }
    }
  }
}

templateIds 对应企微管理后台创建的审批模板ID。可在「企业微信管理后台 → 应用管理 → 审批」中查看。每个模板ID对应一种审批流程,Bot 会在审批提交时收到回调,可根据审批内容给出建议。


连接健康检查与监控

检查连接状态

# 检查飞书连接状态
openclaw channels status --channel feishu

# 检查企业微信连接状态
openclaw channels status --channel wecom

# 预期输出示例(飞书)
# Channel: feishu
# Status: connected
# App: OpenClaw助手
# Mode: event
# Uptime: 2d 8h 30m

Token 刷新机制

飞书和企微的 access_token 有效期均为 2 小时,OpenClaw 自动处理刷新:

{
  channels: {
    feishu: {
      // Token 自动刷新(默认开启)
      tokenRefresh: {
        enabled: true,
        bufferMinutes: 5          // 提前5分钟刷新
      }
    },
    wecom: {
      tokenRefresh: {
        enabled: true,
        bufferMinutes: 5
      }
    }
  }
}

多实例部署注意:多实例部署时,Token 缓存需共享(建议使用 Redis),避免多个实例同时刷新导致 Token 竞争。

监控集成

搭配 Prometheus + Grafana 实现飞书/企微 Bot 状态看板:

指标
说明
告警建议
feishu_connection_status
飞书连接状态(1=在线, 0=离线)
离线超过 2 分钟告警
wecom_connection_status
企微连接状态
离线超过 2 分钟告警
feishu_token_refresh_errors
飞书 Token 刷新失败次数
> 3 次/小时告警
wecom_token_refresh_errors
企微 Token 刷新失败次数
> 3 次/小时告警
feishu_message_latency_ms
飞书消息处理延迟
> 3000ms 告警
wecom_message_latency_ms
企微消息处理延迟
> 3000ms 告警

踩坑

坑1:飞书事件订阅验证失败

现象:配置事件订阅后,验证 URL 失败

排查(参见上方「事件订阅配置」章节确认配置是否一致):

# 1. 检查 URL 可访问性
curl https://your-domain.com/feishu/events

# 2. 检查 Encrypt Key 是否正确
# 3. 查看 OpenClaw 日志
openclaw channels logs --channel feishu

解决

{
  channels: {
    feishu: {
      // 确保以下三个值与飞书后台一致
      appId: "cli_xxx",
      encryptKey: "xxx",
      verificationToken: "xxx"
    }
  }
}

坑2:企业微信消息加解密失败

现象:收到消息但无法解析

原因:EncodingAESKey 不匹配或加密模式错误(参见上方「配置接收消息」章节确认 Token 和 AES Key 与后台一致)

解决

{
  channels: {
    wecom: {
      // 与后台设置的 AES Key 完全一致
      encodingAesKey: "${WECOM_AES_KEY}",

      // 如果后台使用明文模式,设置为 false
      messageEncryption: true
    }
  }
}

坑3:飞书文档工具权限不足

现象:无法读取或编辑飞书文档

原因:权限申请未通过或用户未授权

解决

  1. 检查权限管理中的申请状态:
    • 进入飞书开放平台 → 应用 → 权限管理
    • 确认以下权限已申请且已通过:docx:document:readonlybitable:app:readonly
  2. 确保用户已授权应用访问文档
  3. 文档需要分享给应用或设置为组织内可见
# 检查 Bot 是否有文档访问权限
openclaw channels logs --channel feishu | grep "permission"
# 输出示例:
# [WARN] feishu: doc access denied, missing scope: docx:document:readonly

坑4:企业微信部门ID获取困难

现象:不知道部门ID是什么

解决

# 开启调试模式查看
openclaw channels logs --channel feishu --json

# 或使用企业微信 API 查询
curl "https://qyapi.weixin.qq.com/cgi-bin/department/list?access_token=TOKEN"

坑5:飞书 Bot 消息发不出去

现象:Bot 收到消息但无法回复

排查

# 1. 检查消息发送权限
openclaw channels logs --channel feishu | grep "send"

# 2. 检查常见原因:
#    - 缺少 im:message:send 权限
#    - Bot 未被添加到目标群组
#    - 消息体超过 30KB 限制
#    - 速率限制触发(50次/秒)

# 3. 检查 Bot 是否在群组中
openclaw channels status --channel feishu

解决:确保 im:message:send 权限已申请并通过,且 Bot 已被添加到目标群组。

坑6:企业微信 access_token 过期

现象:运行一段时间后,API 调用返回 access_token expired

原因:企微 access_token 有效期 2 小时,未自动刷新或刷新失败

解决

{
  channels: {
    wecom: {
      // 确保自动刷新已开启
      tokenRefresh: {
        enabled: true,
        bufferMinutes: 5          // 提前5分钟刷新
      }
    }
  }
}
# 查看刷新状态
openclaw channels logs --channel wecom | grep "token"
# 预期输出:
# [INFO] wecom: token refreshed, expires_in: 7200

与 Slack 配置对比

从第22篇迁移过来的读者,这张表帮你快速理解飞书/企微与 Slack 的配置差异:

配置项
Slack
飞书
企业微信
凭证数量
2-3个(xoxb- + xapp- + Signing Secret)
4个(AppID + Secret + EncryptKey + Token)
5个(CorpID + AgentID + Secret + Token + AESKey)
认证方式
OAuth Token
App ID + Secret 换 Token
CorpID + Secret 换 Token
allowFrom 值
用户ID(Uxxx
Open ID(ou_xxx
用户名(ZhangSan
群组标识
频道ID(Cxxx
群组ID(oc_xxx
部门ID(数字)
消息格式
Block Kit(7种组件)
卡片消息(4种主题色)
Markdown/图文(基础)
消息体限制
4000字符
30KB(卡片)
2048字节(文本)
连接模式
Socket Mode / HTTP Mode
长连接 / Webhook
回调URL / 轮询
企业认证
不需要
需要
需要
国内可用
需代理
原生
原生

迁移提示:如果你已有 Slack 配置,迁移到飞书/企微时,dmPolicyallowFromactions 等策略字段含义不变,只需适配凭证格式和标识符格式即可。


FAQ

Q1: 飞书国际版(Lark)和国内版配置有区别吗?

基本无区别,OpenClaw 使用相同的配置格式:

{
  channels: {
    feishu: {
      // 国内版
      baseUrl: "https://open.feishu.cn",     // 默认

      // 国际版
      baseUrl: "https://open.larksuite.com"
    }
  }
}

Q2: 如何获取飞书用户的 Open ID?

方法1:查看日志

openclaw channels logs --channel feishu | grep "sender"
# 输出: sender: "ou_xxxxxxxxxxxxxxxx"

方法2:飞书管理后台 → 组织架构 → 用户详情

方法3:使用飞书 API 查询

# 通过手机号或邮箱查询用户 Open ID
curl -H "Authorization: Bearer ACCESS_TOKEN" \
"https://open.feishu.cn/open-apis/contact/v3/users/by_mobile?mobile=+8613800138000"

Q3: 企业微信和飞书可以同时使用吗?

可以,配置多个渠道:

{
  channels: {
    feishu: {
      enabled: true,
      appId: "cli_xxx",
      // ...
    },
    wecom: {
      enabled: true,
      corpId: "wx_xxx",
      // ...
    }
  }
}

两个平台同时接入的架构长这样——各走各的渠道,互不干扰:

Q4: 国内平台需要特殊的服务器部署吗?

建议

  • 服务器位于国内(阿里云、腾讯云等)
  • 域名完成 ICP 备案
  • 如果使用 Webhook 模式,确保网络可达

可选:使用长连接模式或轮询避免公网暴露。

Q5: 飞书 Bot 消息发不出去怎么排查?

排查步骤

  1. 检查 Bot 是否有 im:message:send 权限——在飞书开放平台「权限管理」中确认
  2. 检查 Bot 是否已被添加到目标群组——在群设置中确认
  3. 检查消息体是否超过 30KB 限制——飞书卡片消息有大小限制
  4. 查看日志:openclaw channels logs --channel feishu | grep "send\|error"
  5. 检查速率限制——飞书 API 限制 50 次/秒(App 级别)

Q6: 企业微信 access_token 过期怎么办?

OpenClaw 默认自动刷新 access_token(有效期 2 小时),但如果刷新失败:

# 查看刷新状态
openclaw channels logs --channel wecom | grep "token"

# 常见刷新失败原因:
# 1. Secret 配置错误——检查 WECOM_SECRET 是否正确
# 2. IP 白名单未配置——在企微后台添加服务器 IP
# 3. 网络不通——检查服务器能否访问 qyapi.weixin.qq.com
{
  channels: {
    wecom: {
      tokenRefresh: {
        enabled: true,
        bufferMinutes: 5
      }
    }
  }
}

5 分钟双平台快速配置清单

# 1. 创建飞书应用(open.feishu.cn → 开发者后台 → 创建企业自建应用)
#    获取 App ID + App Secret + Encrypt Key + Verification Token

# 2. 创建企微应用(work.weixin.qq.com → 应用管理 → 创建应用)
#    获取 CorpID + AgentId + Secret + Token + EncodingAESKey

# 3. 写入双平台配置
openclaw config patch <<EOF
{
  channels: {
    feishu: {
      enabled: true,
      appId: "\${FEISHU_APP_ID}",
      appSecret: "\${FEISHU_APP_SECRET}",
      encryptKey: "\${FEISHU_ENCRYPT_KEY}",
      verificationToken: "\${FEISHU_VERIFICATION_TOKEN}",
      dmPolicy: "allowlist",
      allowFrom: []
    },
    wecom: {
      enabled: true,
      corpId: "\${WECOM_CORP_ID}",
      agentId: "\${WECOM_AGENT_ID}",
      secret: "\${WECOM_SECRET}",
      token: "\${WECOM_TOKEN}",
      encodingAesKey: "\${WECOM_AES_KEY}",
      dmPolicy: "allowlist",
      allowFrom: []
    }
  }
}
EOF

# 4. 验证配置
openclaw config validate

# 5. 启动 Gateway 并验证连接
openclaw gateway run
openclaw channels status --channel feishu
openclaw channels status --channel wecom

这 5 步约 5 分钟即可跑通飞书+企微双平台 Bot。生产环境请补充企业认证、白名单、心跳监控和国内服务器部署。


总结

本文详细讲解了飞书和企业微信渠道接入:

能力
飞书
企业微信
应用创建
开放平台 → 企业自建应用
管理后台 → 应用管理
认证方式
App ID + Secret(4个凭证)
CorpID + AgentID + Secret(5个凭证)
消息加密
Encrypt Key
Token + AES Key
特色功能
文档/表格/知识库
部门架构/标签
审批集成
审批回调(3种类型)
审批模板
连接模式
长连接 / Webhook
回调URL / 轮询
国内可用
原生可用
原生可用

关键认知

  • 国内平台需要考虑网络、备案、数据合规——《个人信息保护法》《数据安全法》《网络安全法》是三大法规基线
  • 飞书的文档协作功能更强大(支持文档/多维表格/知识库三级工具链)
  • 企业微信的部门组织架构更适合传统企业(与微信生态互通)
  • 飞书凭证4个(App ID/Secret/Encrypt Key/Token),企微凭证5个(CorpID/AgentID/Secret/Token/AESKey),比 Slack 多且更复杂——配置时务必逐一核对

下一篇预告

第24篇:Signal/iMessage/Matrix 接入

从国内企业平台转向隐私优先的通信平台:

  • signald 部署与 Signal 号码注册
  • BlueBubbles 方案接入 iMessage
  • Matrix Synapse 自托管与端到端加密
  • 桥接其他通信平台的联邦架构

本文是系列第23篇。你的 AI 助手已接入国内主流企业协作平台。


📌 觉得有用?点个「在看」 👇 👨‍💻 关注「敏叔侃技术」,每周更新 OpenClaw 实战干货 ⭐ 收藏这篇文章,作为飞书/企业微信接入的参考手册,与第22篇 Slack 接入配合使用