如何配置飞书/钉钉等国内聊天平台？

配置OpenClaw连接飞书和钉钉等国内聊天平台，需要分别进行平台应用创建和OpenClaw配置。以下是详细的配置步骤。

飞书配置步骤

一、创建飞书应用

1. 访问飞书开放平台：https://open.feishu.cn/app
2. 点击”创建企业自建应用”，填写应用名称、描述等信息
3. 创建完成后，进入应用管理页面，在”凭证与基础信息”中获取并保存 App ID 和 App Secret

二、配置飞书应用权限

1. 进入”权限管理”页面，点击”批量导入”
2. 粘贴以下权限JSON配置：
   1. {
   2. "scopes": {
   3. "tenant": [
   4. "aily:file:read",
   5. "aily:file:write",
   6. "application:application.app_message_stats.overview:readonly",
   7. "application:application:self_manage",
   8. "application:bot.menu:write",
   9. "cardkit:card:write",
   10. "contact:user.employee_id:readonly",
   11. "corehr:file:download",
   12. "docs:document.content:read",
   13. "event:ip_list",
   14. "im:chat",
   15. "im:chat.access_event.bot_p2p_chat:read",
   16. "im:chat.members:bot_access",
   17. "im:message",
   18. "im:message.group_at_msg:readonly",
   19. "im:message.group_msg",
   20. "im:message.p2p_msg:readonly",
   21. "im:message:readonly",
   22. "im:message:send_as_bot",
   23. "im:resource",
   24. "sheets:spreadsheet",
   25. "wiki:wiki:readonly"
   26. ],
   27. "user": [
   28. "aily:file:read",
   29. "aily:file:write",
   30. "im:chat.access_event.bot_p2p_chat:read"
   31. ]
   32. }
   33. }

三、启用机器人能力

1. 进入”应用能力” → “机器人”
2. 开启机器人功能并设置机器人名称

四、配置事件订阅（关键步骤）

1. 进入”事件与回调” → “事件配置”
2. 必须选择”使用长连接接收事件(WebSocket)”
3. 添加事件：im.message.receive_v1（接收消息）
4. 注意：此步骤必须在OpenClaw网关启动后进行，否则保存会失败

五、发布应用

1. 进入”版本管理与发布”
2. 创建版本并提交发布
3. 等待企业管理员审批（企业自建应用通常可快速通过）

六、OpenClaw配置飞书

1. 安装飞书插件（如果未内置）：
   1. openclaw plugins install @openclaw/feishu

2. 配置飞书渠道：

   1. # 方法一：使用配置命令
   2. openclaw config set channels.feishu.appId "你的App ID"
   3. openclaw config set channels.feishu.appSecret "你的App Secret"
   4. openclaw config set channels.feishu.enabled true
   5. openclaw config set channels.feishu.connectionMode websocket
   6. openclaw config set channels.feishu.dmPolicy pairing
   7. openclaw config set channels.feishu.groupPolicy allowlist
   8. openclaw config set channels.feishu.requireMention true
   10. # 方法二：使用交互式配置
   11. openclaw channels add
   12. # 选择Feishu，然后按提示输入App ID和App Secret
3. 重启网关：
   1. openclaw gateway restart

七、配对授权

1. 在飞书中找到机器人并发送”你好”
2. 如果收到配对码，在终端执行：
   1. openclaw pairing approve feishu <配对码>
3. 批准后即可正常对话

钉钉配置步骤

一、创建钉钉应用

1. 访问钉钉开发者平台：https://open-dev.dingtalk.com
2. 点击”创建应用”，选择”机器人”类型
3. 填写应用信息，完成创建
4. 在”凭证与基础信息”中获取并保存 Client ID（AppKey）和 Client Secret（AppSecret）

二、配置钉钉应用权限

1. 进入”权限管理”页面
2. 开启以下关键权限：
   • Card.Instance.Write：创建和投放卡片实例
   • Card.Streaming.Write：对卡片进行流式更新
3. 保存权限配置

三、配置消息接收模式

1. 进入”消息接收”配置
2. 必须选择”Stream模式”（WebSocket长连接，无需公网IP）
3. 保存配置

四、发布应用

1. 进入”版本管理与发布”
2. 创建版本并发布应用

五、安装钉钉插件

1. openclaw plugins install @soimy/dingtalk

六、配置插件信任白名单

在 ~/.openclaw/openclaw.json 中添加：

1. {
2. "plugins": {
3. "enabled": true,
4. "allow": ["dingtalk"]
5. }
6. }

七、OpenClaw配置钉钉

1. 交互式配置（推荐）：

   1. openclaw onboard
   2. # 或
   3. openclaw configure --section channels

   按提示选择DingTalk，输入Client ID和Client Secret

2. 手动配置文件：
   在 ~/.openclaw/openclaw.json 的channels部分添加：

   1. "dingtalk": {
   2. "enabled": true,
   3. "clientId": "你的Client ID",
   4. "clientSecret": "你的Client Secret",
   5. "robotCode": "你的机器人代码",
   6. "corpId": "你的企业ID",
   7. "agentId": "你的应用ID",
   8. "dmPolicy": "open",
   9. "groupPolicy": "open",
   10. "messageType": "markdown"
   11. }

3. 重启网关：

   1. openclaw gateway restart

通用配置要点

版本要求

• OpenClaw版本：Linux/MacOS需要2026.2.26及以上；Windows需要2026.3.2及以上
• Node.js版本：必须使用Node.js 22或更高版本

连接验证

配置完成后，查看日志确认连接状态：

1. openclaw logs --follow

看到类似 feishu ws connected 或 dingtalk provider ready 表示连接成功

安全策略配置

• 私聊策略：pairing（需要配对）、open（开放）、allowlist（白名单）
• 群聊策略：allowlist（推荐）、open（开放）
• @提及要求：requireMention: true（仅响应@消息）

故障排查

1. 端口冲突：如果18789端口被占用，可更改OpenClaw端口
2. 长连接失败：确保OpenClaw网关已启动后再配置事件订阅
3. 权限不足：检查是否已发布应用版本
4. 配对失败：检查网络连接和凭证是否正确

多平台同时接入

OpenClaw支持同时接入多个平台，只需分别配置各平台的channel即可。

按照以上步骤，你可以成功将OpenClaw接入飞书和钉钉平台。配置过程中如遇到问题，可查看OpenClaw日志获取详细错误信息。

© 本文著作权归作者所有。转载请联系授权，禁止商用。

🔗 系列文章

1. openclaw能做什么？