CoPaw

懂你所需，伴你左右。

你的AI个人助理；安装极简、本地与云上均可部署；支持多端接入、能力轻松扩展。

核心能力：

全域触达 — 钉钉、飞书、QQ、Discord、iMessage 等频道，一个 CoPaw 按需连接。

由你掌控 — 记忆与个性化由你掌控，本地或云端均可；定时与协作发往指定频道。

Skills 扩展 — 内置定时任务，自定义技能目录，CoPaw 自动加载，无绑定。

你可以用 CoPaw 做什么
* **社交媒体**：每日热帖摘要（小红书、知乎、Reddit），B 站/YouTube 新视频摘要。 * **生产力**：邮件与 Newsletter 精华推送到钉钉/飞书/QQ，邮件与日历整理联系人。 * **创意与构建**：睡前说明目标、自动执行，次日获得雏形；从选题到成片全流程。 * **研究与学习**：追踪科技与 AI 资讯，个人知识库检索复用。 * **桌面与文件**：整理与搜索本地文件、阅读与摘要文档，在会话中索要文件。 * **探索更多**：用 Skills 与定时任务组合成你自己的 agentic app。

目录

推荐阅读：

快速开始

pip 安装 (推荐)

如果你习惯自行管理 Python 环境：

pip install copaw
copaw init --defaults
copaw app

在浏览器打开 http://127.0.0.1:8088/ 即可使用控制台（与 CoPaw 对话、配置 Agent）。若要在钉钉、飞书、QQ 等 app 内对话，请在 文档 中接入频道。

Console

一键安装（beta，持续完善中）

无需预装 Python — 安装脚本自动处理一切：

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/agentscope-ai/CoPaw/master/scripts/install.sh | bash

Windows（PowerShell）：

irm https://raw.githubusercontent.com/agentscope-ai/CoPaw/master/scripts/install.ps1 | iex

然后打开新终端并运行：

copaw init --defaults   # 或：copaw init（交互式）
copaw app
安装选项 **macOS / Linux：** ```bash # 安装指定版本 curl -fsSL ... | bash -s -- --version 0.0.2 # 从源码安装（开发/测试用） curl -fsSL ... | bash -s -- --from-source # 安装本地模型支持 bash install.sh --extras llamacpp # llama.cpp（跨平台） bash install.sh --extras mlx # MLX（Apple Silicon） bash install.sh --extras llamacpp,mlx # 升级 — 重新运行安装命令即可 curl -fsSL ... | bash # 卸载 copaw uninstall # 保留配置和数据 copaw uninstall --purge # 删除所有内容 ``` **Windows（PowerShell）：** ```powershell # 安装指定版本 irm ... | iex; .\install.ps1 -Version 0.0.2 # 从源码安装（开发/测试用） .\install.ps1 -FromSource # 安装本地模型支持 .\install.ps1 -Extras llamacpp # llama.cpp（跨平台） .\install.ps1 -Extras mlx # MLX .\install.ps1 -Extras llamacpp,mlx # 升级 — 重新运行安装命令即可 irm ... | iex # 卸载 copaw uninstall # 保留配置和数据 copaw uninstall --purge # 删除所有内容 ```

使用 Docker

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

然后在浏览器打开 http://127.0.0.1:8088/ 进入控制台。配置、记忆与 Skills 保存在 copaw-data 卷中。如需传入 API Key（如 DASHSCOPE_API_KEY），在 docker run 时添加 -e VAR=value 或 --env-file .env。

镜像从零构建。若需自行构建镜像，请参阅 scripts/README.md 中的「Build Docker image」小节，构建后推送到你的镜像仓库。

使用魔搭创空间

不想本地安装？ 使用 魔搭创空间 一键云端配置。请将创空间设为 非公开，否则他人可能操纵你的 CoPaw。

API Key

若使用云端大模型（如 DashScope、ModelScope），在开始对话前必须配置 API Key。未配置有效 Key 前，CoPaw 无法正常工作。

配置方式：

  1. copaw init — 运行 copaw init 时，会引导你配置 LLM 提供商与 API Key。按提示选择提供商并填写 Key 即可。
  2. 控制台 — 运行 copaw app 后，打开 http://127.0.0.1:8088/ → 设置 → 模型。选择提供商、填写 API Key，并启用该提供商与模型。
  3. 环境变量 — 使用 DashScope 时，可在终端或工作目录下的 .env 文件中设置 DASHSCOPE_API_KEY。

其他工具所需密钥（如网页搜索的 TAVILY_API_KEY）可在控制台 设置 → 环境变量 中配置，详见 配置。

仅用本地模型？ 若使用 本地模型（llama.cpp 或 MLX），则无需任何 API Key。

本地模型

CoPaw 可在本机完全本地运行大模型，无需 API Key 或云端服务。

后端 适用场景 安装
llama.cpp 跨平台（macOS / Linux / Windows） pip install 'copaw[llamacpp]'
MLX Apple Silicon（M1/M2/M3/M4） pip install 'copaw[mlx]'

安装后下载模型并开始对话：

copaw models download Qwen/Qwen3-4B-GGUF
copaw models # 选择已下载的模型
copaw app # 启动服务

也可在控制台界面中下载与管理本地模型。

文档

主题 说明
项目介绍 CoPaw 是什么、怎么用
快速开始 安装与运行（本地或魔搭创空间）
控制台 Web 界面：对话与 Agent 配置
频道配置 钉钉、飞书、QQ、Discord、iMessage 等
心跳 定时自检与摘要
本地模型 使用 llama.cpp 或 MLX 本地运行模型
CLI 初始化、定时任务、Skills、清理
Skills 扩展与自定义能力
记忆 上下文管理与长期记忆
配置与工作目录 工作目录与配置文件

完整文档见本仓库 website/public/docs/。

从源码安装

git clone https://github.com/agentscope-ai/CoPaw.git
cd CoPaw
pip install -e .
  • 开发（测试、格式化）：pip install -e ".[dev]"
  • 控制台（构建前端）：在项目根目录执行 cd console && npm ci && npm run build，再运行 copaw app。

为什么叫 CoPaw？

CoPaw 既是「你的搭档小爪子」（co-paw），也寓意 Co Personal Agent Workstation（协同个人智能体工作台）。我们希望它不是冰冷的工具，而是一只随时准备帮忙的温暖「小爪子」，是你数字生活中最默契的伙伴。

由谁构建

AgentScope 团队 · AgentScope · AgentScope Runtime · ReMe

许可证

CoPaw 采用 Apache License 2.0 开源协议。

参考资料

https://github.com/obra/superpowers

https://www.yeyulingfeng.com/312133.html

https://www.cnblogs.com/gyc567/p/19510203