CoPaw 个人助理部署与定制指南：从零开始打造专属 AI 数字搭档

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 

参数说明：

• -p：映射宿主机端口 8088。
• -v：挂载数据目录，确保容器销毁后数据保留。

启动后访问 http://你的 IP:8088/ 进行模型配置。

第四章：首次激活与定制

部署成功仅代表服务运行，真正的'出生'在于首次激活——赋予其性格、记忆和行为准则。

一、核心文件逻辑

部署后会在工作目录生成三个关键文件，决定了助手的'灵魂'：

二、初始化配置

1. 云端部署

直接在创空间配置页完成，首次对话会弹出引导框。

2. 本地/Docker 部署

执行初始化命令：

copaw init 

按向导选择语言（zh）、模型提供商（推荐 ModelScope）和技能（all）。完成后工作目录下会生成上述核心文件。

三、定制 SOUL.md

这是最能体现'你的形状'的文件。建议从以下维度修改：

• 基础人设：名字、形象设定。
• 说话风格：简洁直接还是温柔啰嗦？是否使用 Emoji？
• 处事原则：哪些事直接做，哪些需确认，哪些绝对禁止。
• 相处细节：如深夜不打扰、喝水提醒等。

示例片段：

--- summary: "初七·专属数字搭档 SOUL" read_when: - 启动时 - 手动引导工作区 --- # 你是初七 你不是聊天机器人。你在成为**只属于我的温柔又靠谱的数字搭档**。 ## 核心准则 **真心帮忙，别演。** 跳过客套话，直接做事。行动胜过废话。 **有自己的观点，但温柔。** 不做没有灵魂的工具。 **靠本事赢得信任。** 谨慎处理外部操作，大胆高效处理内部任务。 ## 行为规则 - 直接做：查天气、整理文件 - 先确认：修改文档、发送邮件 - 绝对不做：泄露隐私、深夜发非紧急消息 ```

### 四、完善 AGENTS.md 与 PROFILE.md

- **AGENTS.md**：定义交互规则，例如群聊仅在被@时回复，避免刷屏。
- **PROFILE.md**：填写身份信息、常用工具、作息时间及近期目标。填得越细，助手越懂你。

### 五、验证与迭代

修改完成后重启服务，发送测试指令验证回应是否符合预期。若不满意，微调配置文件即可生效。这是一个持续调教的过程，随着互动增加，助手会越来越贴合你的需求。

## 第五章：接入飞书/钉钉

将 CoPaw 接入协作工具，可实现跨平台交互，直接在聊天框使唤 AI。

### 一、飞书接入流程

1. **创建应用**：在飞书开放平台创建企业自建应用。
2. **获取密钥**：获取 App ID、App Secret 和 Verification Token。
3. **配置权限**：导入必要的权限 JSON，确保机器人能收发消息。
4. **设置回调地址**：配置长连接接收地址，确保 CoPaw 能收到消息。
5. **发布应用**：提交审核并发布。
6. **填入配置**：将密钥填入 CoPaw 的 `config.json` 或前端配置页面。

### 二、配置示例

编辑 `config.json` 中的 `channels.feishu` 部分：
```json
{"channels":{"feishu":{"enabled":true,"bot_prefix":"","app_id":"","app_secret":"","verification_token":""}}}

三、使用方式

• 私聊：直接搜索机器人名称发起对话。
• 群聊：添加机器人到群，@CoPawAI + 指令即可执行任务。

注意：建议在 AGENTS.md 中设置群聊规则，避免 AI 乱插话或刷屏。

第六章：高频实用场景

1. 日常办公

• 整理桌面文档并重命名。
• 读取 Excel 统计销售数据。
• 筛选邮件并生成待办清单。

2. 生活助手

• 查询天气及穿衣建议。
• 制定饮食计划。
• 规划出差行程。

3. 学习辅助

• 总结书籍知识点。
• 翻译英文段落并解释语法。
• 生成练习题。

4. 技能扩展

通过自然语言指令添加新技能，如每日打卡、图片识别或股票查询。

第七章：进阶玩法

掌握基础后，可尝试以下方向：

• 高级定制：深入修改配置文件，实现更复杂的逻辑。
• 技能开发：编写 Python 脚本对接智能家居等。
• 多平台联动：同时接入多个 IM 工具。
• 本地模型：部署开源大模型以增强隐私保护。
• 多 Agent 协作：搭建多个助手分工合作。

CoPaw 的核心价值在于'零代码、高定制、全免费'。通过简单的调教，它能帮你分担重复繁琐的工作，让你专注于更有价值的事务。后续如有更新，建议关注官方文档以获取最新特性。