在本地云端都能部署的专属个人AI助手 CoPaw

CoPaw 是一款轻量易上手的个人AI助手，安装流程简单，能部署在本地设备也能部署在云端服务器。CoPaw 支持多款聊天应用的对接，功能拓展性强，数据全程由自己掌控，不用上传至第三方云端，能在多个使用场景中发挥作用。

CoPaw的核心能力

1、多渠道对接：支持钉钉、飞书、QQ、Discord、iMessage等多款聊天应用，一个AI助手就能实现多平台的消息互通，按需连接对应的渠道即可使用。

2、自主掌控数据：记忆功能和个性化配置都由自己管理，本地和云端都能部署，还能给任意对接渠道设置定时提醒，各类数据都保存在自己的部署环境中。

3、灵活的技能体系：内置cron定时任务功能，工作区中能自定义技能，且自定义技能会自动加载，使用过程无绑定限制，能根据需求拓展各类功能。

CoPaw能实现的各类功能

社交娱乐

整理小红书、知乎、Reddit等平台的热门帖子每日摘要，生成哔哩哔哩、YouTube等视频平台的内容总结，快速获取各类平台的核心信息。

办公提效

将各类通讯摘要发送至钉钉、飞书、QQ等办公软件，从邮箱和日历中提取联系人信息，让办公信息的整理和传递更便捷。

创作辅助

描述自己的创作目标，让CoPaw后台运行处理，第二天就能得到对应的创作初稿，为各类创作工作提供基础内容支持。

研究学习

跟踪科技、AI领域的最新资讯，搭建属于自己的知识库，能快速获取行业动态，也能沉淀个人学习和研究的相关内容。

桌面管理

整理本地文件，读取并总结各类文档内容，在聊天界面中就能发起文件调取请求，让本地文件的管理和使用更高效。

功能拓展

把技能功能和定时任务结合，打造专属的智能应用，能根据自己的使用习惯和需求，组合出适配不同场景的工具。

CoPaw 安装与部署

pip安装（推荐方式）

适合自己管理Python环境的使用者，执行以下三条命令就能完成基础安装和启动：

pip install copaw
copaw init --defaults
copaw app

安装启动后，在浏览器中打开 http://127.0.0.1:8088/ 就能进入CoPaw的控制台，在控制台中可以和CoPaw聊天，也能对智能助手进行各类配置。如果需要在钉钉、飞书、QQ等平台使用，在官方文档中查询渠道添加方法即可。

单行命令安装

无需手动安装Python，安装脚本会自动处理相关环境配置，不同系统的安装命令不同： • macOS / Linux系统：

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

• Windows（PowerShell）系统：

irm https://copaw.agentscope.io/install.ps1 | iex

安装完成后，打开新的终端执行以下命令启动：

copaw init --defaults # 也可以执行copaw init进行交互式配置
copaw app

单行安装的拓展选项

macOS / Linux系统

# 安装指定版本
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（苹果硅芯片）
bash install.sh --extras llamacpp,mlx
# 升级版本，重新运行安装命令即可
curl -fsSL ..、| bash
# 卸载
copaw uninstall # 保留配置和数据
copaw uninstall --purge # 删除所有相关内容

Windows（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/ 就能进入控制台，配置、记忆和技能相关数据都会存储在copaw-data卷中。如果需要传入API密钥（如DASHSCOPE_API_KEY），在docker run命令后添加-e VAR=value或--env-file .env即可。 该镜像为从头构建，如果需要自行构建镜像，参考scripts/README.md中的Build Docker image章节，完成后推送到自己的镜像仓库即可。

ModelScope云端一键部署

不想在本地安装的使用者，能通过ModelScope Studio实现云端一键配置。注意将自己的Studio设置为非公共状态，避免他人操控你的CoPaw。

阿里云ECS部署

想要在阿里云ECS上运行CoPaw，可通过一键部署功能实现。打开CoPaw在阿里云ECS的专属部署链接，按照页面提示操作即可。想要查看详细步骤，可参考阿里云开发者社区的《3分钟部署你的AI助理》相关内容。

从源码安装

适合开发和二次定制的使用者，执行以下命令完成安装：

# 克隆项目仓库
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

API Key配置说明

如果使用云端大语言模型（如通义千问DashScope、ModelScope），聊天前必须配置对应的API Key，未配置有效密钥的情况下CoPaw无法正常运行。

API Key的三种配置方式

1、命令行配置：运行copaw init命令时，流程中会有配置大语言模型提供商和API Key的步骤，按照终端提示选择提供商并输入密钥即可。

2、控制台配置：运行copaw app后，在浏览器打开 http://127.0.0.1:8088/，进入【设置】-【模型】，选择对应的提供商，填写API Key字段，激活该提供商和模型就能使用。

3、环境变量配置：以DashScope为例，能在shell中或工作目录的.env文件中设置DASHSCOPE_API_KEY。

部分需要额外密钥的工具（如网页搜索所需的TAVILY_API_KEY），可在控制台【设置】-【环境变量】中配置，也能参考项目的Config相关文档查看详细配置方法。 如果仅使用本地模型（llama.cpp或MLX），无需配置任何API Key。

本地模型使用方法

CoPaw支持在本地设备中运行大语言模型，全程不用依赖API密钥和云端服务，不同后端的适配场景和安装命令不同：

本地模型的基础使用步骤

1、安装对应后端后，执行命令下载模型：

copaw models download Qwen/Qwen3-4B-GGUF

2、执行命令选择已下载的模型：

copaw models

3、执行命令启动服务，就能使用本地模型运行CoPaw：

copaw app

也能直接在CoPaw的控制台界面中下载和管理本地模型，操作更直观。

CoPaw由AgentScope团队开发，背后依托AgentScope、AgentScope Runtime、ReMe等技术框架。