OpenClaw 接入微信/飞书/钉钉完整教程

概述

OpenClaw 支持通过 API 接口接入国内主流 IM 平台。本文将详细讲解微信公众号、飞书机器人和钉钉机器人三大平台的接入方法。

方案对比

平台	接入难度	消息延迟	群聊支持	适合场景
微信公众号	⭐⭐⭐	较高	❌	对外服务、客服
飞书机器人	⭐⭐	低	✅	团队协作、企业内部
钉钉机器人	⭐⭐	低	✅	企业内部、项目管理
企业微信	⭐⭐⭐	中等	✅	企业客户服务

一、微信公众号接入

1.1 前置条件

已认证的微信公众号（服务号推荐）
一台可公网访问的服务器（已部署 OpenClaw）
域名（已备案）

1.2 配置微信公众号后台

登录微信公众平台
进入「设置与开发」→「基本配置」
获取 AppID 和 AppSecret
配置服务器地址（URL）、Token 和 EncodingAESKey

1.3 配置 OpenClaw 微信网关

在 OpenClaw 配置文件中添加微信渠道：

channels:
  wechat:
    enabled: true
    app_id: "your_app_id"
    app_secret: "your_app_secret"
    token: "your_token"
    encoding_aes_key: "your_encoding_aes_key"
    reply_mode: "async"  # 异步回复，避免 5 秒超时

1.4 处理 5 秒超时问题

微信公众号要求 5 秒内回复，而 AI 生成通常需要更长时间。解决方案：

# 方案一：客服消息接口（推荐）
channels:
  wechat:
    reply_mode: "customer_service"
    # 先回复"思考中..."，AI 生成完毕后通过客服消息接口发送

# 方案二：异步回复
channels:
  wechat:
    reply_mode: "async"
    placeholder_message: "正在思考中，请稍候..."

1.5 验证接入

发送消息到公众号，确认 OpenClaw 能正常回复。

二、飞书机器人接入

2.1 创建飞书应用

访问飞书开放平台
创建企业自建应用
获取 App ID 和 App Secret
在「权限管理」中开启以下权限：
- im:message — 获取与发送消息
- im:message.group_at_msg — 群聊 @消息
- im:chat — 获取群信息

2.2 配置事件订阅

在应用后台进入「事件订阅」
配置请求地址：https://your-domain.com/api/feishu/webhook
添加事件：im.message.receive_v1

2.3 配置 OpenClaw

channels:
  feishu:
    enabled: true
    app_id: "cli_your_app_id"
    app_secret: "your_app_secret"
    verification_token: "your_verification_token"
    encrypt_key: "your_encrypt_key"  # 可选

2.4 群聊使用

飞书机器人支持群聊模式：

在群聊中 @机器人发送消息
机器人自动识别并回复
支持多轮对话上下文

三、钉钉机器人接入

3.1 创建钉钉应用

访问钉钉开放平台
创建企业内部应用
获取 AppKey 和 AppSecret
在「机器人与消息推送」中启用机器人

3.2 配置消息接收

配置消息接收地址：https://your-domain.com/api/dingtalk/webhook
配置出口 IP 白名单

3.3 配置 OpenClaw

channels:
  dingtalk:
    enabled: true
    app_key: "your_app_key"
    app_secret: "your_app_secret"
    robot_code: "your_robot_code"

3.4 群聊机器人

钉钉支持两种机器人模式：

模式	说明	适用场景
单聊	用户直接与机器人对话	个人助手
群聊	在群中 @机器人触发	团队协作

四、多平台统一管理

4.1 统一配置

OpenClaw 支持同时接入多个平台：

channels:
  wechat:
    enabled: true
    # ... 微信配置
  feishu:
    enabled: true
    # ... 飞书配置
  dingtalk:
    enabled: true
    # ... 钉钉配置

# 所有渠道共享同一个 AI 模型配置
model:
  provider: "deepseek"
  model: "deepseek-chat"
  api_key: "your_api_key"

4.2 会话隔离

不同平台的会话自动隔离，用户在微信的对话不会混入飞书的上下文。

常见问题

Q: 微信公众号接入后消息延迟很大？

A: 使用客服消息接口模式（reply_mode: "customer_service"），先回复提示消息，AI 生成完毕后再推送完整回复。

Q: 飞书机器人在群聊中不响应？

A: 检查是否开启了群聊权限（im:message.group_at_msg），并确认在群中 @了机器人。

Q: 钉钉机器人收不到消息？

A: 确认出口 IP 白名单配置正确，且消息接收地址可公网访问。

Q: 可以同时接入多个微信公众号吗？

A: 可以，在配置中使用数组格式定义多个微信渠道。