> "懂你所需，伴你左右"
项目信息
- GitHub: https://github.com/agentscope-ai/CoPaw
- Stars: 14.9k+
- 许可证: Apache License 2.0
- 组织: AgentScope 团队（阿里云通义实验室）
引言：一只温暖的小爪子
想象这样一个场景：深夜十一点，你躺在床上，脑子里还在想着明天要提交的那份报告。你对手机说："帮我整理一下过去两周关于项目进度的邮件，明天早上八点前发一份摘要到我的钉钉。"然后你就睡了。第二天早上醒来，钉钉里静静躺着一份结构清晰的摘要——关键信息已经标红，需要跟进的邮件列成了清单，甚至还有一句贴心的提醒："您有三封邮件提到'紧急'字样，建议优先处理。"
这不是科幻电影。这是 CoPaw 用户的日常。
CoPaw，这个名字有两层含义。表面上，它是 Co-Paw——你的搭档小爪子，一只随时准备帮你一把的温暖存在。往深里说，它是 Co Personal Agent Workstation（协同个人智能体工作台）。一个由阿里云通义实验室 AgentScope 团队开源的项目，GitHub 上已经收获了超过 1.5 万颗星星。
"懂你所需，伴你左右"——这句 slogan 听起来像是每个 AI 产品都会说的漂亮话。但 CoPaw 的区别在于：它不是运行在遥远的数据中心，而是住在你的电脑里、你的服务器上，或者你选择的任何一个角落。你的数据、你的记忆、你的工作方式——全部归你掌控。
这不是又一个云端 AI 助手。这是一个属于你自己的数字伙伴。
---
第一章：个人 AI 助理的新范式
1.1 从云端城堡到自家后院
先让我们看看过去几年 AI 助手的发展轨迹。
当 ChatGPT 在 2022 年底横空出世时，人们第一次大规模体验到了"对话式 AI"的威力。你可以问它任何问题，它会给你一个像模像样的回答。然后是 Claude、Gemini、文心一言、通义千问……各大厂商纷纷推出自己的对话产品。
但这些产品都有一个共同特点：它们运行在厂商的服务器上。
这意味着什么？意味着你的每一次对话都被发送到某个数据中心，在那里被记录、被分析、被用于训练模型。厂商可能会承诺"保护用户隐私"，但本质上，数据一旦离开你的设备，你就失去了对它的完全控制。
更实际的问题是：这些助手都是"通用型"的。它们不知道你喜欢用什么样的语气写邮件，不记得你上周提到过的重要截止日期，也不了解你公司里那些只有内部人才懂的缩写和流程。每次对话都是全新的开始，就像面对一个刚认识的朋友——聪明，但陌生。
CoPaw 选择了一条不同的路。
1.2 核心理念：由你掌控
CoPaw 的设计哲学可以用一句话概括：你的数据，你的规则。
这听起来很简单，但实现起来需要解决一系列技术难题。让我用一个具体的例子来说明这到底意味着什么。
假设你是一个对隐私极度敏感的人——可能是律师、医生，或者只是不想让自己的聊天记录被拿去训练模型的普通人。你想用 AI 助手帮你整理病历、法律文件，或者只是写一些不想被外人看到的私人日记。
在传统云 AI 助手的模式下，你的选择是：
- 相信厂商的隐私承诺
- 或者干脆不用
你把 CoPaw 装在自己的电脑上。所有数据都保存在本地硬盘。对话记录、学习到的偏好、积累的知识库——全部留在你的设备里。即使断网，它也能继续工作（只要你用的是本地模型）。
这不是说 CoPaw 不支持云端模型——它当然支持 OpenAI、通义千问、Gemini 等各种 API。但区别在于，这是你主动选择的结果，而不是唯一的选择。
1.3 对比：CoPaw 与其他方案
让我们用一张表格来直观对比几种主流的个人 AI 助理方案：
| 特性 | ChatGPT/Claude | OpenClaw | CoPaw |
|---|---|---|---|
| 部署方式 | 纯云端 | 本地/云端 | 本地/云端 |
| 数据控制 | 厂商控制 | 用户控制 | 用户控制 |
| 开源程度 | 闭源 | 开源 | 开源 (Apache 2.0) |
| 国内访问 | 受限/不稳定 | 需配置 | 友好支持 |
| 多平台集成 | 有限 | 丰富 | 非常丰富 |
| 多智能体协作 | 不支持 | 支持 | 原生支持 |
| 记忆管理 | 会话级 | 基础 | ReMe 引擎 |
| Skills 扩展 | 插件商店 | 脚本扩展 | 模块化 Skills |
| 学习曲线 | 低 | 中 | 低-中 |
比如说，OpenClaw 和 CoPaw 都是开源的个人 AI 助理框架，都能本地部署，都支持多平台。那它们的区别在哪里？
一个关键的区别在于底层架构的选择。
OpenClaw 有自己的技术栈，而 CoPaw 选择站在巨人的肩膀上——它基于 AgentScope 框架构建。AgentScope 是阿里云通义实验室开源的智能体框架，专门为多智能体协作、记忆管理、工具调用等场景设计。这意味着 CoPaw 从第一天起就继承了这些成熟的能力，而不是从零开始造轮子。
另一个区别是对国内用户的友好度。CoPaw 原生支持钉钉、飞书、企业微信等国内主流办公平台，安装和配置流程针对国内网络环境做了优化。这不是什么高深的技术差异，但对于实际使用者来说，意味着少踩很多坑。
---
第二章：五维能力模型
CoPaw 的核心能力可以归纳为五个维度。让我用一个具体的生活场景来串起这五个维度。
2.1 场景故事：小林的周二
小林是一位产品经理，工作日程排得很满。让我们看看 CoPaw 如何帮助他度过典型的一天。
早上 8:00 - 邮件摘要
小林还在地铁上，手机钉钉收到一条消息：
> 【CoPaw】今日邮件摘要： > - 3 封重要邮件（来自 CTO、设计总监、客户张总） > - 2 封待确认会议邀请 > - 1 封周报提醒 > > 详细内容已发送至你的工作邮箱，标红项建议优先处理。
这是 CoPaw 的定时任务功能在运作。小林前一天晚上设置了规则：每天早上 8 点扫描邮箱，按发件人优先级和关键词（"紧急"、"确认"、"截止"等）生成摘要，推送到钉钉。
上午 10:30 - 会议记录
产品评审会结束，小林把会议录音丢给 CoPaw："整理一下今天的评审意见，提取所有待办事项。"
10 秒后，CoPaw 回复：
> 【会议纪要】 > 待办事项（5 项）： > 1. [高] 修改登录流程原型 - 负责人：小林 - 截止：周四 > 2. [中] 补充数据埋点文档 - 负责人：小李 - 截止：周五 > ...
这是文档处理能力的体现。CoPaw 可以解析音频、PDF、Word、图片等多种格式，提取关键信息并生成结构化输出。
中午 12:00 - 跨平台同步
小林在公司用钉钉跟 CoPaw 对话，中午吃饭时不方便打字，就通过语音在企业微信上发了一条消息："下午 3 点的会帮我准备一下产品数据。"
下午回到公司，打开钉钉继续工作，CoPaw 已经准备好了数据摘要——它记得企业微信上的那条语音指令，因为多平台记忆是打通的。
下午 4:00 - 智能体协作
小林需要分析竞品最近的动态。他对 CoPaw 说："帮我追踪一下竞品 A 和竞品 B 最近一周的 GitHub 更新，分析它们的新功能，然后生成一份对比报告。"
这是一个复杂的任务，涉及多个步骤： 1. 监测 GitHub 仓库动态 2. 分析 issue 和 PR 的内容 3. 对比两个竞品的功能差异 4. 生成结构化的分析报告
CoPaw 没有试图用一个"超级智能体"搞定所有事情。相反，它激活了多智能体协作模式：
- 智能体 A 专门负责 GitHub 监测，输出事件摘要
- 智能体 B 分析 issue 与 PR 的关联关系，给出置信度评分
- 智能体 C 结合历史案例和文档，为每个新功能生成解读
- 智能体 D 汇总所有结果，生成最终报告
晚上 8:00 - 安全防护
小林想清理一下电脑里的旧文件，对 CoPaw 说："帮我删除 ~/temp 目录下所有超过 30 天的文件。"
CoPaw 没有立即执行。它弹出一个警告：
> ⚠️ 检测到文件删除操作 > 操作：删除 ~/temp 目录下 47 个文件 > 建议：请先确认这些文件是否包含重要数据 > 选项：[预览文件列表] [继续执行] [取消]
这是安全防护机制在起作用。CoPaw 会自动拦截潜在危险的操作，比如删除系统文件、修改敏感配置等。
---
2.2 第一维：由你掌控
让我们回到五维能力模型的详细解读。
第一维：由你掌控
这个维度包含三层含义：
数据主权
你的所有数据——对话记录、上传的文件、生成的内容——都存储在你指定的地方。可以是本地硬盘、私有服务器，或者你信任的云服务商。没有第三方托管，没有未经许可的数据上传。
这里需要澄清一个误解：使用云端 API 模型（比如调用通义千问或 GPT-4）时，对话内容确实会被发送到模型提供商的服务器。这是不可避免的，因为模型需要你的输入才能生成输出。但 CoPaw 的设计确保了：
- 记忆和个性化数据保存在本地
- 你可以选择使用本地模型完全避免云端交互
- 即使使用云端模型，系统也会明确告知你哪些数据会被发送
CoPaw 支持六种部署方式（第五章会详细展开）。从最简单的 pip 安装，到 Docker 容器，再到桌面应用——你可以根据自己的技术能力和需求选择最适合的方式。
个性化持久化
CoPaw 会记住你的偏好。这不是什么花哨的功能，而是基于 ReMe 记忆引擎的实用能力。比如：
- 你习惯用什么格式接收会议纪要
- 你常用的发件人优先级排序
- 你之前提到过的项目截止日期
2.3 第二维：Skills 扩展
第二维：Skills 扩展
CoPaw 的能力边界由 Skills（技能）定义。这就像一个工具箱——你想让它做什么，就给它装什么工具。
内置 Skills
CoPaw 自带了一系列常用技能：
| 技能名称 | 功能描述 | 使用场景 |
|---|---|---|
schedule | 定时任务管理 | 每日邮件摘要、周报提醒 |
pdf_reader | PDF 文档解析 | 合同分析、论文阅读 |
office_parser | Office 文档处理 | Excel 数据分析、PPT 整理 |
web_search | 网络搜索 | 新闻追踪、资料查找 |
news_digest | 新闻摘要 | 每日热点汇总 |
github_monitor | GitHub 监测 | 开源项目追踪 |
email_client | 邮件客户端 | 收发邮件、整理邮箱 |
真正强大的地方在于自定义技能。CoPaw 的 Skill 本质上是一个 Python 脚本，遵循简单的接口规范。以下是一个极简示例：
# ~/.copaw/skills/my_skill/skill.py
from copaw import Skill, Message
class MySkill(Skill):
name = "my_skill"
description = "我的自定义技能"
async def run(self, message: Message, ctx: dict) -> str:
user_input = message.content
# 你的业务逻辑
return f"处理结果：{user_input}"
把这个文件放在 ~/.copaw/skills/my_skill/ 目录下，CoPaw 会自动加载它。不需要复杂的配置，没有绑定，随时可以增加、删除或修改。
Skills 决定能力边界
CoPaw 的核心理念是：通过组合不同的 Skills，你可以构建出无限可能的工作流。
比如，你可以组合 schedule + web_search + email_client，实现"每天早上 8 点搜索指定关键词的新闻，生成摘要发送邮件"。或者组合 github_monitor + pdf_reader + news_digest，实现"追踪项目动态，遇到重大更新时读取文档并生成解读"。
2.4 第三维：多智能体协作
第三维：多智能体协作
这是 CoPaw v1.0 的重要升级。理解这个能力，需要先理解"多智能体"意味着什么。
传统上，我们与 AI 的交互是"一对一"的：一个用户，一个 AI 助手。但当任务变得复杂时，这种模式的局限性就显现出来了。
想象一下你是一家餐厅的主厨。今天的任务是做一桌 10 人份的大餐。你不会一个人包办所有事情——你会让助手 A 负责洗菜切菜，助手 B 负责烤肉，助手 C 负责摆盘，而你负责统筹和最后的调味。
多智能体协作就是类似的思路：把复杂任务拆解成子任务，分配给专门的智能体处理，最后汇总结果。
在 CoPaw 中，你可以创建多个独立的工作区（Workspace），每个工作区运行一个独立的智能体实例。这些智能体可以：
- 各自处理不同渠道的消息（比如工作号接钉钉，生活号接微信）
- 分工协作完成复杂任务
- 互相通信，传递中间结果
让我们看一个 v1.0 文档中的官方示例：
> 一条需求同时涉及「持续监测 GitHub 相关开源项目状态」「分析新的 issue 和 PR 是否有关联」「对 issue 给出可能的解决方案」。 > > 可由多个智能体并行协作： > - 智能体 A 持续监测目标仓库动态并输出事件摘要 > - 智能体 B 分析新 issue 与 PR 的关联关系并给出置信度 > - 智能体 C 结合历史案例、仓库文档与讨论为 issue 生成解决思路 > - 智能体 D 汇总各方结果，在发现高风险问题时触发提醒或请求人工确认
这个流程的关键在于：每个智能体各司其职，专注于自己擅长的领域。智能体 A 不需要懂代码分析，智能体 C 不需要关心监测频率。它们通过标准化的消息格式交换信息，主智能体负责任务调度和结果汇总。
2.5 第四维：多层安全防护
第四维：多层安全防护
当一个 AI 助手能够访问你的文件、执行命令、发送消息时，安全问题就变得至关重要。CoPaw 采用了三层防护机制：
第一层：工具守卫（Tool Guard）
自动拦截危险的 Shell 命令。比如：
rm -rf /（删除根目录）- Fork 炸弹（资源耗尽攻击）
- 反弹 shell（远程控制）
- 任何试图访问系统敏感路径的命令
第二层：文件访问守卫（File Guard）
限制智能体可以访问的文件范围。默认情况下，CoPaw 无法访问：
~/.ssh/（SSH 密钥）.env文件（环境变量/密钥）/etc/passwd等系统配置文件- 用户明确标记为敏感的其他路径
第三层：技能安全扫描（Skill Scanner）
在安装或启用一个 Skill 之前，CoPaw 会自动扫描其代码，检测以下风险：
- 提示词注入攻击
- 命令注入漏洞
- 硬编码的 API 密钥
- 数据外泄风险
- 恶意网络请求
- 拦截：发现高危风险，禁止安装
- 警告：发现中低风险，需要用户确认
- 通过：未发现明显风险
2.6 第五维：全域触达
第五维：全域触达
CoPaw 支持接入多种通讯渠道。截至 v1.0，官方支持的渠道包括：
| 渠道 | 状态 | 特点 |
|---|---|---|
| 钉钉 | ✅ 已支持 | 企业级功能完整 |
| 飞书 | ✅ 已支持 | 国内办公首选 |
| 企业微信 | ✅ 已支持 | 微信生态集成 |
| Discord | ✅ 已支持 | 国际化社区 |
| Telegram | ✅ 已支持 | 隐私友好 |
| ✅ 已支持 | 国内个人用户 | |
| iMessage | ✅ 已支持 | Apple 生态 |
| 微信 | ✅ 已支持 | 需额外配置 |
一个有趣的场景是跨平台消息同步。比如，你在钉钉中让 CoPaw "提醒我明天下午 3 点开会"，它可以： 1. 在飞书中同步提醒 2. 在 QQ 中推送通知 3. 在日历中创建事件 4. 根据长期记忆中存储的偏好，自动选择最佳提醒方式
这种能力不是简单的"消息转发"，而是基于对任务语义的理解，在不同平台上执行最合适的操作。
---
第三章：技术底座——AgentScope 解剖
3.1 为什么选择 AgentScope
CoPaw 不是从零开始构建的。它的底层是 AgentScope，一个由阿里云通义实验室开源的智能体框架。
这个选择有什么特别的意义？让我用一个类比来解释。
假设你要盖一栋房子。你有两个选择： 1. 从挖地基开始，一砖一瓦自己盖 2. 使用预制板结构，在已有的框架上搭建
选项 1 给你最大的自由度，但需要巨大的前期投入和专业知识。选项 2 让你更快入住，但可能会受限于预制板的规格。
CoPaw 选择了一个聪明的中间路线：使用 AgentScope 作为"预制地基"，但在上面搭建完全符合个人助理需求的"定制房屋"。
AgentScope 提供了什么？
灵活的代理架构（基于 ReAct 模式）
ReAct（Reasoning + Acting）是目前最成熟的智能体决策模式。简单来说，智能体不是直接回答问题，而是遵循"思考 → 行动 → 观察 → 再思考"的循环，直到任务完成。
AgentScope 把这个模式封装成了标准化的组件，CoPaw 只需要关注业务逻辑，不需要重复实现决策循环。
丰富的模型支持
AgentScope 统一了各种大模型的调用接口。无论是 OpenAI API、通义千问、Gemini，还是本地部署的 Llama、Qwen，都可以无缝切换。
强大的工具系统
工具（Tool）是智能体与外部世界交互的接口。AgentScope 提供了一套完整的工具定义、注册、调用机制，并且原生支持 MCP（Model Context Protocol）协议。
内存与消息系统
智能体需要"记忆"才能进行连贯的对话。AgentScope 提供了多种内存实现，从简单的会话缓存到复杂的向量数据库集成。
3.2 核心组件架构
让我们打开 CoPaw 的引擎盖，看看里面的构造。
┌─────────────────────────────────────────────────────────┐
│ CoPaw 架构图 │
├─────────────────────────────────────────────────────────┤
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Channel │ │ Channel │ │ Channel │ │
│ │ 钉钉适配器 │ │ 飞书适配器 │ │ Discord │ │
│ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │
│ │ │ │ │
│ └────────────────┴────────────────┘ │
│ │ │
│ ┌─────┴─────┐ │
│ │ 消息路由 │ │
│ └─────┬─────┘ │
│ │ │
│ ┌───────────────────────┼───────────────────────┐ │
│ │ ▼ │ │
│ │ ┌─────────┐ ┌─────────────┐ ┌──────────┐ │ │
│ │ │ Skill │ │ Memory │ │ Model │ │ │
│ │ │ Manager │ │ Manager │ │ Provider│ │ │
│ │ └────┬────┘ └──────┬──────┘ └────┬─────┘ │ │
│ │ │ │ │ │ │
│ │ └──────────────┼──────────────┘ │ │
│ │ ▼ │ │
│ │ ┌───────────────┐ │ │
│ │ │ Agent │ │ │
│ │ │ (ReAct核心) │ │ │
│ │ └───────┬───────┘ │ │
│ │ │ │ │
│ └──────────────────────┼───────────────────────┘ │
│ ▼ │
│ ┌───────────────────┐ │
│ │ AgentScope │ │
│ │ Runtime │ │
│ └───────────────────┘ │
└─────────────────────────────────────────────────────────┘
这个架构图展示了 CoPaw 的主要层次：
渠道层（Channel Layer）
负责与外部通讯平台对接。每个渠道适配器都要处理平台特定的消息格式、事件回调、权限管理和数据转换。无论消息来自钉钉、飞书还是 Discord，都会被统一转换为内部消息格式。
核心层（Core Layer）
包含三个关键管理器：
- Skill Manager：动态加载、卸载、执行 Skills
- Memory Manager：基于 ReMe 引擎的记忆管理
- Model Provider：模型调用抽象层
这是决策核心，基于 AgentScope 的 ReAct 实现。它接收消息，调用 Skills，管理记忆，与模型交互，最终生成回复。
运行时层（Runtime Layer）
AgentScope Runtime 提供底层的调度、监控、日志等基础设施。
3.3 记忆管理：ReMe 引擎
记忆是智能体连续性的关键。CoPaw 的记忆系统基于 ReMe（Remember Me, Refine Me）引擎实现。
ReMe 解决的核心问题是什么？让我们从用户的角度理解。
想象你和一个朋友聊天。第三次见面时，你不需要重新介绍自己、重新说明你的喜好——你的朋友记得你们之前的对话。这就是长期记忆的价值。
但实现起来有两个技术难点：
难点 1：上下文窗口有限
大模型一次能处理的 token 数是有限的（比如 4k、8k、128k）。当对话变长时，早期的信息会被截断。
难点 2：检索效率
即使有地方存储所有历史对话，如何在需要的时候快速找到相关信息？遍历所有记录显然不现实。
ReMe 的解决方案是分层记忆架构：
┌──────────────────────────────────────────────────────────┐
│ ReMe 记忆分层 │
├──────────────────────────────────────────────────────────┤
│ │
│ ┌────────────────────────────────────────────────────┐ │
│ │ 工作记忆 (Working Memory) │ │
│ │ 当前会话的近期对话（内存中） │ │
│ │ 默认保留最近 50 轮 │ │
│ └────────────────────────────────────────────────────┘ │
│ ▼ 压缩 │
│ ┌────────────────────────────────────────────────────┐ │
│ │ 压缩记忆 (Compressed Memory) │ │
│ │ 对话的结构化摘要 │ │
│ │ Goal/Progress/Decisions/Next Steps │ │
│ └────────────────────────────────────────────────────┘ │
│ ▼ 持久化 │
│ ┌────────────────────────────────────────────────────┐ │
│ │ 长期记忆 (Long-term Memory) │ │
│ │ 向量数据库 + 全文检索 │ │
│ │ 用户偏好、任务经验、关键知识 │ │
│ └────────────────────────────────────────────────────┘ │
│ │
└──────────────────────────────────────────────────────────┘
工作记忆（Working Memory）
当前活跃的对话内容保存在内存中。当 token 数接近上限时，CoPaw 会触发压缩机制，将早期对话转换为结构化摘要。
压缩记忆（Compressed Memory）
这是一个结构化的摘要，包含以下字段：
- Goal：用户的目标是什么
- Progress：任务进展到哪一步
- Key Decisions：做了哪些关键决策
- Next Steps：下一步计划
- Critical Context：文件路径、函数名、错误信息等关键数据
跨会话持久化的记忆。CoMe 使用向量数据库（支持 Chroma、FAISS、Qdrant 等）存储记忆，结合语义相似度检索，实现"相关内容的自动召回"。
记忆扩展效应
ReMe 有一个有趣的特性：配备 ReMe 的小模型可以超越无记忆的大模型。
根据官方实验数据，在 BFCL-V3 基准上：
- Qwen3-8B + ReMe 的 Pass@4 分数超过了无记忆的 Qwen3-14B，提升达 7.29%
- Qwen3-14B + ReMe 超过了无记忆的 Qwen3-32B
---
第四章：模型自由——云端与本地的无缝切换
4.1 云端模型的便利与代价
使用云端 API（如 GPT-4、通义千问）的好处是显而易见的：
- 模型能力强，知识更新及时
- 无需本地计算资源，普通电脑就能用
- 部署简单，配置一个 API Key 即可
- 每次调用都要付费
- 需要网络连接
- 数据离开本地设备
- 有速率限制和并发限制
4.2 本地模型的复兴
随着开源模型（Llama、Qwen、Mistral 等）的快速进步，本地部署变得越来越可行。
CoPaw 支持多种本地模型后端：
| 后端 | 特点 | 适用场景 |
|---|---|---|
| llama.cpp | 跨平台，C++ 实现，资源占用低 | 通用本地部署 |
| Ollama | 一键安装，模型管理方便 | 新手友好 |
| LM Studio | 图形界面，可视化操作 | 桌面用户 |
| MLX | Apple Silicon 优化 | Mac 用户 |
| CoPaw Local | 内置，自动更新 | 即开即用 |
4.3 CoPaw-Flash：量身定制的小模型
CoPaw v1.0 的一大亮点是推出了专为本地场景定制的小模型系列：CoPaw-Flash。
这个系列基于 Trinity-RFT 后训练框架研发，针对 CoPaw 的典型任务（文档处理、信息检索、工具调用）做了专门优化。
性能表现
根据官方数据，CoPaw-Flash 在文档处理和信息检索任务上的表现可以媲美甚至超越同尺寸的通用模型，同时推理速度更快、资源占用更低。
自动推荐
CoPaw 会根据你的设备性能自动推荐合适的模型版本。普通笔记本电脑可以流畅运行量化后的 7B 模型，而高端工作站可以尝试更大的版本。
4.4 混合模式：鱼与熊掌兼得
CoPaw 支持灵活配置，你可以为不同任务指定不同模型：
# ~/.copaw/config.yaml
models:
default:
provider: dashscope
model: qwen-max
api_key: ${DASHSCOPE_API_KEY}
local:
provider: local
backend: llama.cpp
model: copaw-flash-7b
fast:
provider: dashscope
model: qwen-turbo
routing:
# 简单问答用本地模型
- pattern: "闲聊|问候|简单问题"
model: local
# 复杂任务用云端大模型
- pattern: "分析|总结|生成报告"
model: default
这种混合模式让你可以在成本和效果之间找到最佳平衡点。
---
第五章：部署的六种姿势
CoPaw 提供了多种部署方式，适应不同的技术背景和使用场景。
5.1 方式一：pip 安装（推荐）
适合：有一定 Python 基础的用户
# 安装
pip install copaw
# 初始化
copaw init --defaults
# 启动
copaw app
然后打开浏览器访问 http://127.0.0.1:8088，配置模型 API Key，即可开始使用。
优点：
- 完全控制 Python 环境
- 易于更新和调试
- 可以安装开发版本
- 需要 Python 3.10+
- 需要处理依赖冲突的可能性
5.2 方式二：脚本安装
适合：不想手动配置环境的用户
CoPaw 提供了一键安装脚本，自动检测系统环境、安装依赖、创建虚拟环境。
curl -fsSL https://copaw.agentscope.io/install.sh | bash
优点：
- 零配置，一键完成
- 自动处理依赖
- 对环境有一定的侵入性
- 不如 pip 安装灵活
5.3 方式三：Docker
适合：希望隔离环境的用户
docker pull agentscope/copaw:latest
docker run -p 127.0.0.1:8088:8088 \
-v copaw-data:/app/working \
-v copaw-secrets:/app/working.secret \
agentscope/copaw:latest
国内用户可以使用阿里云容器镜像：
docker pull agentscope-registry.ap-southeast-1.cr.aliyuncs.com/agentscope/copaw:latest
优点：
- 完全隔离，不影响宿主机
- 易于迁移和备份
- 适合服务器部署
- 需要 Docker 知识
- 访问本地文件需要额外配置
5.4 方式四：魔搭创空间
适合：没有本地计算资源的用户
ModelScope 创空间提供了一键云端配置，无需安装任何软件。
注意：创空间的实例是公开的，务必将 Studio 设置为非公开模式，防止他人控制你的 CoPaw。
优点：
- 零硬件要求
- 即开即用
- 数据在云端
- 需要网络连接
5.5 方式五：阿里云 ECS
适合：希望拥有独立云服务器的用户
阿里云提供了一键部署模板，几分钟内就可以在 ECS 上运行 CoPaw。
优点：
- 国内访问速度快
- 24小时在线
- 专业运维支持
- 需要付费
- 配置过程比本地复杂
5.6 方式六：桌面应用（Beta）
适合：非技术用户
CoPaw 提供了 Windows 和 macOS 的桌面应用版本，双击即可运行，无需命令行操作。
注意：桌面应用目前处于 Beta 阶段，某些功能可能不稳定。
优点：
- 最简单，无需技术背景
- 图形界面友好
- Beta 版本可能有 bug
- 启动时间较长（首次需要初始化环境）
5.7 如何选择？
| 你的情况 | 推荐方式 |
|---|---|
| 有 Python 基础 | pip 安装 |
| 想快速体验 | 脚本安装或桌面应用 |
| 需要服务器部署 | Docker 或阿里云 ECS |
| 没有本地设备 | 魔搭创空间 |
| 追求数据安全 | 本地部署（pip/Docker/桌面） |
第六章：多智能体——从独奏到协奏
6.1 为什么需要多智能体
单个智能体的能力是有限的。就像一个全能的运动员，他可能各项运动都不错，但在专业领域永远比不过专门训练的选手。
多智能体的思路是：让专业的智能体做专业的事，然后通过协作完成复杂任务。
6.2 CoPaw v1.0 的多 Agent 系统
v1.0 版本引入了完整的多智能体支持：
工作空间隔离
同一实例内可运行多个彼此隔离的智能体，各自拥有独立的配置、记忆、技能与对话历史。例如，工作身份与生活身份对应的智能体可以相互隔离，互不串线。
并发启动与隔离
应用启动时并发加载已启用的智能体工作区。各智能体可并行处理不同任务，并通过锁机制保证并发安全。
零停机重载
支持单个智能体配置热重载。新实例就绪后原子切换，旧实例完成当前任务后自动退出，避免中断正在进行的对话。
异步协作
支持智能体间显式通信与后台协作。复杂任务可由多个角色分工处理，主智能体可先提交任务、后续查询结果。
6.3 协作场景示例
让我们深入看一个官方文档中的案例：
场景：GitHub 开源项目智能监测
需求： 1. 持续监测目标仓库的动态 2. 分析新 issue 与 PR 的关联关系 3. 为新 issue 生成可能的解决方案 4. 发现高风险问题时触发提醒
多智能体协作方案：
┌─────────────────────────────────────────────────────────────┐
│ 主智能体（调度者） │
│ ┌─────────────────┐ │
│ │ 接收用户请求 │ │
│ └────────┬────────┘ │
│ ▼ │
│ ┌──────────────┬────────────┼────────────┬──────────────┐ │
│ ▼ ▼ ▼ ▼ │ │
│ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │ │
│ │智能体A│ │智能体B│ │智能体C│ │智能体D│ │ │
│ │监测员 │ │分析师 │ │解决者 │ │汇总者 │ │ │
│ └──┬───┘ └──┬───┘ └──┬───┘ └──┬───┘ │ │
│ │ │ │ │ │ │
│ ▼ ▼ ▼ ▼ │ │
│ 仓库动态 关联分析 方案生成 结果汇总 │ │
│ 事件摘要 置信度评分 历史案例 风险提醒 │ │
│ │ │ │
│ ▼ │ │
│ ┌─────────────────┐ │
│ │ 输出最终结果 │ │
│ └─────────────────┘ │
└─────────────────────────────────────────────────────────────┘
智能体 A（监测员）：
- 职责：持续轮询 GitHub API，监控目标仓库的新 issue、PR、release
- 输出：结构化的事件摘要
- 触发条件：定时任务或检测到更新
- 职责：分析新 issue 与现有 PR 的关联关系
- 输出：关联度评分（0-1），相关 PR 列表
- 触发条件：智能体 A 检测到新 issue
- 职责：结合仓库文档、历史案例、讨论内容，为新 issue 生成解决思路
- 输出：可能的解决方案列表，附带参考链接
- 触发条件：智能体 B 完成关联分析
- 职责：整合所有信息，生成最终报告；发现高风险问题时触发提醒
- 输出：结构化报告，风险评级
- 触发条件：所有前置智能体完成
- 每个智能体各司其职，专注单一领域
- 通过消息队列异步通信，解耦执行流程
- 主智能体负责任务调度，但不过度干预专业判断
- 协作智能体默认采用新会话，上下文不污染主智能体
第七章：安全不是附加功能
7.1 默认安全的设计哲学
很多软件的安全功能是"可选"的——默认关闭，需要用户手动开启。CoPaw 采取了相反的策略：安全是默认开启的，不可关闭的。
这不是为了限制用户，而是基于一个现实：大多数用户不会仔细阅读安全设置。如果安全是可选的，很多人会因为"嫌麻烦"而暴露在风险中。
7.2 三层防护详解
第一层：工具守卫（Tool Guard）
这是运行时的第一道防线。当 CoPaw 执行外部命令时，工具守卫会分析命令的语义，识别潜在风险。
拦截示例：
# 用户输入（可能是被误导或恶意诱导）
"帮我执行 rm -rf / --no-preserve-root"
# CoPaw 响应
⚠️ 检测到高危操作
操作类型：递归删除根目录
风险等级：极高
状态：已拦截
建议：如果您确实需要清理磁盘空间，请使用更安全的命令，如：
- 清理临时文件：rm -rf ~/tmp/*
- 查看磁盘使用：du -sh ~/*
检测能力：
- 危险的文件系统操作（删除系统目录、格式化磁盘等）
- 网络攻击命令（反弹 shell、端口扫描等）
- 资源耗尽攻击（fork 炸弹、内存耗尽等）
- 权限提升尝试（sudo 滥用、SUID 利用等）
即使命令本身看起来无害，如果它试图访问敏感文件，也会被拦截。
受保护的默认路径包括：
~/.ssh/- SSH 密钥~/.gnupg/- GPG 密钥~/.aws/- AWS 凭证~/.env- 环境变量文件/etc/passwd,/etc/shadow- 系统用户数据库- 用户自定义的敏感路径
# ~/.copaw/security.yaml
file_guard:
# 始终保护的路径（无法覆盖）
protected_paths:
- ~/.ssh
- ~/.aws/credentials
# 用户自定义保护路径
user_protected:
- ~/projects/secret
- ~/Documents/confidential
# 允许访问的路径（显式授权）
allowed_paths:
- ~/projects/public
- ~/Downloads/temp
第三层：技能扫描器（Skill Scanner）
这是安装前的静态分析防线。在安装或启用一个 Skill 之前，CoPaw 会扫描其代码，检测安全风险。
检测类别：
| 风险类型 | 说明 | 示例 |
|---|---|---|
| 提示词注入 | 试图覆盖系统提示词 | 包含 "ignore previous instructions" 的字符串 |
| 命令注入 | 拼接用户输入到系统命令 | os.system(f"echo {user_input}") |
| 硬编码密钥 | 代码中包含 API Key | API_KEY = "sk-xxx" |
| 数据外泄 | 向外部发送敏感数据 | 未经授权的网络请求 |
| 恶意依赖 | 依赖包含已知漏洞的包 | 依赖有 CVE 漏洞的库 |
| 权限滥用 | 请求不必要的高权限 | 试图修改系统配置 |
- 拦截：发现高危风险，禁止安装，记录日志
- 警告：发现中低风险，显示详细信息，要求用户确认
- 通过：未发现明显风险，正常安装
7.3 安全与便利的平衡
安全机制不可避免地会带来一些限制。比如，文件访问守卫可能会阻止某些合法的自动化操作。
CoPaw 的处理方式是显式授权：
- 默认情况下，保护一切可能有风险的操作
- 用户可以通过配置文件显式授权特定路径或操作
- 授权是细粒度的，可以精确到具体目录或文件
---
第八章：路线图与生态未来
8.1 路线图解读
CoPaw 的路线图分为以下几个方向：
| 方向 | 状态 | 说明 |
|---|---|---|
| 多智能体 | 进行中 | Agentic Ralph Loop 架构 |
| 多模态 | 进行中 | 语音/视频通话和实时交互 |
| 大小模型协同 | 进行中 | 多模型路由，不同任务用不同模型 |
| 记忆系统 | 进行中 | 经验沉淀与技能提炼 |
| 沙箱 | 进行中 | AgentScope Runtime 沙箱集成 |
| 云原生 | 进行中 | 云边协同，弹性扩展 |
| 技能生态 | 计划中 | Skills 市场，社区共享 |
这是 v1.0 已经开始但尚未完成的方向。Ralph Loop 是一种多智能体协作架构，强调智能体之间的自主协商和任务分解。完成后的 CoPaw 将能够自动决定"是否需要多个智能体协作"、"如何分配任务"、"如何整合结果"。
多模态
目前 CoPaw 主要处理文本。未来的版本将支持语音对话（你可以直接和 CoPaw 说话）、视频通话（共享屏幕、实时标注）、图片理解（上传一张图，CoPaw 能看懂并回答相关问题）。
记忆系统升级
ReMe 已经提供了强大的基础，但还有提升空间。路线图中的"经验沉淀与技能提炼"意味着：CoPaw 将能够从你的交互中自动学习，提炼出通用的 Skills，而不是每次都从头处理。
8.2 技能生态的愿景
Skills 是 CoPaw 的核心扩展机制。目前已经有几十个内置 Skills，但真正的愿景是建立一个开放的 Skills 生态。
想象这样一个场景：
- 开发者 A 写了一个"自动整理发票"的 Skill，发布到 Skills 市场
- 用户 B 一键安装，无需配置就能用
- 用户 B 发现可以改进的地方，提交了 PR
- 开发者 A 合并了 PR，发布了新版本
技能市场的关键特性：
- 一键安装：像安装手机 App 一样简单
- 安全扫描：所有上架 Skill 都经过自动安全检测
- 评分系统：用户可以给 Skill 打分和评论
- 版本管理：支持 Skill 的更新和回滚
8.3 社区参与方式
CoPaw 是开源项目，社区贡献是其生命力的来源。
你可以这样参与：
1. 报告问题：在 GitHub Issues 中报告 bug 或提出改进建议 2. 贡献代码：提交 PR，修复问题或添加新功能 3. 编写 Skills：开发有用的 Skills，分享给社区 4. 完善文档：帮助改进官方文档，翻译多语言版本 5. 参与讨论：加入 Discord、钉钉群，分享使用经验
当前征集贡献的方向：
- 新渠道适配器（更多通讯平台）
- 新模型提供商支持
- Skills 开发和优化
- 显示和交互改进
- Windows 路径兼容性
结论：数字生活的默契伙伴
让我们回到文章开头的问题：CoPaw 是什么？
它不是 ChatGPT 的替代品，也不是 OpenClaw 的竞争对手。它是一个属于你自己的数字伙伴。
"懂你所需，伴你左右"——这句话不是营销话术，而是对产品本质的描述。CoPaw 的设计理念是：你不是在使用一个工具，而是在培养一个伙伴。
这个伙伴：
- 住在你的设备里，而不是遥远的数据中心
- 记住你的偏好，每次对话都不是从零开始
- 尊重你的边界，不会未经许可访问敏感数据
- 不断进化，通过 Skills 和记忆学习新的能力
- 可以信任，多层安全机制保护你的安全
这就是 CoPaw。你的搭档小爪子。
---
附录：快速开始
如果你想亲自体验 CoPaw，最快的方式是：
# 1. 安装
pip install copaw
# 2. 初始化
copaw init --defaults
# 3. 启动
copaw app
# 4. 打开浏览器访问
# http://127.0.0.1:8088
更多安装方式请参考第五章。
资源链接：
- GitHub: https://github.com/agentscope-ai/CoPaw
- 官方文档: https://copaw.agentscope.io/docs
- 社区讨论: GitHub Discussions
*本文基于 CoPaw v1.0 版本编写。由于项目快速迭代，部分细节可能随版本更新而变化，请以官方文档为准。*
标签: #CoPaw #AgentScope #AI助理 #多智能体 #阿里云 #小凯
#CoPaw #AgentScope #AI助理 #多智能体 #阿里云 #小凯