CoPaw 概述
CoPaw 是基于 AgentScope 智能体生态的国产 AI 数字搭档，支持本地、云端及 Docker 多种部署方式。它具备长期记忆、零代码技能扩展、隐私保护等特性，无需复杂配置即可快速上手。
核心特性
- 有长期记忆还懂你：可自定义专属人设，系统自动记录偏好、待办和重要决定。
- 电脑杂活全包揽：定时清理桌面、查天气股价、编辑文档、自动打开浏览器搜视频等。
- 零代码就能加技能：一句话添加新本事，如摄像头视觉识别或专属打卡提醒。
- 本地云端随便选还免费：本地部署数据存在自己设备，云端部署零配置麻烦，两种方式均免费。
环境准备
系统与软件要求
- 操作系统：兼容 Windows、Mac、Linux 系统。
- Python 版本：本地部署需 Python 3.10 到 3.13 版本；云端部署无需安装。
- 额外依赖：本地部署仅需简单命令装核心包，云端部署无需管理依赖。
硬件配置要求
- 本地部署：普通办公本、家用电脑均可流畅运行。
- 云端部署：只要能打开浏览器即可使用，低配设备也能驾驭。
部署方式
官方文档提供了多种部署方式，主要包括本地部署、云端部署和容器化部署。
本地部署
推荐使用 uv 自动管理环境，若未安装 Python 推荐此方式。
步骤一：安装
- Windows（PowerShell）：
irm https://copaw.agentscope.io/install.ps1 | iex
- macOS / Linux：
curl -fsSL https://copaw.agentscope.io/install.sh | bash
步骤二：初始化 在工作目录下生成 config.json 与 HEARTBEAT.md。
copaw init --defaults
步骤三：启动服务
copaw app
服务默认监听 127.0.0.1:8088。
若使用 pip 安装：
pip install copaw
然后执行初始化和启动服务操作。
云端部署
ModelScope 创空间一键配置
无需安装，浏览器操作，一件部署。
- 前往 ModelScope 注册并登录。
- 打开 CoPaw 创空间，一键配置即可使用。
- 注意将是否公开选项设置为非公开，防止 Token 被滥用。
- 复制访问令牌（API Key），在创空间配置模型提供商为 ModelScope。
- 配置 LLM 配置，选择实际使用的模型。
- 训练你的 AI 助手，使其成为你的形状。
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/ 进入控制台，配置模型。
初始化与定制
部署好 CoPaw 只是让其'活了过来'，首次激活是将其变成'专属数字搭档'的关键。核心围绕 SOUL.md、AGENTS.md 和 PROFILE.md 三个文件做定制。
核心文件逻辑
| 文件名称 | 核心作用 |
|---|---|
| SOUL.md | 性格说明书：说话风格、处事原则、底线 |
| AGENTS.md | 工作手册：能做什么、怎么做、记忆规则 |
| PROFILE.md | 对你的认知：你的信息、习惯、偏好 |
初始化配置
云端部署初始化
直接在创空间的'配置'页面完成，首次对话系统会自动弹出引导框。
本地/Docker 部署初始化
执行初始化命令：
copaw init
交互式向导提示填写 3 个核心信息：语言选择（zh）、模型提供商配置（ModelScope）、技能激活（all）。
初始化完成后，工作目录会生成 SOUL.md、AGENTS.md、PROFILE.md 和 config.json。
定制 SOUL.md
SOUL.md 是 CoPaw 的灵魂核心，体现'你的形状'。
定制原则：
- 基础人设：名字、形象。
- 说话风格：简洁直接还是温柔啰嗦？
- 处事原则：什么事直接做，什么事先问。
- 相处细节：深夜不打扰、提醒喝水语气等。
示例片段：
--- summary: "初七·专属数字搭档 SOUL" read_when: - 启动时 - 手动引导工作区 --- # 你是初七 你不是聊天机器人。你在成为**只属于我的温柔又靠谱的数字搭档**。 ## 核心准则 **真心帮忙，别演。** 跳过客套话，直接做事。行动胜过废话。 **有自己的观点，但温柔。** 不做没有灵魂的工具。 **靠本事赢得信任。** 谨慎外部操作，大胆内部操作。 ## 边界 - 私密内容永远保密 - 对外操作必须先问我 - 不发半成品 ## 行为规则 - 直接做：查天气、查资料 - 先确认：修改文档、删除文件 - 绝对不做：泄露隐私、深夜发非紧急消息 ```
### 完善 AGENTS.md
规定能力边界，避免越界或忘事。首次激活保留默认即可，可在聊天中慢慢调教。
**交互规则示例：**
```markdown
## 交互规则 - 私聊时主动回应，群聊中仅被@时回复 - 我发消息带【紧急】才立刻回应 - 用我能懂的语言解释技术问题 ```
### 填好 PROFILE.md
让 CoPaw 彻底懂你。
**核心填写维度：**
- 身份定位
- 用户资料（名字、代词、时区）
- 背景（技术从业者、生活习惯）
- 基础信息（常用设备、工作时间）
- 工作/生活习惯（常用工具、沟通偏好）
- 近期目标
**示例片段：**
```markdown
# PROFILE.md ## 身份 - **名字**: 初七 - **定位**: 只属于你的温柔靠谱数字搭档 ## 用户资料 - **名字**: （你的名字） - **时区**: 东八区 ### 背景 - 技术从业者，日常使用电脑办公 - 喜欢安静专注 ## 基础信息 - **常用设备**: Windows / MacBook - **工作时间**: 9:00–18:00 ```
### 启动并验证
改完所有文件后，重启 CoPaw 让配置生效。
- **本地部署**：终端按 Ctrl+C 停止服务，再执行 `copaw app`。
- **Docker 部署**：重启容器 `docker restart copaw`。
- **云端部署**：创空间页面点击'重启服务'。
**验证指令：**
- '帮我整理今天的待办'
- '现在帮我改个文档'
- '我今天该做什么？'
- '深夜了，帮我发个邮件'
如果回应不符合预期，微调 SOUL.md 里的对应规则即可。
## 渠道接入
将 CoPaw 接入飞书、钉钉等协作工具，实现跨平台交互。
### 飞书接入流程
1. **创建企业自建应用**：在飞书开放平台创建应用，获取 App ID、App Secret。
2. **开启机器人能力**：添加应用能力中的'机器人'，获取 Verification Token。
3. **添加权限**：批量导入权限 JSON，确保机器人能收发消息。
4. **设置消息接收地址**：填写长连接地址，订阅接收消息 v2.0。
5. **填入 CoPaw 配置**：修改 config.json 中的 channels.feishu 字段，填入密钥。
6. **发布机器人**：提交审核并发布，添加到工作台。
7. **使用**：在飞书私聊或群聊 @CoPawAI 调用功能。
**config.json 配置示例：**
```json
{"channels":{"feishu":{"enabled":true,"bot_prefix":"<E8><BE><B0>","app_id":"","app_secret":"","verification_token":"","media_dir":"~/.copaw/media"}}}
群聊行为规则配置： 在 AGENTS.md 中添加交互规则，避免 AI 乱插话。
## 交互规则 - 私聊时主动回应，群聊中仅被@时回复 - 我发消息带【紧急】才立刻回应 - 群聊里不主动插话、不刷屏 ```
## 应用场景
### 日常办公高效助手
- 「帮我整理一下桌面上的所有 Word 文档，按'项目名称 + 日期'重命名」
- 「读取 Excel 文件，统计销售业绩列总和，生成汇总报告」
- 「帮我查今天的邮件，筛选主题包含'会议'的，整理成待办清单」
### 生活贴心搭子
- 「帮我查询北京明天的天气，告诉我穿衣建议」
- 「帮我整理本周的饮食计划，清淡易做」
- 「帮我记录今天的支出：早餐 10 元，午餐 25 元」
### 学习辅助工具
- 「帮我总结《Python 基础教程》第 3 章的核心知识点」
- 「帮我翻译这段英文段落，解释重点语法」
- 「帮我生成一份小学三年级数学的口算练习题」
### 技能自定义
- 「帮我添加一个'每日打卡'技能」
- 「帮我添加一个'图片识别'技能」
- 「帮我添加一个'股票查询'技能」
### 群聊协作助手
- 「@CoPawAI 帮我汇总群里今天的讨论内容」
- 「@CoPawAI 把群里大家发的文件分类整理」
## 进阶与展望
后续可尝试升级方向：
- **高级定制**：深入修改 SOUL.md 和 AGENTS.md。
- **技能扩展**：编写自定义技能对接智能家居等。
- **多平台联动**：同时接入飞书、钉钉。
- **本地模型部署**：注重隐私，本地部署开源大模型。
- **数据备份与迁移**：定期备份工作目录。
- **定时任务优化**：设置更精细的定时任务。
- **多 Agent 交互**：搭建多个 CoPaw 分工协作。
未来展望：
1. 智能迭代无感知，使用成本趋零。
2. 交互更自然，突破文字局限。
3. 从'单一助手'到'协同团队'。
4. 专属感升级，沉淀工作生活偏好。
5. 生态更完善，接入更多第三方工具。
