CoPaw接入微信/钉钉/飞书/QQ/企业微信全指南

CoPaw是一款支持多IM平台对接的智能体接入框架，可快速打通微信、钉钉、飞书、QQ、企业微信，让智能体在各聊天渠道稳定收发消息、完成交互任务。

本文大纲

• 📋 前置准备：通用配置方式与规则
• 🛠️ 钉钉接入：应用创建→凭证获取→配置绑定
• 🚀 飞书接入：应用搭建→权限开通→长连接配置
• 💬 QQ接入：机器人创建→事件配置→凭证填写
• 🏢 企业微信接入：API机器人创建→密钥获取→通道绑定
• 📱 微信个人接入：iLink协议→扫码授权→配置生效

一、前置准备📋

CoPaw提供两种配置入口，保存后自动重载无需重启：

• 1. 控制台（推荐）：访问http://127.0.0.1:8088/→Control→Channels，点击对应频道卡片启用并填写信息。
• 2. 手动配置：编辑文件~/.copaw/workspaces/default/agent.json，修改对应频道参数。

通用核心参数：enabled（开启频道）、bot_prefix（机器人回复前缀）。

二、钉钉接入🛠️

• 1. 创建应用：打开钉钉开发者后台→企业内部应用→创建应用→添加机器人能力→消息接收设为Stream模式→发布版本。
• 2. 获取凭证：在基础信息→凭证与基础信息，复制Client ID、Client Secret。
• 3. 配置绑定：

"dingtalk": { "enabled": true, "bot_prefix": "[BOT]", "client_id": "你的Client ID", "client_secret": "你的Client Secret" }

4. 可选：将服务器公网IP加入安全设置白名单，避免文件下载报错。

三、飞书接入🚀

• 1. 创建应用：飞书开放平台→企业自建应用，完成基础信息创建。
• 2. 获取凭证：复制凭证与基础信息中的App ID、App Secret。
• 3. 开通配置：添加机器人能力→批量导入消息/文件权限→事件配置设为WebSocket长连接→订阅接收消息v2.0→发布应用版本。
• 4. 配置绑定（需先安装pip install lark-oapi）：

"feishu": { "enabled": true, "bot_prefix": "[BOT]", "app_id": "你的App ID", "app_secret": "你的App Secret" }

四、QQ接入💬

• 1. 创建机器人：QQ开放平台→机器人应用，完善名称、头像等信息。
• 2. 事件配置：勾选C2C消息事件、群消息AT事件→沙箱配置添加自己为测试成员。
• 3. 获取凭证：开发管理中复制AppID、AppSecret，配置IP白名单。
• 4. 配置绑定：

"qq": { "enabled": true, "bot_prefix": "[BOT]", "app_id": "你的AppID", "client_secret": "你的AppSecret" }

五、企业微信接入🏢

• 1. 创建机器人：注册企业微信→工作台→智能机器人→选择API模式创建机器人。
• 2. 获取凭证：复制机器人的Bot ID、Secret。
• 3. 配置绑定：

"wecom": { "enabled": true, "bot_prefix": "[BOT]", "bot_id": "你的Bot ID", "secret": "你的Secret" }

六、微信个人接入📱

• 1. 资格说明：基于iLink协议，需先申请内测接入资格。
• 2. 授权登录：Console→设置→通道→微信个人，获取二维码扫码授权，Token自动本地保存。
• 3. 配置绑定：

"weixin": { "enabled": true, "bot_prefix": "[BOT]", "bot_token_file": "~/.copaw/weixin_bot_token" }

总结

本文完整梳理CoPaw对接微信、钉钉、飞书、QQ、企业微信的全流程，明确各平台创建、鉴权、配置的关键步骤与参数，可快速完成多IM渠道的智能体接入。实在Agent可适配CoPaw多渠道适配逻辑，自动处理各平台鉴权与消息回调，简化配置步骤，帮你快速让智能体落地全聊天场景，提升协作效率。