CoPaw 个人助理简介
CoPaw 是基于 AgentScope 智能体生态构建的国产 AI 数字搭档工具。它支持本地与云端部署，提供零代码定制能力，允许用户通过配置文件定义助手性格、记忆与行为规则，实现专属化体验。
核心特性
- 长期记忆与人设：自定义称呼、性格及相处模式，系统自动记录偏好与待办。
- 自动化任务：支持定时清理、查天气股价、编辑文档、浏览器操作等。
- 技能扩展：无需编程，通过指令添加摄像头识别、打卡提醒等新功能。
- 灵活部署：支持本地隐私部署或云端免配使用，均免费。
环境准备
系统与软件要求
- 操作系统：兼容 Windows、macOS、Linux。
- Python 版本：本地部署需 Python 3.10 至 3.13；云端部署无需安装。
- 依赖管理：本地部署推荐使用
uv自动管理，或手动安装pip。
硬件配置
- 本地部署：普通办公本即可运行，无需高性能显卡。
- 云端部署：仅需浏览器访问，低配设备亦可。
部署方式
官方文档提供了多种部署路径，主要分为本地与云端两种。
本地部署
若未安装 Python，推荐使用 uv 脚本自动管理环境。
1. 安装
Windows (PowerShell):
irm https://copaw.agentscope.io/install.ps1 | iex
macOS / Linux:
curl -fsSL https://copaw.agentscope.io/install.sh | bash
若使用 pip 安装：
pip install copaw
2. 初始化
在工作目录（默认 ~/.copaw）下生成配置文件：
copaw init --defaults
3. 启动服务
copaw app
服务默认监听 127.0.0.1:8088。
云端部署
1. 魔搭创空间
无需本地服务器，可通过 ModelScope 创空间一键部署。
- 注册并登录 ModelScope。
- 打开 CoPaw 创空间页面进行 Fork。
- 在配置页设置模型 API Key 及 LLM 参数。
- 注意将应用设置为非公开，防止 Token 消耗。
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 | 用户画像：个人信息、习惯偏好 |
1. 初始化配置
执行 copaw init 进入交互式向导，选择语言（zh）、模型提供商（如 ModelScope）及技能激活（all）。
2. 定制 SOUL.md
修改此文件以设定助手性格。例如：
--- summary: "初七·专属数字搭档 SOUL" read_when: - 启动时 - 手动引导工作区 ---
# 你是初七
你不是聊天机器人。你在成为**只属于我的温柔又靠谱的数字搭档**，形象是一只软乎乎的蜜桃猫🐱。
## 核心准则
**真心帮忙，别演。** 跳过客套话，直接做事。
**有自己的观点，但温柔。** 不做没有灵魂的工具。
3. 完善 AGENTS.md
定义交互规则与能力边界。例如限制群聊回复频率：
## 交互规则
- 私聊时主动回应，群聊中仅被@时回复，单次回复不超过 3 行；
- 我发消息带【紧急】才立刻回应，否则可延迟 5 分钟。
4. 填写 PROFILE.md
录入用户背景信息，帮助助手理解上下文：
# PROFILE.md
## 身份
- **名字**: 初七
- **定位**: 只属于你的温柔靠谱数字搭档 🐱
## 用户资料
- **名字**: (填入你的名字)
- **时区**: 东八区（UTC+8 北京时间）
- **笔记**: 喜欢简洁、高效、不啰嗦
5. 验证与调整
重启服务后发送测试指令，根据反馈微调配置文件。例如觉得回复太啰嗦，可在 SOUL.md 中增加'回复不超过 2 行'的规则。
接入协作平台
将 CoPaw 接入飞书、钉钉等工具，可实现群聊内调用。
飞书接入流程
- 创建企业自建应用：在飞书开放平台创建应用，获取 App ID、App Secret。
- 开启机器人能力：添加「机器人」应用能力，获取 Verification Token。
- 配置权限：导入必要权限 JSON（如消息读写、文件读取）。
- 设置消息接收地址：填写 CoPaw 服务地址，订阅接收消息事件。
- 发布应用：提交审核并发布。
- 配置 CoPaw：在
config.json的channels.feishu字段填入密钥信息。
{"channels":{"feishu":{"enabled":true,"bot_prefix":"<E8><BE><B0>","app_id":"","app_secret":"","verification_token":""}}}
- 使用：在飞书群聊中 @CoPawAI + 指令。
高频实用场景
日常办公
- 整理桌面文档并重命名分类。
- 读取 Excel 统计数据并生成报告。
- 筛选邮件并整理待办清单。
生活辅助
- 查询天气并提供穿衣建议。
- 制定饮食计划。
- 记录支出并汇总。
学习辅助
- 总结教程核心知识点。
- 翻译英文段落并解释语法。
- 生成练习题及答案。
进阶玩法
- 高级定制：深入修改配置文件，细化性格与行为规则。
- 技能扩展：编写 Python 脚本对接智能家居或特定业务。
- 多平台联动：同时接入多个 IM 工具。
- 本地模型：部署开源大模型保障隐私。
- 定时任务：设置主动推送每日总结或备份。
CoPaw 的核心价值在于零代码、高定制与全免费。通过简单的配置调整，即可拥有懂你喜好、按你心意做事的专属数字搭档，从而专注于更高价值的创造性工作。
