# CoPaw **Repository Path**: corffee/CoPaw ## Basic Information - **Project Name**: CoPaw - **Description**: No description available - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-03-04 - **Last Updated**: 2026-03-04 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
# CoPaw [![GitHub 仓库](https://img.shields.io/badge/GitHub-仓库-black.svg?logo=github)](https://github.com/agentscope-ai/CoPaw) [![PyPI](https://img.shields.io/pypi/v/copaw?color=3775A9&label=PyPI&logo=pypi)](https://pypi.org/project/copaw/) [![文档](https://img.shields.io/badge/文档-在线-green.svg?logo=readthedocs&label=Docs)](https://copaw.agentscope.io/) [![Python 版本](https://img.shields.io/badge/python-3.10%20~%20%3C3.14-blue.svg?logo=python&label=Python)](https://www.python.org/downloads/) [![最后提交](https://img.shields.io/github/last-commit/agentscope-ai/CoPaw)](https://github.com/agentscope-ai/CoPaw) [![许可证](https://img.shields.io/badge/license-Apache%202.0-red.svg?logo=apache&label=%E8%AE%B8%E5%8F%AF%E8%AF%81)](LICENSE) [![代码风格](https://img.shields.io/badge/code%20style-black-black.svg?logo=python&label=%E4%BB%A3%E7%A0%81%E9%A3%8E%E6%A0%BC)](https://github.com/psf/black) [![GitHub Star](https://img.shields.io/github/stars/agentscope-ai/CoPaw?style=flat&logo=github&color=yellow&label=Star)](https://github.com/agentscope-ai/CoPaw/stargazers) [![GitHub Fork](https://img.shields.io/github/forks/agentscope-ai/CoPaw?style=flat&logo=github&color=purple&label=Fork)](https://github.com/agentscope-ai/CoPaw/network) [![DeepWiki](https://img.shields.io/badge/DeepWiki-Ask_Devin-navy.svg?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACwAAAAyCAYAAAAnWDnqAAAAAXNSR0IArs4c6QAAA05JREFUaEPtmUtyEzEQhtWTQyQLHNak2AB7ZnyXZMEjXMGeK/AIi+QuHrMnbChYY7MIh8g01fJoopFb0uhhEqqcbWTp06/uv1saEDv4O3n3dV60RfP947Mm9/SQc0ICFQgzfc4CYZoTPAswgSJCCUJUnAAoRHOAUOcATwbmVLWdGoH//PB8mnKqScAhsD0kYP3j/Yt5LPQe2KvcXmGvRHcDnpxfL2zOYJ1mFwrryWTz0advv1Ut4CJgf5uhDuDj5eUcAUoahrdY/56ebRWeraTjMt/00Sh3UDtjgHtQNHwcRGOC98BJEAEymycmYcWwOprTgcB6VZ5JK5TAJ+fXGLBm3FDAmn6oPPjR4rKCAoJCal2eAiQp2x0vxTPB3ALO2CRkwmDy5WohzBDwSEFKRwPbknEggCPB/imwrycgxX2NzoMCHhPkDwqYMr9tRcP5qNrMZHkVnOjRMWwLCcr8ohBVb1OMjxLwGCvjTikrsBOiA6fNyCrm8V1rP93iVPpwaE+gO0SsWmPiXB+jikdf6SizrT5qKasx5j8ABbHpFTx+vFXp9EnYQmLx02h1QTTrl6eDqxLnGjporxl3NL3agEvXdT0WmEost648sQOYAeJS9Q7bfUVoMGnjo4AZdUMQku50McDcMWcBPvr0SzbTAFDfvJqwLzgxwATnCgnp4wDl6Aa+Ax283gghmj+vj7feE2KBBRMW3FzOpLOADl0Isb5587h/U4gGvkt5v60Z1VLG8BhYjbzRwyQZemwAd6cCR5/XFWLYZRIMpX39AR0tjaGGiGzLVyhse5C9RKC6ai42ppWPKiBagOvaYk8lO7DajerabOZP46Lby5wKjw1HCRx7p9sVMOWGzb/vA1hwiWc6jm3MvQDTogQkiqIhJV0nBQBTU+3okKCFDy9WwferkHjtxib7t3xIUQtHxnIwtx4mpg26/HfwVNVDb4oI9RHmx5WGelRVlrtiw43zboCLaxv46AZeB3IlTkwouebTr1y2NjSpHz68WNFjHvupy3q8TFn3Hos2IAk4Ju5dCo8B3wP7VPr/FGaKiG+T+v+TQqIrOqMTL1VdWV1DdmcbO8KXBz6esmYWYKPwDL5b5FA1a0hwapHiom0r/cKaoqr+27/XcrS5UwSMbQAAAABJRU5ErkJggg==)](https://deepwiki.com/agentscope-ai/CoPaw) [![Discord](https://img.shields.io/badge/Discord-Join_Us-blueviolet.svg?logo=discord)](https://discord.gg/eYMpfnkG8h) [![钉钉群](https://img.shields.io/badge/DingTalk-Join_Us-orange.svg)](https://qr.dingtalk.com/action/joingroup?code=v1,k1,OmDlBXpjW+I2vWjKDsjvI9dhcXjGZi3bQiojOq3dlDw=&_dt_no_comment=1&origin=11) [[文档](https://copaw.agentscope.io/)] [[English](README.md)]

CoPaw Logo

懂你所需，伴你左右。

你的AI个人助理；安装极简、本地与云上均可部署；支持多端接入、能力轻松扩展。 > **核心能力：** > > **全域触达** — 钉钉、飞书、QQ、Discord、iMessage 等频道，一个 CoPaw 按需连接。 > > **由你掌控** — 记忆与个性化由你掌控，本地或云端均可；定时与协作发往指定频道。 > > **Skills 扩展** — 内置定时任务，自定义技能目录，CoPaw 自动加载，无绑定。 > >
> 你可以用 CoPaw 做什么 > >
> > - **社交媒体**：每日热帖摘要（小红书、知乎、Reddit），B 站/YouTube 新视频摘要。 > - **生产力**：邮件与 Newsletter 精华推送到钉钉/飞书/QQ，邮件与日历整理联系人。 > - **创意与构建**：睡前说明目标、自动执行，次日获得雏形；从选题到成片全流程。 > - **研究与学习**：追踪科技与 AI 资讯，个人知识库检索复用。 > - **桌面与文件**：整理与搜索本地文件、阅读与摘要文档，在会话中索要文件。 > - **探索更多**：用 Skills 与定时任务组合成你自己的 agentic app。 > >
--- ## 新闻 [2026-03-02] 我们发布了 v0.0.4！完整更新说明见 [v0.0.4 发布说明](https://github.com/agentscope-ai/CoPaw/releases/tag/v0.0.4)。 - **[v0.0.4]** **FEAT：** Telegram 频道；OpenAI 与 Azure OpenAI 作为内置模型提供商；Ollama SDK；coding-plan 提供商；模型连接测试；心跳监控面板；CORS 配置；钉钉与飞书支持音频文件。 - **[v0.0.4]** **FEAT：** 基于 token 的记忆压缩；文件块处理；嵌入配置；tool_choice 行为统一。 - **[v0.0.4]** **BUGFIX：** Windows 路径；空 tool call 处理；控制台工作区 UI；Ollama URL 与连通性；MCP 传输；浏览器资源占用；静态资源 MIME 类型；API 请求头；Playwright Docker；心跳解析；纯媒体消息排队。 - **[v0.0.4]** **RELS：** 安装脚本（含 PowerShell）；Docker 指南；频道 CLI 文档；飞书 SOCKS 代理；MCP 与运行时文档；FAQ（中/英）；Skill 编写指南；CONTRIBUTING；控制台文档；网站优化。 - **[v0.0.4]** **COMM：** 感谢新贡献者：[@ekzhu](https://github.com/ekzhu)、[@fancyboi999](https://github.com/fancyboi999)、[@zhaozhuang521](https://github.com/zhaozhuang521)、[@hobostay](https://github.com/hobostay)、[@dhbxs](https://github.com/dhbxs)、[@longway-code](https://github.com/longway-code)、[@ydlstartx](https://github.com/ydlstartx)、[@LudovicoYIN](https://github.com/LudovicoYIN)、[@fenixc9](https://github.com/fenixc9)、[@dittotang](https://github.com/dittotang)、[@forestxieCode](https://github.com/forestxieCode)、[@yongtenglei](https://github.com/yongtenglei)、[@kerwin612](https://github.com/kerwin612)、[@luixiao0](https://github.com/luixiao0)、[@gongpx20069](https://github.com/gongpx20069)。 --- ## 目录 > **推荐阅读：** > > - **我想三条命令跑起来**： [快速开始](#快速开始) → 浏览器打开控制台。 > - **我想在钉钉 / 飞书 / QQ 里聊**： [快速开始](#快速开始) → [频道配置](https://copaw.agentscope.io/docs/channels)。 > - **我不想装 Python**：[一键安装](#一键安装beta持续完善中) 自动管理 Python，或使用 [魔搭一键配置](https://modelscope.cn/studios/fork?target=AgentScope/CoPaw) 云端部署。 - [新闻](#新闻) - [快速开始](#快速开始) - [API Key](#api-key) - [本地模型](#本地模型) - [文档](#文档) - [路线图](#路线图) - [参与贡献](#参与贡献) - [从源码安装](#从源码安装) - [为什么叫 CoPaw？](#为什么叫-copaw) - [由谁构建](#由谁构建) - [许可证](#许可证) --- ## 快速开始 ### pip 安装 (推荐) 如果你习惯自行管理 Python 环境： ```bash pip install copaw copaw init --defaults copaw app ``` 在浏览器打开 **http://127.0.0.1:8088/** 即可使用控制台（与 CoPaw 对话、配置 Agent）。若要在钉钉、飞书、QQ 等 app 内对话，请在 [文档](https://copaw.agentscope.io/docs/channels) 中接入频道。 ![Console](https://img.alicdn.com/imgextra/i4/O1CN01Q0kWkE1WlHCNXeUlb_!!6000000002828-2-tps-3822-2070.png) ### 一键安装（beta，持续完善中） 无需预装 Python — 安装脚本自动处理一切： **macOS / Linux：** ```bash curl -fsSL https://copaw.agentscope.io/install.sh | bash ``` 如需安装 Ollama 支持： ```bash curl -fsSL https://copaw.agentscope.io/install.sh | bash -s -- --extras ollama ``` 如需安装多个扩展（例如 Ollama + llama.cpp）： ```bash curl -fsSL https://copaw.agentscope.io/install.sh | bash -s -- --extras ollama,llamacpp ``` **Windows（PowerShell）：** ```powershell irm https://copaw.agentscope.io/install.ps1 | iex ``` 然后打开新终端并运行： ```bash 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 Hub**（`agentscope/copaw`）。镜像 tag：`latest`（稳定版）；`pre`（PyPI 预发布版）。 ```bash docker pull agentscope/copaw:latest docker run -p 8088:8088 -v copaw-data:/app/working agentscope/copaw:latest ``` 国内用户也可选用阿里云容器镜像服务 (ACR)：`agentscope-registry.ap-southeast-1.cr.aliyuncs.com/agentscope/copaw`（tag 相同）。 然后在浏览器打开 **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](scripts/README.md#build-docker-image) 中的「Build Docker image」小节，构建后推送到你的镜像仓库。 ### 使用魔搭创空间 **不想本地安装？** 使用 [魔搭创空间](https://modelscope.cn/studios/fork?target=AgentScope/CoPaw) 一键云端配置。请将创空间设为 **非公开**，否则他人可能操纵你的 CoPaw。 ### 部署到阿里云 ECS 若希望将 CoPaw 部署在阿里云上，可使用阿里云 ECS 一键部署：打开 [CoPaw 阿里云 ECS 部署链接](https://computenest.console.aliyun.com/service/instance/create/cn-hangzhou?type=user&ServiceId=service-1ed84201799f40879884) 按页面提示操作即可。详细步骤见 [阿里云开发者社区：CoPaw 3 分钟部署你的 AI 助理](https://developer.aliyun.com/article/1713682)。 --- ## 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`）可在控制台 **设置 → 环境变量** 中配置，详见 [配置](https://copaw.agentscope.io/docs/config)。 > **仅用本地模型？** 若使用 [本地模型](#本地模型)（llama.cpp 或 MLX），则**无需**任何 API Key。 --- ## 本地模型 CoPaw 可在本机完全本地运行大模型，无需 API Key 或云端服务。 | 后端 | 适用场景 | 安装 | | ------------- | --------------------------------- | -------------------------------------------------------------------- | | **llama.cpp** | 跨平台（macOS / Linux / Windows） | `pip install 'copaw[llamacpp]'` 或 `bash install.sh --extras llamacpp` | | **MLX** | Apple Silicon（M1/M2/M3/M4） | `pip install 'copaw[mlx]'` 或 `bash install.sh --extras mlx` | | **Ollama** | 跨平台（需要 Ollama 服务运行） | `pip install 'copaw[ollama]'` 或 `bash install.sh --extras ollama` | 安装后下载模型并开始对话： ```bash copaw models download Qwen/Qwen3-4B-GGUF copaw models # 选择已下载的模型 copaw app # 启动服务 ``` 也可在控制台界面中下载与管理本地模型。 --- ## 文档 | 主题 | 说明 | | --------------------------------------------------------- | ------------------------------------ | | [项目介绍](https://copaw.agentscope.io/docs/intro) | CoPaw 是什么、怎么用 | | [快速开始](https://copaw.agentscope.io/docs/quickstart) | 安装与运行（本地或魔搭创空间） | | [控制台](https://copaw.agentscope.io/docs/console) | Web 界面：对话与 Agent 配置 | | [频道配置](https://copaw.agentscope.io/docs/channels) | 钉钉、飞书、QQ、Discord、iMessage 等 | | [心跳](https://copaw.agentscope.io/docs/heartbeat) | 定时自检与摘要 | | [本地模型](https://copaw.agentscope.io/docs/local-models) | 使用 llama.cpp 或 MLX 本地运行模型 | | [CLI](https://copaw.agentscope.io/docs/cli) | 初始化、定时任务、Skills、清理 | | [Skills](https://copaw.agentscope.io/docs/skills) | 扩展与自定义能力 | | [FAQ](https://copaw.agentscope.io/docs/faq) | 常见问题与报错排查 | | [记忆](https://copaw.agentscope.io/docs/memory) | 上下文管理与长期记忆 | | [配置与工作目录](https://copaw.agentscope.io/docs/config) | 工作目录与配置文件 | 完整文档见本仓库 [website/public/docs/](website/public/docs/)。 --- ## 路线图 | 方向 | 事项 | 状态 | | --- | --- | --- | | 横向拓展 | 更多频道、模型、Skills、MCP 等 — **欢迎社区贡献** | 征集中 | | 已有功能扩展与完善 | 展示优化、下载提示、Windows 路径兼容等 — **欢迎社区贡献** | 征集中 | | 兼容性与易用性 | 应用级打包（DMG、EXE） | 进行中 | | | 一键部署：内置依赖、dev 扩展、安装/升级教程 | 进行中 | | 版本发布与贡献规范 | 贡献文档与测试框架 | 进行中 | | | 对社区贡献的积极响应 | 进行中 | | | Vibe Coding 等 Agent 的贡献引导 | 计划中 | | Bug 修复与功能增强 | 消息折叠/隐藏 | 计划中 | | | Skills 与 MCP 运行时安装、热加载改进 | 计划中 | | | 上下文管理与压缩（长工具返回、降低 token 消耗） | 计划中 | | | 多模态支持 | 进行中 | | 安全 | Shell 执行确认 | 计划中 | | | 工具/Skills 安全性 | 计划中 | | | 可配置安全等级 | 计划中 | | 多模态 | 语音/视频通话与实时交互 | 长期规划 | | 多智能体 | 基于 [AgentScope](https://github.com/agentscope-ai/agentscope)，原生支持多智能体协作 | 长期规划 | | 沙箱 | 与 AgentScope Runtime 沙箱深度集成 | 长期规划 | | 自愈 | 守护进程 Agent，实现自动恢复与健康监控 | 长期规划 | | CoPaw 优化本地模型 | 针对 CoPaw 原生 Skills 与常见任务调优的本地模型，提升个人助理可用性 | 长期规划 | | 大小模型协同 | 本地模型处理敏感数据，云端模型负责规划与编码；兼顾隐私、性能与能力 | 长期规划 | | 云原生 | 与 AgentScope Runtime 深度集成，充分利用云端算力、存储与工具生态 | 长期规划 | | Skills 生态 | 丰富 [AgentScope Skills](https://github.com/agentscope-ai/agentscope-skills) 仓库，提升优质 Skill 的发现与使用 | 长期规划 | *状态说明：进行中 — 正在推进；计划中 — 已排期或设计中，也**欢迎贡献**；**征集中** — 我们**非常欢迎**社区参与；长期规划 — 中长期路线。* ### 参与贡献 CoPaw 在开放协作中持续演进，欢迎各种形式的参与！请参考上方 [路线图](#路线图)（尤其是标记为 **征集中** 的项）选择你感兴趣的方向，并阅读 [CONTRIBUTING](https://github.com/agentscope-ai/CoPaw/blob/main/CONTRIBUTING_zh.md) 了解如何开始。我们特别欢迎： - **横向拓展** — 新频道、模型提供商、Skills、MCP。 - **已有功能扩展与完善** — 展示与交互优化、下载提示、Windows 路径兼容等。 欢迎在 [GitHub Discussions](https://github.com/agentscope-ai/CoPaw/discussions) 参与讨论、提出想法或认领任务。 --- ## 从源码安装 ```bash 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 团队](https://github.com/agentscope-ai) · [AgentScope](https://github.com/agentscope-ai/agentscope) · [AgentScope Runtime](https://github.com/agentscope-ai/agentscope-runtime) · [ReMe](https://github.com/agentscope-ai/ReMe) --- ## 联系我们 | [Discord](https://discord.gg/eYMpfnkG8h) | [钉钉](https://qr.dingtalk.com/action/joingroup?code=v1,k1,OmDlBXpjW+I2vWjKDsjvI9dhcXjGZi3bQiojOq3dlDw=&_dt_no_comment=1&origin=11) | | ------------------------------------------------------------ | ------------------------------------------------------------ | | [Discord](https://discord.gg/eYMpfnkG8h) | [钉钉](https://qr.dingtalk.com/action/joingroup?code=v1,k1,OmDlBXpjW+I2vWjKDsjvI9dhcXjGZi3bQiojOq3dlDw=&_dt_no_comment=1&origin=11) | --- ## 许可证 CoPaw 采用 [Apache License 2.0](LICENSE) 开源协议。