CoPaw

CoPaw 是一个开源的个人AI助手,可以部署在您的机器或云端,连接钉钉、飞书、QQ、Discord、iMessage等,具有可扩展的技能和本地模型支持。

PythonApache-2.0Agent
⭐ GitHubhttps://github.com/agentscope-ai/CoPaw
29,103
Star 数
+14,243
Star 增速
2026年7月28日
最后更新
3,728
点击数

📌 CoPaw 是什么?

CoPaw (Co Personal Agent Workstation) 是一个由 AgentScope 团队开发的开源、自托管的个人 AI 助手。它易于安装和部署——无论是在您自己的机器上还是在云端——并且可以与您日常使用的聊天应用无缝连接。

“CoPaw”这个名字是一个文字游戏:它代表 Co Personal Agent Workstation,并唤起“co-paw”(一个温暖的伙伴,始终在你身边)的意象。CoPaw 不仅仅是一个冰冷的生产力工具,它旨在成为您数字生活的得力助手。


🚀 主要功能

1. 多渠道支持

CoPaw 通过一个代理连接所有主要的即时通讯和协作平台:

  • 钉钉
  • 飞书
  • QQ
  • Discord
  • iMessage
  • 以及更多通过可扩展的渠道集成

2. 灵活部署

方法 描述
pip install copaw 标准 Python 安装,3 条命令快速启动
一行安装脚本 无需 Python — 安装程序自动处理一切
Docker 单条命令即可拉取并运行
ModelScope Studio 一键云端设置,无需本地安装

3. 本地模型支持

完全在您自己的硬件上运行 LLM — 无需 API 密钥或云服务:

后端 最佳用途
llama.cpp 跨平台 (macOS / Linux / Windows)
MLX Apple Silicon Macs (M1/M2/M3/M4)
copaw models download Qwen/Qwen3-4B-GGUF
copaw models   # 选择下载的模型
copaw app      # 启动服务器

4. 可扩展技能系统

  • 内置 cron 作业调度器,用于自动化任务
  • 自定义技能存储在您的工作区中,并在启动时自动加载
  • 无供应商锁定 — 您的技能,您的数据

5. 记忆与个性化

  • 由您控制的上下文管理和长期记忆
  • 定时提醒,推送到任何已连接的频道
  • 用于研究和笔记的个人知识库

6. Web 控制台 UI

一个简洁的基于浏览器的控制台,位于 http://127.0.0.1:8088/,用于:

  • 与助手直接聊天
  • 模型和 API 密钥配置
  • 频道管理
  • 环境变量设置

🛠️ 快速入门

# 安装
pip install copaw

# 使用默认值初始化
copaw init --defaults

# 启动控制台
copaw app

然后在浏览器中打开 **http://127.0.0.1:8088/**。


💡 用例

类别 示例
社交 小红书、知乎、Reddit 热门帖子的每日摘要;Bilibili/YouTube 视频摘要
生产力 推送到钉钉/飞书/QQ 的新闻通讯摘要;从电子邮件和日历中管理联系人
创意 过夜描述一个目标,早上即可获得草稿
研究 跟踪 AI/科技新闻;构建个人知识库
桌面 整理本地文件;阅读和总结文档;通过聊天请求文件
自动化 结合技能 + cron 构建您自己的代理工作流

🏗️ 架构概览

CoPaw
├── src/copaw/          # 核心 Python 包
│   ├── agent/          # 代理逻辑和记忆
│   ├── skills/         # 内置和用户技能
│   └── channels/       # 即时通讯平台集成
├── console/            # TypeScript/React Web 控制台前端
├── deploy/             # Docker 和云部署配置
├── scripts/            # 安装脚本 (bash, PowerShell)
└── website/            # 文档站点

技术栈:

  • 后端: Python 3.10–3.14,基于 AgentScope 构建
  • 前端: TypeScript + React
  • 本地推理: llama.cpp, MLX
  • 许可证: Apache 2.0

📦 安装选项

pip (推荐)

pip install copaw

一行安装 (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

Docker

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

📖 文档

完整文档:https://copaw.agentscope.io/

主题 链接
简介 docs/intro
快速入门 docs/quickstart
控制台 docs/console
频道 docs/channels
技能 docs/skills
本地模型 docs/local-models
记忆 docs/memory
CLI docs/cli

🤝 社区与链接


⚖️ 许可证

CoPaw 在 Apache License 2.0 下发布 — 可免费使用、修改和分发。