[CoPaw 教程系列] #04: Copaw Channels
CoPaw 入门：频道配置与接入
频道（Channel）是你和 CoPaw 对话的「场所」。CoPaw 支持多种消息平台：
- 钉钉
- 飞书
- Discord
- iMessage（仅 Mac）
- Console（控制台内置）
一个 CoPaw 实例可以同时接入多个应用，你在哪个频道聊天，它就在哪个频道回复。
基本配置流程
所有频道的配置流程基本相同：
- 在控制台中进入 控制 → 频道
- 点击你要配置的频道卡片
- 右侧滑出配置面板，打开 Enable 开关
- 填写该频道所需的凭据（不同频道要求不同）
- 点 保存，几秒内自动生效，无需重启
Console 频道
Console 是 CoPaw 控制台内置的频道，无需额外配置，只需启用即可。
配置步骤
- 进入 控制 → 频道
- 找到 Console 卡片，点击
- 打开 Enable 开关
- 点击 保存
完成！现在你可以在控制台的聊天页面与 CoPaw 对话。
Console 频道适合：
- 测试 CoPaw 功能
- 不想接入外部平台的用户
- 首次使用 CoPaw
钉钉频道
钉钉是企业常用的即时通讯工具，CoPaw 可以作为机器人接入钉钉。
需要填写的字段
- Client ID
- Client Secret
获取凭据步骤
1. 创建企业内部机器人
- 访问 钉钉开放平台
- 登录后进入「开发者后台」
- 选择「应用开发」→「企业内部开发」
- 点击「创建应用」
- 填写应用信息：
- 应用名称：如「CoPaw 助手」
- 应用描述：CoPaw 个人助理
- 应用图标：上传一个图标
2. 获取 Client ID 和 Client Secret
- 进入应用详情页
- 在左侧菜单中选择「凭证与基础信息」
- 复制 Client ID（也称为 AppKey）
- 复制 Client Secret（也称为 AppSecret）
3. 配置机器人权限
- 在左侧菜单中选择「权限管理」
- 搜索并申请以下权限：
contact:user.base:readonly- 查看用户信息contact:role.base:readonly- 查看角色信息im:chat- 发送消息im:conversation- 管理会话
- 提交申请，等待管理员审批
4. 设置机器人回调地址
- 在左侧菜单中选择「开发管理」
- 在「服务器出口 IP」中填写你的服务器 IP（如有）
- 在「事件订阅」中配置回调地址（如需要）
5. 在 CoPaw 中配置
- 进入控制台 控制 → 频道
- 点击 钉钉 卡片
- 打开 Enable 开关
- 填写：
- Client ID：粘贴之前复制的 Client ID
- Client Secret：粘贴之前复制的 Client Secret
5. 点击 保存
6. 在钉钉中添加机器人
- 在钉钉中打开任意群聊
- 点击群设置 → 智能群助手 → 添加机器人
- 选择「自定义」机器人
- 输入机器人名称和 Webhook 地址（从 CoPaw 控制台获取）
- 完成添加
7. 开始使用
现在你可以在钉钉中与 CoPaw 对话了！
使用 dingtalk_channel_connect Skill
CoPaw 提供了一个内置 Skill 来简化钉钉频道的配置流程：
- 在控制台中进入 智能体 → 技能
- 找到
dingtalk_channel_connectSkill，点击 启用 - 在控制台聊天页面，输入：「帮我配置钉钉频道」
- CoPaw 会引导你完成配置步骤
飞书频道
飞书是字节跳动的企业协作平台，CoPaw 可以作为机器人接入飞书。
需要填写的字段
- App ID
- App Secret
- 加密密钥
- 验证令牌
- 媒体文件目录
获取凭据步骤
1. 创建企业自建应用
- 访问 飞书开放平台
- 登录后进入「开发者后台」
- 选择「企业自建应用」
- 点击「创建企业自建应用」
- 填写应用信息：
- 应用名称：如「CoPaw 助手」
- 应用描述：CoPaw 个人助理
- 应用图标：上传一个图标
2. 获取 App ID 和 App Secret
- 进入应用详情页
- 在左侧菜单中选择「凭证与基础信息」
- 复制 App ID
- 复制 App Secret
3. 配置事件订阅
- 在左侧菜单中选择「事件订阅」
- 点击「添加请求」
- 配置：
- 请求地址：填写你的服务器地址（从 CoPaw 控制台获取）
- 验证令牌：生成一个随机字符串（如
copaw-token-123） - 加密密钥：点击「生成密钥」按钮
- 点击「保存」，复制 验证令牌 和 加密密钥
4. 配置机器人权限
- 在左侧菜单中选择「权限管理」
- 搜索并申请以下权限：
im:message- 接收消息im:message:send_as_bot- 发送消息contact:user.base:readonly- 查看用户信息
- 提交申请，等待管理员审批
5. 配置媒体文件目录
- 在你的服务器上创建一个目录用于存储媒体文件：
mkdir -p ~/copaw_media
- 确保该目录有读写权限
6. 在 CoPaw 中配置
- 进入控制台 控制 → 频道
- 点击 飞书 卡片
- 打开 Enable 开关
- 填写：
- App ID：粘贴之前复制的 App ID
- App Secret：粘贴之前复制的 App Secret
- 加密密钥：粘贴之前复制的加密密钥
- 验证令牌：粘贴之前复制的验证令牌
- 媒体文件目录：填写
/home/你的用户名/copaw_media（或其他路径）
5. 点击 保存
7. 在飞书中添加机器人
- 在飞书中打开任意群聊
- 点击群设置 → 群机器人 → 添加机器人
- 选择你创建的应用
- 完成添加
8. 开始使用
现在你可以在飞书中与 CoPaw 对话了！
Discord 频道
Discord 是游戏社区和开发者常用的通讯平台，CoPaw 可以作为 Bot 接入 Discord。
需要填写的字段
- Bot Token
- HTTP 代理（可选）
- 代理认证（可选）
获取凭据步骤
1. 创建 Discord 应用
- 访问 Discord 开发者门户
- 登录后点击「New Application」
- 填写应用名称：如「CoPaw Assistant」
- 点击「Create」
2. 创建 Bot
- 在左侧菜单中选择「Bot」
- 点击「Add Bot」
- 确认创建
- 复制 Bot Token（点击「Reset Token」按钮，然后复制显示的 token）
- ⚠️ 注意：Bot Token 只显示一次，请妥善保管
3. 配置 Bot 权限
- 在 Bot 设置中，找到「Privileged Gateway Intents」
- 启用以下选项：
- Message Content Intent
- Server Members Intent
- Presence Intent
- 点击「Save Changes」
4. 生成 OAuth2 链接
- 在左侧菜单中选择「OAuth2」→「URL Generator」
- 在 Scopes 中选择：
botapplications.commands
- 在 Bot Permissions 中选择：
- Send Messages
- Read Message History
- View Channel
- Embed Links
- Attach Files
- Add Reactions
- 复制生成的 URL（页面底部）
5. 将 Bot 添加到服务器
- 打开之前复制的 OAuth2 URL
- 选择要添加 Bot 的服务器
- 授权 Bot
6. 配置代理（可选）
如果你的服务器需要通过代理访问 Discord，可以配置 HTTP 代理：
- 在控制台中进入 控制 → 频道
- 点击 Discord 卡片
- 打开 Enable 开关
- 填写：
- Bot Token：粘贴之前复制的 Bot Token
- HTTP 代理：填写代理地址（如
http://proxy.example.com:8080） - 代理认证：填写代理认证信息（如
username:password）
5. 点击 保存
7. 开始使用
现在你可以在 Discord 中与 CoPaw 对话了！
常见问题
Q: Discord Bot 无法连接？
A: 检查：
- Bot Token 是否正确
- 是否启用了必要的 Intents
- 是否添加了 Bot 到服务器
- 是否配置了代理（如果需要）
QQ 频道
QQ 是国内广泛使用的即时通讯工具，CoPaw 可以接入 QQ 机器人。
需要填写的字段
- App ID
- Client Secret
获取凭据步骤
1. 创建 QQ 机器人应用
- 访问 QQ 开放平台
- 登录后创建应用
- 填写应用信息：
- 应用名称：如「CoPaw 助手」
- 应用类型：机器人
2. 获取 App ID 和 Client Secret
- 进入应用详情页
- 复制 App ID
- 复制 Client Secret
3. 配置机器人权限
申请以下权限：
- 发送消息
- 接收消息
- 管理群聊
4. 在 CoPaw 中配置
- 进入控制台 控制 → 频道
- 点击 QQ 卡片
- 打开 Enable 开关
- 填写：
- App ID：粘贴之前复制的 App ID
- Client Secret：粘贴之前复制的 Client Secret
5. 点击 保存
5. 开始使用
现在你可以在 QQ 中与 CoPaw 对话了！
iMessage 频道
iMessage 是 macOS 系统内置的消息应用，CoPaw 可以接入 iMessage（仅支持 macOS）。
需要填写的字段
- 数据库路径
- 轮询间隔
配置步骤
1. 确定数据库路径
iMessage 的数据库通常位于：
~/Library/Messages/chat.db
2. 在 CoPaw 中配置
- 进入控制台 控制 → 频道
- 点击 iMessage 卡片
- 打开 Enable 开关
- 填写：
- 数据库路径：填写
/Users/你的用户名/Library/Messages/chat.db - 轮询间隔：填写轮询间隔（秒），如
5
5. 点击 保存
3. 开始使用
现在你可以在 iMessage 中与 CoPaw 对话了！
注意事项
- iMessage 频道仅支持 macOS
- 需要授予 CoPaw 访问 iMessage 数据库的权限
- 轮询间隔越小，响应越快，但资源消耗越大
多频道同时使用
CoPaw 支持同时接入多个频道。例如，你可以同时启用：
- 钉钉（工作群聊）
- 飞书（个人协作）
- Console（测试）
CoPaw 会根据消息来源自动识别频道，并在同一频道中回复。
配置多个频道
只需按照各频道的配置步骤，依次启用即可。配置完成后：
- 在控制台 控制 → 频道 中，可以看到所有已启用的频道
- 每个频道独立运行，互不干扰
- CoPaw 会记住每个频道的会话历史
切换和禁用频道
如需禁用某个频道：
- 进入控制台 控制 → 频道
- 点击对应的频道卡片
- 关闭 Enable 开关
- 点击 保存
禁用的频道不再接收和发送消息，但历史记录会保留。
频道配置对比
| 频道 | 配置难度 | 功能完整性 | 隐私性 | 推荐场景 |
|------|---------|-----------|--------|---------|
| Console | ⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | 测试、首次使用 |
| 钉钉 | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | 企业内部使用 |
| 飞书 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ | 企业协作 |
| QQ | ⭐⭐ | ⭐⭐⭐ | ⭐⭐ | 个人使用 |
| Discord | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | 社区、游戏 |
| iMessage | ⭐⭐ | ⭐⭐ | ⭐⭐⭐⭐⭐ | macOS 个人使用 |
常见问题
Q1: 频道配置后无法接收消息？
A: 检查：
- 凭据是否正确（Client ID、Secret 等）
- 是否启用了必要的权限
- 机器人是否已添加到群聊/好友列表
- 控制台中频道是否显示「已启用」
Q2: CoPaw 能同时回复多个频道吗？
A: 是的！CoPaw 支持多频道同时使用，每个频道的消息会被自动路由到对应频道。
Q3: 如何查看所有频道的会话记录？
A: 在控制台的 控制 → 会话
中，可以查看、筛选和管理所有频道的聊天会话。
Q4: 频道配置失败怎么办？
A: 参考官方文档的「频道配置」章节，或查看 FAQ 常见问题。
Q5: 能在频道中使用所有 Skills 吗？
A: 是的！无论在哪个频道，都可以使用所有启用的 Skills。
下一步
现在你已经了解了 CoPaw 支持的各类频道及其配置方法。接下来建议：
- 阅读下一篇：CoPaw 入门：Skills 能力系统概览 - 了解 CoPaw 的核心能力扩展机制
- 配置频道：根据你的需求选择合适的频道并配置
- 测试对话：在配置的频道中与 CoPaw 对话，测试功能
- 探索 Skills：了解内置 Skills 的功能，启用你需要的 Skills
总结
CoPaw 支持多种消息平台，满足不同场景的需求：
✅ Console
- 内置频道，配置简单，适合测试
✅ 钉钉
- 企业级应用，功能强大
✅ 飞书
- 协作平台，集成度高
- 广泛使用，个人用户友好
✅ Discord
- 社区友好，开发者友好
✅ iMessage
- macOS 原生，隐私安全
选择适合你的频道，配置后即可开始与 CoPaw 对话。
相关资源
：
- CoPaw 官方文档：https://copaw.agentscope.io/
- CoPaw 频道配置文档：https://copaw.agentscope.io/docs/channels
- CoPaw FAQ：https://copaw.agentscope.io/docs/faq
- 钉钉开放平台：https://open.dingtalk.com/
- 飞书开放平台：https://open.feishu.cn/
- Discord 开发者门户：https://discord.com/developers/applications
