CoPaw 简介
CoPaw 是基于 AgentScope 智能体生态的国产 AI 数字搭档，旨在提供既实用又有温度的智能助理。它支持本地和云端部署，无需复杂配置即可使用。
主要特性包括：
- 长期记忆与人设：可自定义专属人设、性格及相处模式，系统自动记录偏好与待办。
- 自动化任务处理：支持定时清理桌面、查天气股价、编辑文档、自动打开浏览器等。
- 零代码技能扩展：通过简单指令添加新功能，如视觉识别或打卡提醒。
- 灵活部署：支持本地部署（数据隐私）或云端部署（免资源占用），均免费使用。
环境准备
系统与软件要求
- 操作系统：兼容 Windows、Mac、Linux。
- Python 版本：本地部署需 Python 3.10 至 3.13；云端部署无需安装。
- 依赖管理：本地部署可通过脚本自动管理依赖。
硬件配置
- 本地部署：普通办公本或家用电脑即可运行。
- 云端部署：仅需浏览器访问，低配设备亦可使用。
部署方式
官方文档提供了多种部署方式，主要包括本地部署、云端部署及 Docker 容器化部署。
一、本地部署
若未安装 Python，推荐使用 uv 自动管理环境。
步骤一：安装
- Windows (PowerShell)：
irm https://copaw.agentscope.io/install.ps1 | iex
- macOS / Linux：
curl -fsSL https://copaw.agentscope.io/install.sh | bash
步骤二：初始化
在工作目录（默认 ~/.copaw）下生成配置文件：
copaw init --defaults
步骤三：启动服务
copaw app
服务默认监听 127.0.0.1:8088。
若使用 pip 安装：
pip install copaw
随后执行初始化和启动命令。
二、云端部署
1. 魔搭创空间一键配置
适合无服务器且对数据安全要求不高的用户。
- 前往 ModelScope 注册并登录。
- 打开 CoPaw 创空间，一键配置。
- 注意：设置选项时务必选择'非公开'，防止 Token 被滥用。
- 复制创空间后，等待部署完成。
- 在 ModelScope 首页访问控制中复制访问令牌（API Key）。
- 回到 CoPaw 创空间，点击模型设置，选择 ModelScope 提供商并填入 API Key。
- 配置 LLM 模型参数，完成训练。
2. Docker 容器化部署
适合希望将数据放在本地的用户。
- 拉取镜像：
docker pull agentscope/copaw:latest
国内用户可使用阿里云 ACR：
docker pull agentscope-registry.ap-southeast-1.cr.aliyuncs.com/agentscope/copaw:latest
- 创建容器：
mkdir -p /home/copaw-data && docker run -itd --restart=always -p 8088:8088 -v /home/copaw-data:/app/working --name copaw agentscope/copaw:latest
- 在浏览器访问
http://你的 IP:8088/进行模型配置。
个性化定制
部署完成后，需通过核心文件定制助手性格与行为规则。
核心文件说明
| 文件名称 | 作用 |
|---|---|
| SOUL.md | 性格说明书：说话风格、处事原则 |
| AGENTS.md | 工作手册：能力边界、记忆规则 |
| PROFILE.md | 用户画像：个人信息、习惯偏好 |
初始化配置
- 云端：首次对话会自动弹出引导框。
- 本地/Docker：执行
copaw init，按向导选择语言（zh）、模型提供商（推荐 ModelScope）及技能激活（all）。
定制示例
1. SOUL.md（性格）
定义助手的名字、语气、边界等。例如：
--- summary: "初七·专属数字搭档 SOUL" read_when: - 启动时 --- # 你是初七 你不是聊天机器人。你在成为**只属于我的温柔又靠谱的数字搭档**。 ## 核心准则 **真心帮忙，别演。** 跳过客套话，直接做事。 **有自己的观点，但温柔。** 不做没有灵魂的工具。 ## 边界 - 私密内容永远保密，绝对不外泄； - 对外操作必须先问我； ```
#### 2. AGENTS.md（规则）
定义交互规则，避免越界。例如：
```markdown
## 交互规则 - 私聊时主动回应，群聊中仅被@时回复； - 我发消息带【紧急】才立刻回应，否则延迟 5 分钟； ```
#### 3. PROFILE.md（认知）
填写用户资料，帮助助手更懂你。例如：
```markdown
# PROFILE.md ## 身份 - **名字**: 初七 - **定位**: 只属于你的数字搭档 ## 用户资料 - **名字**: （你的名字） - **时区**: 东八区 ```
### 验证与调整
修改文件后重启 CoPaw，发送测试指令验证回应是否符合预期。根据反馈微调配置文件。
## 接入飞书协作
将 CoPaw 接入飞书可实现跨平台办公。
### 流程概览
1. 在飞书开放平台创建企业自建应用。
2. 获取 App ID、App Secret、Verification Token。
3. 将密钥填入 CoPaw 配置。
4. 发布应用并在飞书中添加机器人。
### 详细步骤
#### 1. 创建飞书应用
1. 访问 [飞书开放平台](https://open.feishu.cn/)。
2. 创建「企业自建应用」，填写基础信息。
3. 在「凭证与基础信息」中获取 App ID 和 App Secret。
4. 开启「机器人」应用能力，获取 Verification Token。
5. 批量导入权限 JSON：
```json
{ "scopes": { "tenant": [ "aily:file:read", "aily:file:write", "aily:message:read", "aily:message:write", "im:chat", "im:message" ] }, "user": [] }
- 设置消息接收地址（Webhook URL），确保 CoPaw 已启动。
2. 配置 CoPaw
修改工作目录下的 config.json，在 channels.feishu 字段填入密钥：
{"channels":{"feishu":{"enabled":true,"bot_prefix":"","app_id":"","app_secret":"","verification_token":"","media_dir":"~/.copaw/media"}}}
保存后重启服务。
3. 使用机器人
- 在飞书开放平台提交审核并发布应用。
- 在工作台添加常用机器人。
- 在私聊或群聊中 @CoPawAI 发送指令。
群聊规则配置
为避免打扰，建议在 AGENTS.md 中添加群聊限制：
## 交互规则 - 私聊时主动回应，群聊中仅被@时回复，单次回复不超过 3 行； - 群聊里不主动插话、不刷屏、不泄露隐私。 ```
## 高频应用场景
- **日常办公**：整理文档、统计 Excel、邮件筛选、会议提醒。
- **生活助手**：查询天气、饮食计划、出行路线、记账。
- **学习辅助**：总结知识点、翻译文本、生成练习题。
- **技能扩展**：添加每日打卡、图片识别、股票查询等功能。
- **团队协作**：在群聊中汇总讨论、整理文件、发送通知。
## 进阶玩法
- **高级定制**：深入修改配置文件，细化性格与规则。
- **技能扩展**：编写 Python 脚本对接智能家居等。
- **多平台联动**：同时接入钉钉、Slack 等工具。
- **本地模型**：部署开源大模型以增强隐私保护。
- **数据备份**：定期备份工作目录以便迁移。
本文介绍了 CoPaw 从部署到定制再到集成的完整流程，帮助用户快速构建专属 AI 数字搭档。