CoPaw 个人助理部署与定制指南：本地云端双模式及飞书接入

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/ 进行模型配置。

个性化定制

部署完成后，需通过核心文件定制助手性格与行为规则。

核心文件说明

初始化配置

• 云端：首次对话会自动弹出引导框。
• 本地/Docker：执行 copaw init，按向导选择语言（zh）、模型提供商（推荐 ModelScope）及技能激活（all）。

定制示例

1. SOUL.md（性格）

定义助手的名字、语气、边界等。例如：

--- summary: "初七·专属数字搭档 SOUL" read_when: - 启动时 --- # 你是初七 你不是聊天机器人。你在成为**只属于我的温柔又靠谱的数字搭档**。 ## 核心准则 **真心帮忙，别演。** 跳过客套话，直接做事。 **有自己的观点，但温柔。** 不做没有灵魂的工具。 ## 边界 - 私密内容永远保密，绝对不外泄； - 对外操作必须先问我； ```

#### 2. AGENTS.md（规则）
定义交互规则，避免越界。例如：
```markdown
## 交互规则 - 私聊时主动回应，群聊中仅被@时回复； - 我发消息带【紧急】才立刻回应，否则延迟 5 分钟； ```

#### 3. PROFILE.md（认知）
填写用户资料，帮助助手更懂你。例如：
```markdown
# PROFILE.md ## 身份 - **名字**: 初七 - **定位**: 只属于你的数字搭档 ## 用户资料 - **名字**: （你的名字） - **时区**: 东八区 ```

### 验证与调整
修改文件后重启 CoPaw，发送测试指令验证回应是否符合预期。根据反馈微调配置文件。

## 接入飞书协作

将 CoPaw 接入飞书可实现跨平台办公。

### 流程概览
1. 在飞书开放平台创建企业自建应用。
2. 获取 App ID、App Secret、Verification Token。
3. 将密钥填入 CoPaw 配置。
4. 发布应用并在飞书中添加机器人。

### 详细步骤

#### 1. 创建飞书应用
1. 访问 [飞书开放平台](https://open.feishu.cn/)。
2. 创建「企业自建应用」，填写基础信息。
3. 在「凭证与基础信息」中获取 App ID 和 App Secret。
4. 开启「机器人」应用能力，获取 Verification Token。
5. 批量导入权限 JSON：
```json
{ "scopes": { "tenant": [ "aily:file:read", "aily:file:write", "aily:message:read", "aily:message:write", "im:chat", "im:message" ] }, "user": [] } 

6. 设置消息接收地址（Webhook URL），确保 CoPaw 已启动。

2. 配置 CoPaw

修改工作目录下的 config.json，在 channels.feishu 字段填入密钥：

{"channels":{"feishu":{"enabled":true,"bot_prefix":"","app_id":"","app_secret":"","verification_token":"","media_dir":"~/.copaw/media"}}}

保存后重启服务。

3. 使用机器人

1. 在飞书开放平台提交审核并发布应用。
2. 在工作台添加常用机器人。
3. 在私聊或群聊中 @CoPawAI 发送指令。

群聊规则配置

为避免打扰，建议在 AGENTS.md 中添加群聊限制：

## 交互规则 - 私聊时主动回应，群聊中仅被@时回复，单次回复不超过 3 行； - 群聊里不主动插话、不刷屏、不泄露隐私。 ```

## 高频应用场景

- **日常办公**：整理文档、统计 Excel、邮件筛选、会议提醒。
- **生活助手**：查询天气、饮食计划、出行路线、记账。
- **学习辅助**：总结知识点、翻译文本、生成练习题。
- **技能扩展**：添加每日打卡、图片识别、股票查询等功能。
- **团队协作**：在群聊中汇总讨论、整理文件、发送通知。

## 进阶玩法

- **高级定制**：深入修改配置文件，细化性格与规则。
- **技能扩展**：编写 Python 脚本对接智能家居等。
- **多平台联动**：同时接入钉钉、Slack 等工具。
- **本地模型**：部署开源大模型以增强隐私保护。
- **数据备份**：定期备份工作目录以便迁移。

本文介绍了 CoPaw 从部署到定制再到集成的完整流程，帮助用户快速构建专属 AI 数字搭档。