【人工智能】－手把手让CoPaw助理上QQ
上一期我们介绍了如何本地部署CoPaw（阿里开源的个人AI工作站）。今天来点更实用的——把CoPaw接入QQ！配置完成后，你可以在QQ上直接和你的AI助理对话，它会在私聊或群聊中响应你，帮你查资料、记笔记、跑任务……而且所有数据都在你自己的环境里，安全又自由。
🎯 先看效果
配置成功后，你在QQ上给机器人发消息：
我：最近一周AI圈最火的三件事
机器人：1. CoPaw开源发布… 2. GPT-5传闻… 3. 某大模型降价…
后台日志会显示接收和处理过程，就像这样：
INFO ... qq recv c2c from=61C643... text='我需要知道最近一周ai最火的三件事情' INFO ... Handle agent query: { "session_id": "qq:...", "channel": "qq", ... }是不是很酷？下面开始配置。
📋 准备工作
- 你已经成功部署并运行了CoPaw（参考上一期教程）
- 一个QQ号（用来创建机器人）
- 能访问QQ开放平台的网络
第一步：获取QQ机器人凭证
1. 进入QQ开放平台
打开 QQ开放平台（建议使用Chrome或Edge），用你的QQ扫码登录。
2. 创建机器人应用
登录后，点击左侧创建机器人，填写基本信息：
创建成功后，你会进入机器人的编辑页面。系统将自动将生成相应的ID和密钥。
点击编辑按钮，你可以实现如下内容编辑：
- 机器人名称（随便起，比如“我的CoPaw助理”）
- 机器人头像（上传一张图）
- 简介（可选）
3. 获取 AppID 和 AppSecret
在开发管理页面，你可以看到：
- AppID（一串数字）
- AppSecret（也叫 ClientSecret，一串字母数字混合）
把它们复制保存到记事本，稍后要用。
第二步：填写 agent.json 配置文件
CoPaw的配置位于工作区的agent.json文件中。默认路径是：
- Windows:
C:\Users\用户名\.copaw\workspaces\CoPaw_QA_Agent_0.1beta1\agent.json - macOS/Linux:
~/.copaw/workspaces/default/agent.json
用任何文本编辑器（记事本、VS Code）打开它，找到channels下的qq部分，如果没有就手动添加：
"qq":{"enabled":true,"bot_prefix":"","filter_tool_messages":false,"filter_thinking":false,"dm_policy":"open","group_policy":"open","allow_from":[],"deny_message":"","require_mention":false,"app_id":"你的ID","client_secret":"你的密钥","markdown_enabled":true,"max_reconnect_attempts":100},字段说明：
| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
enabled | bool | true | 是否启用QQ通道 |
bot_prefix | string | "[BOT]" | 机器人消息前缀（可选） |
app_id | string | 必填 | 你的QQ机器人AppID |
client_secret | string | 必填 | 你的QQ机器人AppSecret |
markdown_enabled | bool | false | 是否支持Markdown消息（需平台授权） |
max_reconnect_attempts | int | -1 | 断线重连次数（-1表示无限重连） |
把刚才保存的AppID和AppSecret分别填入对应位置，保存文件。
第三步：重启CoPaw并测试
如果你之前已经运行了copaw app，需要重启才能加载新配置：
- 在终端按
Ctrl + C停止服务 - 重新运行
copaw app - QQ机器人点击扫描聊天，添加QQ机器人好友
现在打开手机QQ，找到你的机器人（就是刚才扫码添加的好友），发送一条消息试试：
你好，帮我总结一下今天的AI新闻
正常情况下，机器人会回复你。如果没反应，检查以下几点：
- ✅ agent.json 中的
app_id和client_secret是否正确 - ✅ 终端日志是否有报错（常见问题是网络连接或凭证错误）
进阶：在前端界面直接配置（可选）
CoPaw的控制台也支持可视化配置，如果你觉得改JSON文件麻烦，可以这样做：
- 浏览器打开
http://127.0.0.1:8088/channels - 或者通过侧边栏进入设置 → 渠道或Channels页面
- 找到QQ卡片，点击启用，填入 AppID 和 AppSecret
- 保存，重启服务
恭喜！你的CoPaw现在已经成为一名真正的QQ机器人了。你可以：
- 在私聊中让它帮你查资料、写文案、记待办
- 结合CoPaw的Skills功能，让它定时推送天气、新闻、股票……
官方文档：https://copaw.agentscope.io/docs/channels/qq