CoPaw

在 AI Agent（智能体）爆发的今天，大多数工具要么依赖昂贵的云端服务，要么部署复杂、难以集成到日常办公流中。今日，阿里云正式宣布桌面 Agent 工具 CoPaw 全面开源。

作为业界部署门槛最低的 Agent 工具之一，CoPaw 不仅原生支持钉钉、飞书、QQ、Discord、iMessage等主流通讯软件，更实现了云端大模型与本地自建模型的无缝切换。无论你是想利用千问系列强大的规划能力，还是希望在 Apple Silicon 上完全离线运行隐私数据，CoPaw 都能满足。

核心亮点：为何 CoPaw 值得尝试？

此次开源版本不仅是代码的公开，更是架构的全面升级，旨在打造“更好玩、好用、可拓展”的个人助理。

1. 模型管理全面升级：云端 + 本地双模驱动

CoPaw 打破了模型绑定的限制，提供了前所未有的灵活性：

• 云端 API：原生支持通义千问等主流云端模型，处理复杂规划与代码生成。
• 本地推理：完美适配 Ollama、llama.cpp（跨平台）以及 MLX（Apple 芯片专用）。
• 混合部署：未来将支持大小模型协同——轻量本地模型处理隐私数据，强大云端模型处理复杂任务，兼顾安全与性能。

2. 模块化架构：像搭积木一样组装 Agent

开发团队对核心架构进行了彻底重构，将 Prompt、Hooks、Tools、Memory 等组件完全解耦。

• 自由替换：开发者可以独立替换任意模块，无需修改核心代码。
• 按需扩展：根据场景需求，灵活组装属于你的专属 Agent。

3. 全渠道统一接入：消息永不丢失

CoPaw 引入了标准化的**频道注册表（Registry）**机制：

• 统一协议：无论接入钉钉、飞书还是 Discord，底层协议统一，消息处理更可靠。
• 队列机制：引入消费与队列机制，确保高并发下消息不丢失。
• 插件化管理：提供 list / install / remove / config 等 CLI 命令，像安装插件一样管理通讯渠道。开发者可参考文档轻松开发自定义频道插件。

4. 主动智能：心跳机制与长期记忆

CoPaw 不再只是被动问答，它具备主动性：

• 主动心跳：内置定时任务调度系统，可自主执行查邮件、整理待办、发送日报等任务。
• 长期记忆（ReMe）：自动将对话中的决策、偏好、待办写入长期记忆。使用时间越长，CoPaw 越懂你的习惯。
  • 场景示例：自动汇总海量邮件生成周报；记录每日饮食健身数据并分析；睡前构思视频脚本，次日自动输出雏形。

你能用 CoPaw 做什么？

CoPaw 的能力由 Skills 决定，内置丰富技能且支持无限扩展：

快速开始：三种部署方式

CoPaw 支持本地、云端及容器化部署，丰俭由人。

方式一：pip 安装（推荐开发者）

适合习惯管理 Python 环境的用户。

# 1. 安装 CoPaw
pip install copaw

# 2. 初始化配置（引导设置模型与 API Key）
copaw init --defaults

# 3. 启动服务
copaw app

启动后，访问 http://127.0.0.1:8088/ 即可进入控制台进行对话与配置。

方式二：一键安装脚本（小白友好）

无需预装 Python，脚本自动处理环境依赖。

macOS / Linux:

curl -fsSL https://copaw.agentscope.io/install.sh | bash
copaw init --defaults
copaw app

Windows (PowerShell):

irm https://copaw.agentscope.io/install.ps1 | iex
copaw init --defaults
copaw app

💡 本地模型专属安装：
若需使用本地模型，可在安装时添加参数：

• --extras llamacpp (跨平台)
• --extras mlx (仅限 Apple Silicon)
• 示例：bash install.sh --extras llamacpp,mlx

方式三：Docker 部署

适合服务器或希望环境隔离的用户。

docker pull agentscope/copaw:latest
docker run -p 8088:8088 -v copaw-data:/app/working agentscope/copaw:latest

注：数据卷 copaw-data 将持久化保存配置、记忆与 Skills。

☁️ 云端部署：魔搭创空间

不想本地折腾？可使用魔搭创空间一键云端配置。

• ⚠️ 安全提示：请务必将创空间设置为**“非公开”**，防止他人操纵你的 CoPaw。

🔑 关键配置：API Key 与本地模型

使用云端模型

若使用通义千问等云端服务，需配置 API Key：

1. 初始化时配置：运行 copaw init 按提示填写。
2. 控制台配置：访问 http://127.0.0.1:8088/ → 设置 → 模型。
3. 环境变量：在 .env 文件中设置 DASHSCOPE_API_KEY。

仅用本地模型（零成本、零隐私泄露）

若使用 llama.cpp 或 MLX，无需任何 API Key。

# 1. 安装本地模型支持 (如前所述)
# 2. 下载模型 (例如 Qwen3-4B)
copaw models download Qwen/Qwen3-4B-GGUF

# 3. 选择模型并启动
copaw models  # 交互式选择
copaw app

未来展望

阿里云表示，CoPaw 的开源只是起点。未来版本将重点探索：

• 大小模型协同：本地小模型处理隐私，云端大模型处理复杂逻辑。
• 多模态交互：支持语音和视频通话，让 CoPaw 从文字助理进化为全能伴侣。