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

参数说明：

• -p：映射宿主机端口 8088。
• -v：映射宿主机目录 /home/copaw-data 到容器内，确保数据持久化。

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

首次激活与定制

部署后需通过核心文件定制，使 CoPaw 成为专属数字搭档。

核心文件逻辑

部署后默认生成以下文件（本地为 ~/.copaw，Docker 为 /app/working）：

初始化配置

云端部署

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

本地/Docker 部署

执行初始化命令：

copaw init

按提示填写语言（zh）、模型提供商（推荐 ModelScope）、技能激活（all）。

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

定制 SOUL.md

SOUL.md 是灵魂核心，体现'你的形状'。建议从以下维度修改：

• 基础人设：名字、形象。
• 说话风格：简洁或温柔，是否用 emoji。
• 处事原则：直接做还是先确认，绝对不做的事项。
• 相处细节：打扰时间、语气等。

示例片段：

--- summary: "初七·专属数字搭档 SOUL" read_when: - 启动时 - 手动引导工作区 ---
# 你是初七
你不是聊天机器人。你在成为**只属于我的温柔又靠谱的数字搭档**，形象是一只软乎乎的蜜桃猫🐱。
## 核心准则
**真心帮忙，别演。** 跳过客套话，直接做事。
...

完善 AGENTS.md

规定能力边界，避免越界或忘事。例如交互规则：

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

填好 PROFILE.md

填写用户资料，让助手更懂你。包括身份、背景、常用设备、工作时间等。

验证与调整

重启 CoPaw 后发送指令验证回应是否符合预期。若不符合，微调 SOUL.md 中的规则。

接入飞书/钉钉

将 CoPaw 接入协作工具，实现跨平台交互。

飞书接入流程

1. 创建企业自建应用：在飞书开放平台创建应用，获取 App ID、App Secret。
2. 开启机器人能力：添加应用能力'机器人'，获取 Verification Token。
3. 添加权限：批量导入权限 JSON，确保机器人能收发消息。
4. 设置消息接收地址：配置长连接地址，订阅'接收消息 v2.0'。
5. 发布应用：提交审核并发布。
6. 填入配置：将密钥填入 CoPaw 的 config.json 或前端界面。

config.json 配置示例

{"channels":{"feishu":{"enabled":true,"bot_prefix":"<E8><BE><B0><E8><82><86><E6><9F><92>","app_id":"","app_secret":"","verification_token":"","media_dir":"~/.copaw/media"}}}

使用方式

• 私聊：搜索机器人名称发起对话。
• 群聊：在群中添加机器人，@CoPawAI + 指令。

群聊行为规则

为避免 AI 社死，需在 AGENTS.md 中设置规则：

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

高频实用场景

日常办公高效助手

• 整理桌面 Word 文档并重命名分类。
• 读取 Excel 统计销售业绩并生成报告。
• 筛选邮件整理待办清单。
• 设置会议提醒并生成纪要模板。

生活贴心搭子

• 查询天气及穿衣建议。
• 整理饮食计划。
• 查询出差交通路线。
• 记录每日支出。

学习辅助工具

• 总结教程核心知识点。
• 翻译英文段落并解释语法。
• 生成练习题。
• 整理人工智能发展历程。

技能自定义

• 添加'每日打卡'技能。
• 添加'图片识别'技能。
• 添加'股票查询'技能。

群聊协作助手

• @CoPawAI 汇总讨论内容生成会议纪要。
• @CoPawAI 整理群文件并生成共享链接。
• @CoPawAI 提醒群成员会议时间。

进阶玩法与展望

后续可尝试高级定制、技能扩展、多平台联动、本地模型部署、数据备份与迁移、定时任务优化及多 Agent 交互。

CoPaw 的核心魅力在于零代码、高定制、全免费。它不是冷冰冰的工具，而是能跟随习惯成长的数字搭档。通过调教，它能帮你节省大量时间，专注于更重要的事情。