折腾了一个周末,踩过QQ的坑,用5分钟搞定飞书,还发现了一个让人上头的功能——让AI帮AI装技能。
上周五晚上,我在刷 GitHub trending,看到一个叫 CoPaw 的项目,介绍说"把AI助手部署在你自己的机器上,连进飞书/钉钉/QQ,数据完全自控"。
这几个关键词正好踩中我的需求:不想数据跑到别人的云上,又想在飞书工作时顺手问一下 AI。于是当晚就开始折腾,折腾到了周六下午才基本搞定。
这篇文章是整个过程的实录,踩过的坑都写进来了,省得你重走弯路。
CoPaw 是什么
一句话:开源的个人 AI 工作站,部署在本地,通过飞书/QQ/Discord 等聊天软件交互,能力靠"技能"插件无限扩展。
项目来自阿里 AgentScope 团队,目前在 GitHub 上已有超过 2400 star,还在快速迭代。官方仓库:https://github.com/agentscope-ai/CoPaw
一、安装:选择从源码本地安装
CoPaw 有三种安装方式:pip、Docker、一键脚本。我选了从源码安装,主要是想方便后续改代码。
前置条件
需要 Python 3.10 ~ 3.13,先确认版本:
python --version
# Python 3.11.9
三步搞定
# 第一步:克隆代码
git clone https://github.com/agentscope-ai/CoPaw.git
cd CoPaw
# 第二步:可编辑模式安装(改代码不用重装)
pip install -e .
# 第三步:初始化配置
copaw init --defaults
--defaults 会跳过所有交互式问答,用默认配置直接完成初始化,省了很多事。
初始化完成后,启动本地服务:
copaw app
打开 http://127.0.0.1:8088,出现 Console 控制台界面,安装完成。
整个过程大概 10 分钟,没有遇到报错,依赖也比较干净。
二、模型配置:免费使用智谱大模型
装好的 CoPaw 是个空壳,必须配置大模型才能工作。
我选的是智谱 AI 的 GLM 系列,原因很简单:有免费额度,日常轻量使用基本够用。
注册拿 API Key
点这个链接注册,可以获得额外免费 Token:
注册后进「API Keys」页面生成一个 Key,复制备用。
在控制台填入配置
打开 http://127.0.0.1:8088 → Settings → Models:
- 提供商选 ZhipuAI(智谱)
- 粘贴 API Key
- 模型选
glm-4-flash(免费,速度快,够用) - 点 Activate
回到对话框发一条"你好",AI 回复正常,配置完成。
glm-4-flash是智谱当前的免费模型,日常问答、总结、写代码都没问题。如果需要更强的推理能力,可以付费用glm-4或glm-4-long。
三、频道配置:QQ 劝退,飞书5分钟
模型配好了,接下来是"让 AI 住进聊天软件"——这才是 CoPaw 日常使用的核心场景。
我先试了 QQ,然后转向飞书,两种体验云泥之别。
QQ:填不完的表,最终放弃
QQ 机器人的配置需要:
- 去腾讯开放平台申请机器人资质
- 填写应用信息,等待审核
- 配置 Webhook 回调地址
- 填写签名密钥和验证逻辑
- 处理消息格式适配……
每一步都要查文档,中间还遇到回调验证失败、权限不足等报错。折腾了将近一小时,最终决定:放弃。
不是 CoPaw 的问题,是 QQ 开放平台本身对开发者不够友好。
飞书:5分钟极速配置 ✅
切换到飞书,整个过程行云流水。
第一步:创建飞书应用(2分钟)
登录 飞书开放平台 → 「创建企业自建应用」,填写应用名称,拿到 App ID 和 App Secret。
第二步:开权限 + 填 Webhook(2分钟)
在应用后台:
- 「权限管理」开通「接收消息」和「发送消息」
- 「事件订阅」里填入 CoPaw 控制台 Channels 页面给出的 Webhook 地址
- 勾选「接收消息」事件
第三步:填入 CoPaw 控制台(1分钟)
回到 http://127.0.0.1:8088 → Channels → Feishu,填 App ID 和 App Secret,保存。
应用发布到飞书群,在群里 @CoPaw,它立刻回复——那一刻确实有点兴奋,自己部署的 AI 真的活了。
飞书能跑的核心原因:飞书开放平台文档写得好,Webhook 验证逻辑简单,CoPaw 配置界面也对应得上。整个流程几乎不需要查文档。
四、Skill 技能系统:让 AI 帮 AI 找技能安装
用了两天后,我觉得 CoPaw 最大的魅力不是对话,而是 Skill(技能)系统——尤其是它的使用方式。
直接开口让它自己找
我在飞书群里 @CoPaw,说了这么一句话:
"帮我找一个能抓取网页内容的技能,然后安装它"
接下来它:
- 搜索了可用的技能库
- 找到了一个网页抓取技能
- 自己执行安装命令
- 告诉我"已安装,你现在可以说'帮我抓取 xxx 网页的内容'了"
全程我没有输入任何命令。
这种"AI 帮 AI 扩展能力"的体验,是我用过的所有 AI 工具里最新奇的一个——它在自己成长。
技能的覆盖范围
CoPaw 的技能生态覆盖面不窄:
| 类型 | 示例技能 |
|---|---|
| 信息获取 | 网页抓取、PDF 阅读、RSS 订阅 |
| 生产力 | 创建 Word/Excel、日历管理 |
| 内容消费 | B站/YouTube 视频总结、知乎/微博热榜 |
| 定时推送 | 每日新闻简报 → 飞书,定时提醒 |
| 桌面操作 | 整理本地文件、读取文档 |
技能内置 cron 调度支持,设置好后可以让 CoPaw 每天早上8点自动跑任务,把结果推送到飞书——比自己写定时脚本省心太多了。
自定义技能也很简单
如果官方技能库没有你要的,可以自己写——本质上就是一个 Python 模块,放在工作目录下会自动加载,没有任何平台绑定。
总结:值不值得折腾?
折腾完整个流程,用一张表说话:
| 环节 | 耗时 | 难度 | 评价 |
|---|---|---|---|
| 源码安装 | ~10分钟 | ⭐ | 顺畅无报错 |
| 智谱模型配置 | ~5分钟 | ⭐ | 有免费额度,够用 |
| QQ 频道 | ~1小时 | ⭐⭐⭐⭐⭐ | 太复杂,放弃 |
| 飞书频道 | ~5分钟 | ⭐ | 强烈推荐,丝滑 |
| Skill 技能系统 | 持续探索中 | ⭐ | 最大亮点,会上头 |
如果你也想要一个住在飞书里、跑在自己机器上、能力可以无限叠加的 AI 助手,CoPaw 是目前我见过最接近这个目标的开源项目。
安装门槛不高,飞书配置极低,Skill 系统会让你停不下来。
项目地址:https://github.com/agentscope-ai/CoPaw
智谱大模型免费额度:https://www.bigmodel.cn/invite?icode=uDf5fsbCnv4HIoqaGcBE5LC%2Fk7jQAKmT1mpEiZXXnFw%3D
用了什么有趣的技能组合?欢迎在评论区分享,也许能给我新思路。