CoPaw

CoPaw是阿里推出的一款个人助理型产品，部署在你自己的环境中。CoPaw使用方式可以概括在聊天软件里对话，在钉钉、飞书、QQ或 iMessage（仅 Mac）里发消息，CoPaw 在同一 app 内回复， 查资料、记待办、回答问题等都由当前启用的 Skills 完成。一个 CoPaw 可同时接入多个 app，你在哪个频道聊，它就在哪个频道回。

还有定时自动执行，无需每次手动发消息，CoPaw 可按你设定的时间自动运行：定时向某频道发送固定文案（如每天 9 点发「早上好」）；定时向 CoPaw 提问并将回答发到指定频道（如每 2 小时问「我有什么待办」并发到钉钉）；定时执行「自检/摘要」：用你写好的一串问题问 CoPaw，把回答发到你上次对话的频道。

CoPaw安装指南

如果你不习惯使用命令行，可以下载并使用 CoPaw 的桌面应用版本，无需手动配置 Python 环境或执行命令。

特点

零配置：下载后双击即可运行，无需安装 Python 或配置环境变量

跨平台：支持 Windows 10+ 和 macOS 14+ (推荐 Apple Silicon)

可视化：自动打开浏览器界面，无需手动输入地址

Beta 阶段：功能持续完善中，欢迎反馈问题

下载与使用

1.下载安装包

2.安装并启动

Windows: 双击 .exe 文件按向导安装，完成后双击桌面快捷方式启动

3.首次启动提示

首次启动可能需要 10-60 秒（取决于系统配置），应用需要初始化 Python 环境和加载依赖，请耐心等待浏览器窗口自动打开。

CoPaw控制台操作指南

控制台 是 CoPaw 内置的 Web 管理界面。运行 copaw app 后，在浏览器中打开 http://127.0.0.1:8088/ 即可进入。

在控制台中你可以：

● 和 CoPaw 实时对话

● 启用/禁用消息频道

● 查看和管理所有聊天会话

● 管理定时任务

● 编辑 CoPaw 的人设和行为文件

● 开关技能以扩展 CoPaw 的能力

● 管理MCP客户端

● 修改运行配置

● 配置 LLM 提供商并选择使用的模型

● 管理工具所需的环境变量

左侧侧边栏列出所有功能，分为 聊天、控制、智能体、设置 四组，点击即可 切换页面。下面按顺序逐一介绍每个功能的操作方法。

聊天

侧边栏：聊天 → 聊天

这是你和 CoPaw 对话的地方。打开控制台后默认就是这个页面。

发送消息： 在底部输入框中输入内容，按 Enter 或点击发送按钮（↑），CoPaw 会实时回复。

新建会话： 点击聊天页面侧边栏顶部的 + New Chat 按钮，开始一段全新的对话。每个会话独立保存各自的对话记录。

切换会话： 点击聊天页面侧边栏中的任意会话名称，即可加载该会话的历史消息。

删除会话： 点击任意回话条目右侧的 ··· 按钮，再点击出现的 垃圾桶 图标即可删除。

频道

侧边栏：控制 → 频道

在这里管理各消息频道（钉钉、飞书、Discord、QQ、iMessage、Console）的开关和凭据。

启用一个频道：

1.点击你要配置的频道卡片。

2.右侧滑出配置面板，打开 Enable 开关。

3.填写该频道所需的凭据——每个频道要求不同：

4.点 保存，几秒内自动生效，无需重启。

禁用一个频道： 打开同一个配置面板，关闭 Enable 开关，然后 保存。

会话

侧边栏：控制 → 会话

在这里查看、筛选和清理所有频道的聊天会话。

查找会话： 在搜索框中输入用户名过滤，或用下拉菜单按频道筛选，表格会即时更新。

重命名会话： 点击某行的 编辑 按钮 → 修改名称 → 点 保存。

删除单条会话： 点击某行的 删除 按钮 → 弹窗确认即可。

批量删除： 勾选要删除的行 → 点击出现的 批量删除 按钮 → 确认。

定时任务

侧边栏：控制 → 定时任务

在这里创建和管理 CoPaw 按时间自动执行的定时任务。

创建新任务：

如果定时任务没有创建成功，可以参考 FAQ 的 定时任务错误排查 寻找原因

创建定时任务的 最简单的方式是直接与 CoPaw 对话，让他为你创建。例如你想在钉钉上收到喝水提醒，则在钉钉上与 CoPaw 对话：“帮我创建一个定时任务，每隔 5 分钟提醒我喝水。”创建完成后，可以在控制台的定时任务页面看到创建好的定时任务。

另外一种方式是在控制台页面创建：

1.点击 + 创建任务 按钮。

2.按区域填写表单：

基本信息 —— 给任务一个 ID（如 job-001）、一个名称（如「每日摘要」）， 并打开启用开关。

调度 —— 填写 Cron 表达式（如 0 9 * * * = 每天上午 9 点）并选择时区。

任务类型及内容 —— 选择 文本（发送固定消息）或 Agent（向 CoPaw 提问并 转发回复），然后填入具体内容。

投递 —— 选择目标频道（如 Console、钉钉）、目标用户，以及投递方式 （流式 = 实时发送，最终 = 完成后一次性发送）。

高级选项 —— 按需调整最大并发数、超时时间和宽限时间。

3.点 保存。

编辑任务： 点击某行的 编辑 按钮 → 修改任意字段 → 保存。

启用 / 禁用任务： 点击行内的开关即可。

立即执行一次： 点击 立即执行 → 确认，任务会马上运行一次。

删除任务： 点击 删除 → 确认。

工作区

侧边栏：智能体 → 工作区

在这里编辑定义 CoPaw 人设和行为的文件——SOUL.md、AGENTS.md、 HEARTBEAT.md 等——全部在浏览器中完成。

编辑文件：

1.点击文件列表中的文件名（如 SOUL.md）。

2.文件内容出现在编辑器中，关闭预览按钮，修改内容。

3.点 保存 生效，或点 重置 放弃修改并重新加载。

查看每日记忆： 如果存在 MEMORY.md，点击旁边的 ▶ 箭头可展开按日期分组的条目，点击某个日期 即可查看或编辑当天的记忆。

下载整个工作区： 点击 下载 按钮（⬇），工作区会打包为 .zip 文件保存到本地。

上传 / 恢复工作区： 点击 上传 按钮（⬆）→ 选择 .zip 文件（最大 100 MB），当前工作区文件会被替换。 适合在不同机器之间迁移或从备份恢复。

技能

侧边栏：智能体 → 技能

在这里管理扩展 CoPaw 能力的技能（如读取 PDF、创建 Word 文档、获取新闻等）。

启用技能： 点击技能卡片底部的 启用 链接，立即生效。

查看技能详情： 点击技能卡片可查看完整说明。

禁用技能： 点击 禁用 链接，同样立即生效。

从 Skill Hub 中导入技能：

1.点击导入技能。

2.输入技能 URL，点击导入技能。

3.等待技能导入，成功后可在技能列表中看到已启用。

创建自定义技能：

1.点击 创建技能。

2.输入技能名称（如 weather_query）和技能内容（Markdown 格式，需包含 name 和 description）。

3.点 保存，新技能立即出现。

删除自定义技能： 先禁用该技能，然后点击卡片上的 垃圾桶 图标 → 确认删除。

MCP

侧边栏：智能体 → MCP

在这里启用/禁用/删除MCP，或者创建新的客户端。

创建客户端 点击右上角的创建客户端，填写必要信息，点击创建，可以看到MCP客户端列表中新增内容。

运行配置

侧边栏：智能体 → 运行配置

在这里修改最大迭代次数和最大输入长度，修改后点击保存。

模型

侧边栏：设置 → 模型

在这里配置 LLM 提供商并选择 CoPaw 使用的模型。CoPaw 同时支持云提供商（需要 API Key）和本地提供商（无需 API Key）。

云提供商

配置提供商：

1.点击提供商卡片（ModelScope、DashScope）上的 设置 按钮。

2.输入你的 API Key。

3.点 保存，卡片状态变为「已授权」。

4.如果想添加自定义提供商，点击右侧添加提供商。

5.输入提供商 ID、显示名称等必要信息，点击创建。

6.找到创建的提供商，点击设置，填写必要信息，选择保存，卡片状态变为「已授权」。

撤销授权： 打开提供商的 设置对话框，点击 撤销授权，API Key 会被清除； 如果当前使用的就是该提供商，模型选择也会一并清空。

模型

云提供商

配置提供商：

点击提供商卡片（ModelScope、DashScope）上的 设置 按钮。

输入你的 API Key。

点 保存，卡片状态变为「已授权」。

如果想添加自定义提供商，点击右侧添加提供商。

输入提供商 ID、显示名称等必要信息，点击创建。

找到创建的提供商，点击设置，填写必要信息，选择保存，卡片状态变为「已授权」。

撤销授权： 打开提供商的 设置对话框，点击 撤销授权，API Key 会被清除； 如果当前使用的就是该提供商，模型选择也会一并清空。

本地提供商（llama.cpp / MLX）

本地提供商显示紫色的 本地 标签。 使用前需先安装后端依赖（pip install 'copaw[llamacpp]' 或 pip install 'copaw[mlx]'）。

下载模型：

1.点击本地提供商卡片上的 模型按钮。

2.点击 下载模型，填写：

Repo ID（必填）—— 如 Qwen/Qwen3-4B-GGUF

文件名（可选）—— 留空自动选择

下载源 —— Hugging Face（默认）或 ModelScope

3.点击 下载，等待下载完成。

查看和删除模型： 已下载的模型列在管理面板中，显示文件大小、来源标记（HF / MS）和删除按钮。

Ollama 提供商

Ollama 提供商集成本地 Ollama 守护进程，动态加载其中的模型。

前置条件：

从 ollama.com 安装 Ollama

安装 Ollama SDK：pip install 'copaw[ollama]'（或使用 --extras ollama 重新运行安装脚本）

下载模型：

1.点击 Ollama 提供商卡片的 设置按钮。

2.在API key中填写内容，例如可以直接填写为ollama，点击保存。

3.点击Ollama卡片中的 模型按钮，点击下载模型，输入 模型名称（如 mistral:7b、qwen3:8b）。

4.点击 下载模型，等待下载完成。

取消下载： 下载过程中，点击进度指示器旁的 ✕ 按钮即可取消。

查看和删除模型： 已下载的模型列在管理面板中，显示大小和删除按钮。通过 Ollama CLI 或控制台添加/删除模型时，列表会自动更新。

与本地模型的区别：

模型来自 Ollama 守护进程（不由 CoPaw 直接下载）

模型列表与 Ollama 自动同步

支持热门模型：mistral:7b、qwen3:8b 等

也可以通过 CLI 管理 Ollama 模型：copaw models ollama-pull、copaw models ollama-list、copaw models ollama-remove。详见 CLI。

选择活跃模型

在顶部LLM配置的提供商下拉菜单中选择一个提供商（只显示已授权或 有已下载模型的本地提供商）。

在 模型 下拉菜单中选择一个模型。

点 保存。

注意： 云提供商 API Key 的有效性需要用户自行保证，CoPaw 不会验证。

提供商详细说明见 配置 — 模型提供商。

环境变量

侧边栏：设置 → 环境变量

在这里管理 CoPaw 的工具和技能在运行时需要的环境变量（如 TAVILY_API_KEY）。

添加变量：

点击底部的 + 添加变量。

输入变量名（如 TAVILY_API_KEY）和对应的值。

点击 保存。

编辑变量： 修改已有行的 Value 字段，然后点 保存。 （变量名保存后为只读，如需改名请先删除再新建。）

删除变量： 点击行右侧的 垃圾桶 图标 → 如有提示则确认。

批量删除： 勾选要删除的行 → 点工具栏的 删除 → 确认删除。

注意： 环境变量值的有效性需要用户自行保证，CoPaw 只负责存储和加载。

快速索引