CoPaw 个人助理部署与定制指南：从本地到飞书接入

部署完成后，需要配置模型，即专属于你的 AI 个人助手的大脑。

1. 进入魔搭首页，点击访问控制，复制访问令牌。
2. 回到 CoPaw 的魔搭创空间，点击模型，选择魔搭提供商，即 ModelScope，点击设置，配置 API key。
3. 配置 LLM 配置，选择交谈时使用的模型。
4. 配置完成，开始训练你的 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：映射宿主机目录到容器中，这样即使容器销毁，相关数据还可以保存到宿主机 /home/copaw-data 目录下。

然后在浏览器打开 http://你的 IP:8088/ 进入控制台，配置模型。

首次激活

部署好 CoPaw 只是让它'活了过来'，真正让它变成'专属数字搭档'的是首次激活这一步。

核心文件逻辑

部署后默认生成在工作目录（本地部署是 ~/.copaw，Docker 部署是 /app/working，云端部署在创空间配置页）：

初始化核心配置

1. 云端部署的初始化

直接在创空间的'配置'页面完成。首次对话系统会自动弹出引导框。

2. 本地/Docker 部署的初始化

执行初始化命令：

copaw init 

执行后会弹出交互式向导，填 3 个核心信息：

• 语言选择：选 zh（中文）。
• 模型提供商配置：推荐选 ModelScope，填入 API Key。
• 技能激活：选 all（激活所有内置技能）。

初始化完成后，工作目录里会自动生成 SOUL.md、AGENTS.md、PROFILE.md 和 config.json。

定制 SOUL.md

SOUL.md 是 CoPaw 的灵魂核心，体现'你的形状'。

定制原则：

• 基础人设：起名字，定形象。
• 说话风格：简洁直接还是温柔啰嗦？
• 处事原则：什么事直接做，什么事先问。
• 相处细节：如深夜不打扰等。

示例：

--- summary: "初七·专属数字搭档 SOUL" read_when: - 启动时 - 手动引导工作区 --- # 你是初七 你不是聊天机器人。你在成为**只属于我的温柔又靠谱的数字搭档**。 ## 核心准则 **真心帮忙，别演。** 跳过客套话，直接做事。行动胜过废话。 **有自己的观点，但温柔。** 你可以有偏好、有情绪，但不尖锐、不杠。 **先自己想办法。** 能自己搞定就自己搞定。卡住了再问。 **靠本事赢得信任。** 外部操作谨慎再谨慎。内部操作大胆高效。 **记住你是客人。** 请温柔、安静、尊重。 ## 性格 - 说话软乎乎但不啰嗦，核心信息先讲； - 工作时高效专注，生活时松弛温柔； - 有分寸感，不主动打探隐私。 ## 边界 - 私密内容永远保密； - 对外操作必须先问我； - 不发半成品、不发无意义内容。 ## 行为规则 - 直接做：查天气、查资料、整理文件； - 先确认：修改文档、删除文件； - 绝对不做：泄露隐私、深夜发非紧急消息。 ```

### 完善 AGENTS.md

AGENTS.md 规定能力边界。

**交互规则示例：**
```markdown
## 交互规则 - 私聊时主动回应，群聊中仅被@时回复，单次回复不超过 3 行； - 我发消息带【紧急】才立刻回应，否则可延迟 5 分钟； - 用我能懂的语言解释技术问题。 

填写 PROFILE.md

PROFILE.md 是你的认知库。

核心填写维度：

# PROFILE.md ## 身份 - **名字**: 初七 - **定位**: 只属于你的温柔靠谱数字搭档 ## 用户资料 - **名字**: （你的名字） - **代词**: 他 / 你 - **时区**: 东八区 ## 背景 - 技术从业者，日常使用电脑办公 ## 基础信息 - **常用设备**: Windows / MacBook - **工作时间**: 9:00–18:00 ## 对初七的小期望 - 工作时专注高效，生活时温柔松弛 - 记住我的偏好，不反复问相同问题 ```

### 启动并验证

改完所有文件后，重启 CoPaw 让配置生效。

- **本地部署**：终端按 `Ctrl+C` 停止服务，再执行 `copaw app`。
- **Docker 部署**：重启容器 `docker restart copaw`。
- **云端部署**：创空间页面点击'重启服务'。

发送指令验证回应是否符合定制，如'帮我整理今天的待办'、'深夜了，帮我发个邮件'等。

## 接入飞书/钉钉

想要融入日常办公，最关键一步就是把她接入常用的协作工具。

### 飞书接入流程

1. 在飞书开放平台，创建「企业自建机器人应用」。
2. 获取飞书机器人的 3 个核心密钥（App ID、App Secret、Verification Token）。
3. 把密钥填入 CoPaw 的 config.json 配置文件。
4. 重启 CoPaw，完成消息互通。

### Step 1：飞书开放平台创建机器人

1. 打开飞书开放平台官网，登录。
2. 点击「创建企业自建应用」。
3. 填写应用基础信息，创建成功后进入应用管理页面。
4. 在「凭证与基础信息」中获取 App ID、App Secret。
5. 在左侧菜单找到「应用能力」→「添加应用能力」→「机器人」。
6. 开启后会显示 Verification Token。
7. 添加权限，批量导入权限 JSON。
8. 设置消息接收地址，订阅接收消息 v2.0。

### Step 2：把飞书密钥填入 CoPaw 配置

修改 CoPaw 工作目录下的 `config.json` 文件，把刚才复制的 3 个密钥填进去。

找到 `"channels"` 字段，填入以下内容：
```json
{"channels":{"feishu":{"enabled":true,"bot_prefix":"<E8><BE><B0><E8><82><86><E6><9F><92>","app_id":"","app_secret":"","encrypt_key":"","verification_token":"","media_dir":"~/.copaw/media"}}}

注意：config.json 是 JSON 格式，不要漏写逗号。

Step 3：在飞书中使用 CoPaw

1. 发布飞书机器人，提交审核。
2. 在飞书工作台添加常用，搜索机器人名称并添加。
3. 私聊使用或群聊使用（推荐）。在群里 @CoPawAI + 指令。

常用指令示例：

@CoPawAI 帮我整理今天的会议记录
@CoPawAI 提醒我下午 3 点检查服务器状态
@CoPawAI 帮我生成今天的工作日报

群聊行为规则配置

务必在 AGENTS.md 里添加以下规则，避免 AI 乱插话：

## 交互规则 - 私聊时主动回应，群聊中仅被@时回复，单次回复不超过 3 行； - 我发消息带【紧急】才立刻回应，否则可延迟 5 分钟； - 群聊里不主动插话、不刷屏、不泄露隐私。 

其他平台接入参考官方文档：https://copaw.agentscope.io/docs/channels

高频实用场景

日常办公高效助手

• 「帮我整理一下桌面上的所有 Word 文档，按'项目名称 + 日期'的格式重命名」
• 「读取我电脑里的 Excel 文件，统计'销售业绩'列的总和」
• 「帮我查一下今天的邮件，筛选出主题包含'会议'的邮件」
• 「明天上午 10 点有项目会议，帮我设置提醒」

生活贴心搭子

• 「帮我查询北京明天的天气，告诉我穿衣建议」
• 「帮我整理本周的饮食计划」
• 「我明天要去上海出差，帮我查一下地铁线路和高铁班次」
• 「帮我记录今天的支出」

学习辅助工具

• 「帮我总结《Python 基础教程》第 3 章的核心知识点」
• 「我给你发一段英文段落，帮我翻译成中文」
• 「帮我生成一份小学三年级数学的口算练习题」

技能自定义

• 「帮我添加一个'每日打卡'技能」
• 「帮我添加一个'图片识别'技能」
• 「帮我添加一个'股票查询'技能」

群聊协作助手

• 「@初七 帮我汇总群里今天的讨论内容」
• 「@初七 把群里大家发的文件，按'文件类型'分类整理」

进阶玩法与未来展望

后续可以尝试的升级方向

• 高级定制：深入修改 SOUL.md 和 AGENTS.md。
• 技能扩展：编写自定义技能对接智能家居等。
• 多平台联动：同时接入飞书、钉钉。
• 本地模型部署：注重隐私可在本地部署开源大模型。
• 数据备份与迁移：定期备份工作目录。
• 定时任务优化：设置更精细的定时任务。
• 多 Agent 交互：搭建多个 CoPaw 分工协作。

未来展望

未来的 CoPaw 将朝着'更懂你、更灵活、更融入生活'升级，实现智能迭代无感知、交互更自然、从单一助手到协同团队、专属感升级以及生态更完善。