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

CoPaw 简介

CoPaw 是基于 AgentScope 智能体生态的国产 AI 数字搭档，旨在提供既实用又有温度的智能助理。它支持本地和云端部署，无需复杂配置即可使用。

主要特性包括：

长期记忆与人设：可自定义专属人设、性格及相处模式，系统自动记录偏好与待办。
自动化任务处理：支持定时清理桌面、查天气股价、编辑文档、自动打开浏览器等。
零代码技能扩展：通过简单指令添加新功能，如视觉识别或打卡提醒。
灵活部署：支持本地部署（数据隐私）或云端部署（免资源占用），均免费使用。

环境准备

系统与软件要求

操作系统：兼容 Windows、Mac、Linux。
Python 版本：本地部署需 Python 3.10 至 3.13；云端部署无需安装。
依赖管理：本地部署可通过脚本自动管理依赖。

硬件配置

本地部署：普通办公本或家用电脑即可运行。
云端部署：仅需浏览器访问，低配设备亦可使用。

部署方式

官方文档提供了多种部署方式，主要包括本地部署、云端部署及 Docker 容器化部署。

一、本地部署

若未安装 Python，推荐使用 uv 自动管理环境。

步骤一：安装

Windows (PowerShell)：

irm https://copaw.agentscope.io/install.ps1 | iex

macOS / Linux：

curl -fsSL https://copaw.agentscope.io/install.sh | bash

步骤二：初始化 在工作目录（默认 ~/.copaw）下生成配置文件：

copaw init --defaults

步骤三：启动服务

copaw app

服务默认监听 127.0.0.1:8088。

若使用 pip 安装：

pip install copaw

随后执行初始化和启动命令。

二、云端部署

1. 魔搭创空间一键配置

适合无服务器且对数据安全要求不高的用户。

前往 ModelScope 注册并登录。
打开 CoPaw 创空间，一键配置。
注意：设置选项时务必选择'非公开'，防止 Token 被滥用。
复制创空间后，等待部署完成。
在 ModelScope 首页访问控制中复制访问令牌（API Key）。
回到 CoPaw 创空间，点击模型设置，选择 ModelScope 提供商并填入 API Key。
配置 LLM 模型参数，完成训练。

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

个性化定制

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

核心文件说明

文件名称	作用
SOUL.md	性格说明书：说话风格、处事原则
AGENTS.md	工作手册：能力边界、记忆规则
PROFILE.md	用户画像：个人信息、习惯偏好

初始化配置

云端：首次对话会自动弹出引导框。
本地/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": [] }

设置消息接收地址（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. 使用机器人

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

群聊规则配置

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

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

## 高频应用场景

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

## 进阶玩法

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

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

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

CoPaw 简介

环境准备

系统与软件要求

硬件配置

部署方式

一、本地部署

二、云端部署

1. 魔搭创空间一键配置

2. Docker 容器化部署

个性化定制

核心文件说明

初始化配置

定制示例

1. SOUL.md（性格）

2. 配置 CoPaw

3. 使用机器人

群聊规则配置

更多推荐文章

相关免费在线工具

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

CoPaw 简介

环境准备

系统与软件要求

硬件配置

部署方式

一、本地部署

二、云端部署

1. 魔搭创空间一键配置

2. Docker 容器化部署

个性化定制

核心文件说明

初始化配置

定制示例

1. SOUL.md（性格）

2. 配置 CoPaw

3. 使用机器人

群聊规则配置

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具