AI助理部署完了怎么接入钉钉/飞书?手把手教你5分钟搞定
上期我们部署了CoPaw个人AI助理,但只能在浏览器里用。今天教你把它接入钉钉和飞书,从此在聊天软件里就能直接对话你的专属AI——上班摸鱼、团队协作两不误!
一、为什么要接入钉钉/飞书?
CoPaw支持钉钉、飞书、QQ、Discord、iMessage等多种通讯平台,一个AI助理可以按需连接所有频道。接入之后:
- 不用打开浏览器:在钉钉/飞书群里@机器人就能对话
- 团队共享:整个群的人都能用,适合协作场景
- 随时随地:手机电脑都能发消息,AI随时响应
CoPaw支持在控制台的“Control→Channels”页面一键配置各频道。下面分别教你怎么配。

二、接入钉钉(约5分钟)
Step 1:创建钉钉企业内部应用
1. 打开钉钉开放平台(`open.dingtalk.com`),用钉钉扫码登录
2. 进入“应用开发 → 企业内部应用 → 钉钉应用”,点击“创建应用”
3. 填写应用名称(比如“我的AI助理”),选择所属部门,点击保存
Step 2:添加机器人能力
1. 进入刚创建的应用详情页
2. 点击“添加应用能力”,选择“机器人”
3. 配置机器人信息:
- 机器人名称:随便写,比如“AI小助手”
- 消息接收模式:选择 Stream模式(流式接收)
4. 点击发布
Step 3:获取凭证
在应用详情页的“凭证与基础信息”中,复制两个关键值:
- Client ID(即AppKey)
- Client Secret(即AppSecret)
> ⚠️ 注意:这两个值相当于机器人的账号密码,不要泄露给任何人。
Step 4:CoPaw中配置钉钉频道
1. 浏览器打开CoPaw控制台(`http://你的服务器IP:8088`)
2. 点击左侧菜单“Control → Channels”
3. 找到 DingTalk 卡片,点击进入
4. 打开 Enable 开关
5. 填入刚才复制的 Client ID 和 Client Secret
6. 点击 Save 保存,几秒内自动生效
Step 5:添加到群聊
1. 在钉钉中打开你要使用AI的目标工作群
2. 点击群设置 → 机器人 → 添加机器人
3. 选择你刚创建的那个机器人
4. 在群里@机器人就能开始对话了
三、接入飞书(约5分钟)
Step 1:创建飞书企业自建应用
1. 打开飞书开放平台(`open.feishu.cn`),用飞书扫码登录
2. 点击“创建企业自建应用”
3. 填写应用名称和描述,上传图标,点击创建
Step 2:获取凭证
1. 进入应用详情页
2. 在“凭证与基础信息”中获取:
- App ID
- App Secret
Step 3:配置机器人权限
1. 在应用详情页点击“权限管理”
2. 添加以下权限(至少需要):
- im:message(接收与发送消息)

- im:message.group_at_msg(接收群聊中@机器人的消息)
- im:message.p2p_msg(接收单聊消息)
3. 点击“批量开通”
小提示:如果权限不够,配置完机器人可能收不到消息。建议一次性把消息相关的权限都开了。
Step 4:CoPaw中配置飞书频道
1. 回到CoPaw控制台(`http://你的服务器IP:8088`)
2. 点击“Control → Channels”
3. 找到 Feishu/Lark 卡片
4. 打开 Enable 开关
5. 填入 App ID 和 App Secret
6. 点击 Save 保存
Step 5:使用飞书机器人
配置完成后,在飞书中搜索你创建的应用名称,就可以开始单聊或在群里@它了。

四、常见问题与避坑指南
| 问题 | 解决方案 |
| 机器人不回复 | 检查CoPaw服务是否在运行:`docker ps | grep copaw` |
| 提示“权限不足” | 飞书/钉钉开放平台中检查是否已开通消息相关权限 |
| 收不到群聊消息 | 确认机器人已添加到群聊,且群内@机器人时名称拼写正确 |
| 配置后不生效 | CoPaw频道配置是实时生效的,不用重启。如果不生效,尝试刷新页面或重新开关Enable |
| Client ID/Secret填错 | 回到开放平台重新复制,注意不要有多余空格 |
安全提醒:云端部署时记得将CoPaw空间设为非公开,否则其他人可能也能控制你的AI助理。
五、下期预告
接入钉钉和飞书之后,你的AI助理已经可以在聊天软件里随时待命了。但怎么让它每天早上8点自动推送新闻摘要?怎么让它自动监控网站更新并通知你?
下期文章:《让AI助理自动干活:定时任务 + 消息推送配置教程》
关注我,继续解锁更多玩法!
