CoPaw 国产 AI 数字搭档部署与定制实战指南

Docker 容器化部署

适合需要数据本地化的用户。

1. 拉取镜像：

docker pull agentscope/copaw:latest 

国内用户若拉取困难，可使用阿里云 ACR：

docker pull agentscope-registry.ap-southeast-1.cr.aliyuncs.com/agentscope/copaw:latest 

2. 创建容器：

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 挂载数据卷以便持久化。 3. 浏览器访问 http://你的 IP:8088/ 进行后续配置。

首次激活与定制

部署成功仅代表服务运行，真正的'出生'在于首次激活与文件定制。这步决定了助手是通用工具还是专属搭档。

核心文件逻辑

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

初始化配置

• 云端：直接在创空间配置页完成引导。
• 本地/Docker：执行 copaw init，交互式向导中选择中文、模型提供商（推荐 ModelScope）及技能激活（建议选 all）。初始化后会自动生成上述三个文件。

塑造性格 (SOUL.md)

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

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

示例片段：

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

完善行为规则 (AGENTS.md)

规定'能做什么、怎么做'。首次激活保留默认即可，后续可在聊天中调教。例如定义群聊交互规则：

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

填充用户画像 (PROFILE.md)

让助手'彻底懂你'。填写身份、常用设备、工作时间、避坑点等信息。越详细，助手越无需反复询问。

接入协作平台

将 CoPaw 接入飞书、钉钉等工具，可实现群聊内直接使唤 AI。

飞书接入流程

1. 创建应用：在飞书开放平台创建企业自建应用，获取 App ID 和 App Secret。
2. 开启能力：添加'机器人'应用能力，获取 Verification Token。
3. 权限管理：批量导入权限 JSON，确保机器人能收发消息、读取文件。
4. 配置回调：设置消息接收地址（Webhook），订阅'接收消息 v2.0'事件。
5. 填入配置：将密钥填入 CoPaw 的 config.json 文件中 channels.feishu 部分。
6. 发布与使用：发布应用后，在工作台添加机器人，或在群聊中 @CoPawAI 调用指令。

注意：务必在 AGENTS.md 中配置群聊行为规则，避免 AI 乱插话或刷屏。

高频实用场景

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

• 日常办公：整理桌面文档、统计 Excel 数据、筛选邮件待办、设置会议提醒。
• 生活助手：查询天气穿衣建议、制定饮食计划、规划出差路线、记账汇总。
• 学习辅助：总结教程知识点、翻译段落语法、生成练习题、梳理知识时间线。
• 技能扩展：通过自然语言添加每日打卡、图片识别、股票查询等自定义技能。
• 团队协作：在群聊中@助手汇总讨论内容、整理会议纪要、发送全员通知。

进阶与展望

CoPaw 的核心魅力在于'零代码、高定制、全免费'。它不是冷冰冰的工具，而是能随习惯成长的数字搭档。

后续探索方向：

• 高级定制：深入修改配置文件，实现自动生成周报等复杂逻辑。
• 技能扩展：编写 Python 脚本对接智能家居或特定业务系统。
• 多平台联动：同时接入多个 IM 工具，实现跨平台同步在线。
• 本地模型：部署开源大模型（如通义千问、Llama），确保数据完全本地化。
• 多 Agent 协作：搭建多个 CoPaw 分工合作，提升创作或处理效率。

随着 AI 技术发展，未来 CoPaw 将向更自然的交互（语音、视觉）、更完善的生态（接入更多第三方工具）演进，真正实现从'单一助手'到'协同团队'的转变。