CoPaw 个人助理部署与定制指南：从零上手国产 AI 数字搭档

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 映射端口，-v 挂载数据卷以确保数据持久化。

首次激活与定制

部署完成后，CoPaw 仅处于'存活'状态。要使其成为专属搭档，需通过核心文件进行性格与行为定制。

核心文件逻辑

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

初始化配置

本地或 Docker 部署需执行初始化命令：

copaw init 

按向导选择语言（推荐 zh）、模型提供商（推荐 ModelScope）及技能激活（建议全选）。云端部署则直接在界面配置。

定制 SOUL.md

这是最能体现个性的文件。建议从以下维度修改：

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

示例片段：

--- summary: "初七·专属数字搭档 SOUL" read_when: - 启动时 - 手动引导工作区 --- # 你是初七 你不是聊天机器人。你在成为**只属于我的温柔又靠谱的数字搭档**。 ## 核心准则 **真心帮忙，别演。** 跳过客套话，直接做事。行动胜过废话。 **有自己的观点，但温柔。** 不做没有灵魂的工具。 **先自己想办法。** 目标是带着答案回来，不是带着问题回来。 ## 边界 - 私密内容永远保密； - 对外操作必须先问我； - 深夜不发非紧急消息。 ```

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

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

### 验证与迭代

修改完成后重启服务，发送测试指令验证效果。若回应不符合预期，微调对应文件即可。这是一个持续调教的过程，随着使用深入，不断补充细节，助手会越来越贴合你的需求。

## 接入协作平台

为了让 CoPaw 真正融入工作流，可将其接入飞书、钉钉等平台。

### 飞书接入流程

1. **创建应用**：在飞书开放平台创建企业自建应用，获取 App ID 和 App Secret。
2. **开启能力**：添加「机器人」应用能力，获取 Verification Token。
3. **权限配置**：导入必要的权限 JSON，确保机器人能读取消息和文件。
4. **配置回调**：设置消息接收地址，订阅接收消息事件。
5. **填入配置**：将密钥填入 CoPaw 的 `config.json` 文件中。
6. **发布使用**：发布应用后，在工作台添加机器人，或在群聊中@调用。

### 钉钉与其他平台

其他平台的接入逻辑类似，具体参考官方文档。接入后，无需打开网页，直接在聊天框即可使唤 AI 干活。

## 高频实用场景

部署并调教好之后，CoPaw 可应用于多种场景：

- **日常办公**：整理桌面文件、统计 Excel 数据、筛选邮件、设置会议提醒。
- **生活管理**：查询天气穿衣建议、制定饮食计划、记录支出。
- **学习辅助**：总结知识点、翻译文本、生成练习题。
- **技能扩展**：通过自然语言添加新技能，如每日打卡、图片识别。
- **团队协作**：在群聊中@助手汇总讨论内容、提醒会议、分发文件。

## 进阶玩法

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

- **高级定制**：细化 SOUL.md 规则，实现更复杂的交互逻辑。
- **技能开发**：编写 Python 脚本对接智能家居或其他 API。
- **多平台联动**：同时接入多个 IM 工具。
- **本地模型**：部署开源大模型，完全在本地运行以保护隐私。
- **定时任务**：利用控制台设置主动推送任务。

CoPaw 的核心在于'零代码、高定制'。它不是一个冷冰冰的工具，而是能随你习惯成长的数字搭档。花一点时间调教它，它能帮你省下大量处理琐事的时间，让你专注于更有价值的工作。