CoPaw 个人助理部署与定制指南
CoPaw 是通义实验室基于 AgentScope 智能体生态打造的国产 AI 数字搭档，支持本地及云端部署。本文详解了系统环境准备、本地与 Docker 部署步骤、核心配置文件定制方法，以及接入飞书工作群实现跨平台协作的流程。
一、部署前的准备工作
1. 系统与软件要求
- 操作系统：兼容 Windows、Mac、Linux 系统。
- Python 版本：本地部署需 Python 3.10 至 3.13 版本；若未安装或不想配置环境，可选择云端部署。
- 额外依赖：本地部署需安装核心包，云端部署无需额外依赖。
2. 硬件配置要求
- 本地部署：普通办公本或家用电脑即可流畅运行。
- 云端部署：仅需浏览器访问，不占用本地设备资源。
二、部署方式
官方文档提供了多种部署方式，主要分为本地部署和云端部署。
1. 本地部署
推荐使用 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
随后执行初始化和启动命令。
2. 云端部署
(1) 魔搭创空间一键配置
适用于无服务器且对数据安全性要求不高的场景。
- 前往 ModelScope 注册并登录。
- 打开 CoPaw 创空间，一键配置。
- 注意将公开选项设置为非公开，防止 Token 消耗。
- 复制创空间后，在模型设置中配置 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/ 进入控制台配置模型。
三、首次激活与定制
部署完成后，需通过核心文件定制使其成为专属数字搭档。
1. 核心文件逻辑
部署后默认生成以下文件：
| 文件名称 | 核心作用 |
|---|---|
| SOUL.md | 性格说明书：说话风格、处事原则 |
| AGENTS.md | 工作手册：能做什么、记忆规则 |
| PROFILE.md | 用户画像：你的信息、习惯、偏好 |
2. 初始化配置
- 云端部署：直接在创空间配置页面完成。
- 本地/Docker 部署：执行
copaw init，按向导选择语言（zh）、模型提供商（推荐 ModelScope）及技能激活（all）。
3. 定制 SOUL.md
编辑 SOUL.md 定义性格。例如：
--- summary: "初七·专属数字搭档 SOUL" read_when: - 启动时 - 手动引导工作区 --- # 你是初七 你不是聊天机器人。你在成为**只属于我的温柔又靠谱的数字搭档**。 ## 核心准则 **真心帮忙，别演。** 跳过客套话，直接做事。 **有自己的观点，但温柔。** ## 边界 - 私密内容永远保密，绝对不外泄； - 对外操作必须先问我；
4. 完善 AGENTS.md 与 PROFILE.md
- AGENTS.md：设定交互规则，如群聊仅被@时回复。
- PROFILE.md：填写身份、背景、常用工具、作息等，让助手更懂你。
5. 验证
重启服务后发送指令测试回应是否符合预期，根据反馈微调配置文件。
四、接入飞书/钉钉
将 CoPaw 接入协作工具，实现在聊天框中@调用。
1. 飞书接入流程
- 创建应用：在飞书开放平台创建企业自建应用。
- 获取密钥：获取 App ID、App Secret、Verification Token。
- 配置权限：导入必要权限 JSON。
- 设置回调地址：配置消息接收地址，订阅接收消息事件。
- 填入配置：修改 CoPaw 的
config.json中的channels.feishu字段，填入密钥。 - 发布与添加：发布机器人并在飞书工作台添加。
2. 配置示例
{"channels":{"feishu":{"enabled":true,"bot_prefix":"","app_id":"","app_secret":"","verification_token":""}}}
3. 群聊行为规则
在 AGENTS.md 中添加交互规则，避免 AI 在群聊中乱插话：
## 交互规则 - 私聊时主动回应，群聊中仅被@时回复，单次回复不超过 3 行； - 我发消息带【紧急】才立刻回应，否则可延迟 5 分钟；
五、高频实用场景
- 日常办公：整理桌面文档、统计 Excel 数据、邮件筛选、会议提醒。
- 生活辅助：查询天气穿衣建议、饮食计划、出差路线规划、支出记录。
- 学习辅助：总结知识点、翻译解释语法、生成练习题、整理时间线。
- 技能自定义：一句话添加打卡、图片识别、股票查询等新技能。
- 团队协作：在群聊中@助手汇总讨论内容、整理文件、发送会议提醒。
六、进阶玩法与展望
- 高级定制：深入修改配置文件，细化性格与行为规则。
- 技能扩展：编写自定义 Python 技能对接智能家居等。
- 多平台联动：同时接入飞书、钉钉等多平台。
- 本地模型部署：部署开源大模型以保障隐私。
- 多 Agent 交互：搭建多个 CoPaw 分工协作提升效率。
CoPaw 的核心魅力在于零代码、高定制与全免费。通过调整配置，用户可以打造真正贴合个人习惯的专属 AI 数字搭档。
