OpenClaw接入飞书、钉钉实操步骤分享
最近需要用OpenClaw对接飞书和钉钉，实现AI助手在办公软件内的消息交互，踩了几个小坑，也整理出了一套能直接落地的操作步骤。全程都是实际操作过的流程，没有多余的理论，适合需要快速完成对接的朋友参考，新手也能跟着一步步做下来。
先跟大家说下前提准备，避免做一半卡壳：已经安装好OpenClaw（建议用2026.3.1及以上版本，对飞书、钉钉的兼容性更好），电脑安装Node.js 18+，同时拥有飞书、钉钉的企业账号，且账号有应用创建权限（没有的话，找公司管理员开通即可）。另外，不用准备公网IP，两款软件都支持长连接模式，内网环境也能正常使用。
一、OpenClaw接入飞书实操步骤
第一步：安装飞书插件
OpenClaw对接飞书需要单独安装对应插件，直接用命令行操作最便捷，不用手动找安装包。打开终端（Windows用CMD或PowerShell，Mac用终端），输入命令：openclaw plugins install @openclaw/feishu，等待安装完成即可。
安装后可以输入openclaw plugins list，查看插件是否成功显示，出现“feishu”字样就说明安装没问题。这里有个小提醒，如果你之前安装过旧版本插件，建议先输入openclaw plugins uninstall @openclaw/feishu卸载，再重新安装，避免版本冲突。
第二步：在飞书开放平台创建应用并配置
1. 打开浏览器，访问飞书开放平台（https://open.feishu.cn/app），用企业账号登录，点击“创建企业应用”，填写应用名称（比如“OpenClaw助手”）、描述，上传一个图标，点击“创建”。
2. 进入应用详情页，先获取凭证：左侧导航栏找到“凭证与基础信息”，复制里面的App ID（格式是cli_xxx）和App Secret，保存好，后面要用到，这两个信息相当于对接的“钥匙”，不要泄露。
3. 配置权限：左侧找到“权限管理”，点击“批量导入权限”，搜索并勾选三个关键权限：im:message（消息权限）、im:message:send_as_bot（机器人发消息权限）、im:chat（群聊权限），勾选后点击“保存”，完成权限配置。
4. 启用机器人能力：左侧点击“应用能力”，选择“机器人”，点击“启用”，设置机器人名称和描述，和之前创建的应用名称保持一致即可。
5. 配置事件订阅：在机器人设置页面，找到“事件订阅”，选择“使用长连接（WebSocket）”，添加im.message.receive_v1事件（这个事件是接收用户消息的关键），最后点击“版本管理与发布”，提交应用并等待企业管理员审批，审批通过后应用才能正常使用。
第三步：OpenClaw配置飞书渠道
推荐用交互式配置，新手操作起来更简单，不用手动修改配置文件。在终端输入命令：openclaw onboard，进入配置向导后，选择“channels”（渠道配置），再选择“Feishu（飞书）”。
按照提示依次输入之前保存的App ID和App Secret，然后设置私聊策略（默认是pairing，新用户需要配对才能聊天；如果想让企业内所有人都能私聊，可设置为open），群聊策略默认是open（群内@机器人即可触发回复），配置完成后，系统会自动保存并重启网关。
如果熟悉配置文件，也可以手动修改：找到OpenClaw的配置文件（路径是~/.openclaw/openclaw.json），在“channels”节点下添加飞书配置，填入App ID和App Secret，保存后输入openclaw gateway restart重启网关即可。
第四步：测试验证
1. 启动OpenClaw网关，输入命令：openclaw gateway，确保网关正常运行，没有报错。
2. 在飞书里搜索之前创建的机器人，发送一条测试消息（比如“你好”）。如果是默认的pairing策略，终端会出现一个配对码，输入命令openclaw pairing approve feishu 配对码，批准后就能收到机器人的回复。
3. 测试群聊：把机器人拉进飞书群，@机器人发送消息，能正常回复就说明对接成功。如果没收到回复，先检查网关是否运行，再核对App ID、App Secret是否填写正确，权限是否全部勾选。
二、OpenClaw接入钉钉实操步骤
第一步：安装钉钉插件
和飞书一样，先安装钉钉对应的插件，有三种安装方式，推荐用npm包安装，最省事。终端输入命令：openclaw plugins install @soimy/dingtalk，等待安装完成。
如果需要二次开发，可以用源码安装：先克隆仓库（git clone https://github.com/soimy/openclaw-channel-dingtalk.git），进入仓库目录，输入npm install安装依赖，再用openclaw plugins install -l .以链接模式安装，方便修改代码后实时生效。
安装后同样用openclaw plugins list验证，出现“dingtalk”字样即可。这里有个重要提醒：OpenClaw新版本有安全校验，非内置插件需要添加信任白名单，否则插件无法加载。
添加白名单的方法：找到配置文件~/.openclaw/openclaw.json，在“plugins”节点下添加"allow": ["dingtalk"]，如果还有其他插件，一并加入数组即可。修改后输入openclaw gateway restart，重启网关生效。
第二步：在钉钉开发者后台创建应用并配置
1. 访问钉钉开发者后台（https://open-dev.dingtalk.com/），登录企业账号，选择对应的开发组织，点击“应用开发”进入应用管理。
2. 创建企业内部应用：点击“创建应用”，选择“企业内部应用”，填写应用名称、描述、图标，点击“创建”。这里要注意，不要直接选择“机器人”入口，要先创建应用，再添加机器人能力，这是钉钉新版本的变化，避免找错入口。
3. 获取应用凭证：进入应用详情页，左侧找到“凭证与基础信息”，复制Client ID（也就是以前的AppKey）和Client Secret（以前的AppSecret），保存好，后续配置会用到。
4. 添加机器人能力：左侧点击“添加应用能力”，选择“机器人”，开启机器人配置，填写机器人名称、描述，消息接收模式选择“Stream模式”（无需公网IP，WebSocket长连接，适合内网部署），点击“发布”。
5. 配置权限：左侧找到“权限管理”，搜索“Card”相关权限，勾选“Card.Instance.Write”（创建卡片实例）和“Card.Streaming.Write”（流式更新卡片），这两个权限是实现AI互动卡片的关键，勾选后保存。
6. 可选配置：如果需要使用AI互动卡片，需要去钉钉卡片平台（https://card.dingtalk.com/）创建模板，选择“AI卡片”场景，设计排版后保存发布，复制模板ID和模板Key，后续在OpenClaw中配置即可。
第三步：OpenClaw配置钉钉渠道
同样推荐用交互式配置，终端输入openclaw configure --section channels，进入渠道配置后，选择“dingtalk（钉钉）”。
按照提示输入Client ID和Client Secret，可选配置Robot Code、Corp ID、Agent ID（推荐填写，提升兼容性），如果启用卡片模式，输入之前获取的Card Template ID和Card Template Key，然后设置私聊策略和群聊策略（open为开放，allowlist为白名单），配置完成后自动保存并重启网关。
手动配置的话，在openclaw.json的“channels”节点下添加钉钉配置，填入对应参数，保存后重启网关即可。
第四步：测试验证
1. 重启OpenClaw网关（openclaw gateway restart），确保网关正常运行。
2. 私聊测试：在钉钉里搜索创建的机器人，发送消息，能收到回复即说明私聊正常。
3. 群聊测试：把机器人拉进钉钉群，@机器人发送消息，测试是否能正常回复；如果启用了卡片模式，可发送一条需要AI实时输出的消息，查看卡片是否能流式更新。
如果测试失败，先检查插件是否加载（openclaw plugins list），再核对Client ID、Client Secret是否正确，权限是否勾选完整，Stream模式是否设置正确。
三、实操避坑提醒
1. 版本问题：OpenClaw版本过低会导致插件安装失败或对接异常，建议升级到2026.3.1及以上版本，升级命令：openclaw update。
2. 权限问题：飞书、钉钉的权限一定要勾选完整，少勾一个都可能导致无法接收或发送消息，配置完成后记得提交审批，未审批的应用无法使用。
3. 安全配置：飞书的App Secret、钉钉的Client Secret不要泄露，一旦泄露要及时在开放平台重置；OpenClaw的插件白名单一定要配置，否则插件无法加载。
4. 网关重启：每次修改配置或安装插件后，一定要重启OpenClaw网关，否则配置不会生效，很多新手都会忽略这一步。
5. 消息限流：飞书自定义机器人有频率限制（100次/分钟，5次/秒），钉钉也有类似限制，测试时不要频繁发送消息，避免被限流。
总结一下，OpenClaw接入飞书和钉钉的核心逻辑差不多，都是“安装插件-创建平台应用-配置权限-OpenClaw对接-测试验证”，只要跟着步骤走，注意避开上面的坑，基本都能一次对接成功。如果是第一次操作，建议先对接一个平台，熟悉流程后再对接另一个，效率会更高。