CoPaw：部署在你身边的个人助理，它能读懂你，也能为你自动跑腿

想象一下，你有一个专属助手，它不像那些需要登录网页、对话记录随时可能被拿去训练的云端服务，而是静悄悄地运行在你自己的电脑上。你可以在钉钉、飞书甚至 iMessage 里随时找它，它能帮你读PDF、整理周报、定时提醒你待办事项，甚至在你睡觉的时候，按你写好的清单“自我检查”，然后把结果发给你。

这就是 CoPaw 要做的事情。它不是一个遥不可及的“未来产品”，而是一个你现在就能用几条命令安装起来、实实在在帮你干活的工具。

这篇文章会带你全面了解 CoPaw 是什么、能做什么，以及如何从零开始把它用起来。内容完全基于官方文档，但我们把它掰开揉碎，用更直接的方式讲清楚。

一、CoPaw 到底是什么？

简单来说，CoPaw 是一款个人助理型应用，但它的运行方式和常见的智能助手有很大不同。

  • 它住在你的地盘里：CoPaw 的所有数据和配置文件，都存放在你自己电脑的目录里（比如 ~/.copaw）。它不依赖任何第三方云端服务，对话记录、你设置的定时任务、它学到的关于你的偏好，都在你自己手上。
  • 你在哪里聊，它就在哪里回：它不是一个需要你打开特定网页才能对话的工具。你可以把它接入你日常使用的聊天软件里。目前它支持钉钉、飞书、QQ、Discord，甚至 macOS 上的 iMessage。你在这些 App 里@它或者给它发消息，它会直接在同一个窗口回复你。
  • 它的能力由“技能 (Skills)”决定：CoPaw 不是一个只会聊天的机器人。它能做的事情，取决于你给它开启了哪些“技能”。比如阅读 PDF、创建 Word 文档、获取最新新闻、管理定时任务等等。这些技能可以自由开关，你甚至可以为它编写自定义的技能。
  • 它能自动“跑腿”：你不需要每次都手动发消息。你可以设定一个定时任务，比如每天上午 9 点，让它把当天的待办事项发到你的钉钉。或者设定一个**“心跳”**，让它每隔一段时间，就用你预先写好的问题清单去“自我提问”，然后把回答发给你。

总的来说，CoPaw 是一个部署在你本地环境、通过你日常使用的聊天软件与你交互、能力可扩展、并且可以定时自动工作的智能助手。

二、我为什么需要这么一个本地助理？

这是一个很直接的问题。市面上能聊天的 AI 不少，为什么要费点功夫在自己电脑上装一个？

最核心的理由可能是数据隐私和个性化控制。你与 CoPaw 的每一次对话，你让它记住的每一个偏好（比如“我习惯用 pytest 写测试”），都只保存在你的电脑里。它没有厂商的云端数据库，你的数据不会被用于训练其他人的模型。

另一个理由是它和你的工作流深度绑定。它可以接入你工作中离不开的钉钉、飞书群，可以定时扫描你的邮件（通过 himalaya 技能），可以帮你读取本地的 Word、Excel 文件并做摘要。它更像是你数字生活的一部分，而不是一个独立的、需要你切换上下文去访问的网页。

三、快速上手：从安装到第一次对话

这部分完全基于官方文档，我们把最关键的操作步骤提取出来。

第一步：安装（两种方式，任选其一）

CoPaw 提供了两种运行方式，一种在本地，一种在云端。

方式一：本地安装（适合想完全掌控的用户）

你的电脑需要安装 Python，版本要求在 3.10 到 3.13 之间。

  1. 打开终端，使用 pip 进行安装：

    pip install copaw

    建议在安装前为 CoPaw 创建一个独立的 Python 虚拟环境，这样可以避免和系统其他 Python 包冲突。

  2. 初始化配置：

    # 如果你想快速体验，用默认配置跳过提问
copaw init --defaults

# 如果你想一步步配置（推荐第一次使用）
copaw init

    初始化命令会在你的用户目录下创建 .copaw 文件夹，并生成核心配置文件 config.json 和 HEARTBEAT.md。交互式初始化过程中，它会引导你设置心跳间隔、选择要接入的聊天频道（比如钉钉）、配置大模型提供商（如 ModelScope、DashScope）等。

  3. 启动服务：

    copaw app

    服务启动后，默认会在本地地址 127.0.0.1:8088 监听。这时，CoPaw 就已经在后台待命了。

方式二：魔搭创空间（适合不想折腾本地环境）

如果你不想在本地安装 Python，可以直接把它部署到阿里云的“魔搭创空间”上，一键配置即可，CoPaw 会在云端运行。

  1. 注册并登录 [魔搭社区 (ModelScope)]。
  2. 访问 CoPaw 创空间页面，点击“一键配置”即可。
    注意：请务必将你的创空间设置为“非公开”，否则任何人都可能操纵你的 CoPaw。

第二步：验证安装（可选，但推荐）

服务启动后，你可以通过一个简单的命令来验证它是否正常工作。打开另一个终端窗口，输入：

curl -N -X POST "http://localhost:8088/agent/process" \
  -H "Content-Type: application/json" \
  -d '{"input":[{"role":"user","content":[{"type":"text","text":"你好"}]}],"session_id":"test-session"}'

如果一切正常，CoPaw 会通过流式方式返回它的问候语。

第三步：打开控制台，和 CoPaw 打个招呼

在浏览器里访问 http://127.0.0.1:8088/，你会看到 CoPaw 的控制台界面。默认进入的就是“聊天”页面。

聊天界面

在底部的输入框里，你可以直接和 CoPaw 对话了。在配置任何聊天频道之前，这是和它互动的最直接方式。

四、把它接进你常用的 App 里（频道配置）

在控制台聊天只是第一步。要让 CoPaw 真正融入你的日常，需要把它接入你常用的聊天软件，也就是配置“频道”。

你可以在控制台的“控制” -> “频道”页面完成所有配置。

频道管理界面

配置方式很简单：点击你要添加的频道卡片，在弹出的面板里打开“启用”开关，然后填入必要的凭证信息。下面我们以最常用的“钉钉”为例，看看怎么配置。

配置钉钉频道（推荐）

  1. 创建钉钉应用：

    • 登录 钉钉开发者后台。
    • 进入“应用开发” -> “企业内部应用” -> “钉钉应用”，点击“创建应用”。
    • 在应用的“能力添加”中，为你的应用添加一个“机器人”。
    • 配置机器人时，消息接收模式必须选择“Stream 模式”，这能让你的本地 CoPaw 直接接收钉钉消息，而不需要公网 IP。
    • 在“应用发布”中创建一个版本并保存。
    • 最后，在“基础信息” -> “凭证与基础信息”中，找到 Client ID (即 AppKey) 和 Client Secret (即 AppSecret)。这就是我们需要填的凭证。

  2. 在 CoPaw 中绑定：

    • 在控制台的“频道”页面，点击“钉钉”卡片。
    • 在右侧面板中，填入你刚复制的 Client ID 和 Client Secret，然后保存。
    • 在控制台配置钉钉

  3. 找到你的机器人聊天：

    • 保存配置后，回到钉钉 App。在消息页面的搜索框里，搜索你刚才创建的机器人名称。
    • 在“功能”分类下就能找到它，点击即可开始对话。你也可以把它拉进群聊里。
    • 在钉钉中找到机器人

其他如飞书、QQ、Discord 的配置逻辑类似，都需要先在对应开放平台创建应用、获取凭证，然后在 CoPaw 控制台里填入。详细的步骤在文档的频道配置一章里写得非常清楚。

五、让 CoPaw 拥有记忆（Memory）

这是 CoPaw 一个很实用的设计。它不仅仅是每次对话都“从头开始”，而是拥有跨会话的长期记忆。

  • 记忆如何工作？
    CoPaw 的记忆系统有两层：

    1. 上下文管理：当一次对话太长，快超出大模型的上下文窗口时，它会自动把之前的对话内容“压缩”成一个精华摘要，用这个摘要代替冗长的历史记录，从而保证对话能继续进行，同时不丢失关键信息。你也可以手动输入 /compact 命令来触发这个压缩过程。
    2. 长期记忆管理：它会把一些关键信息，比如你的偏好、项目的重要决策、日常的工作日志，写入到本地的 Markdown 文件中。比如，一个叫 MEMORY.md 的文件专门存放长期有效的信息，而 memory/ 目录下则会按日期生成 YYYY-MM-DD.md 文件，记录每天的交互摘要。
  • 记忆有什么用？
    有了记忆，你可以在周一让 CoPaw 帮你规划本周任务，周三再问它“我们这周的任务进度怎么样了？”，它就能从每天的日志文件里“回想”起来，并告诉你进展。它还可以通过 /memory_search 命令，用语义搜索的方式帮你找到过去讨论过的某个话题，即使你记不清是哪天聊的了。

六、让它自动工作（心跳与定时任务）

CoPaw 有两个核心功能来实现自动化，它们的目的略有不同。

  • 心跳 (Heartbeat)：
    这更像是一个“定期自检”或“每日摘要”功能。你只需要维护一个 HEARTBEAT.md 文件，里面写上你想让 CoPaw 定期思考的问题清单。然后在 config.json 里配置好检查间隔（比如 "30m" 表示每30分钟）和投递目标（"main" 表示只运行不发消息，"last" 表示把结果发到你上次对话的频道）。
    举个例子，你的 HEARTBEAT.md 里可以写：

    # 心跳检查清单
*   扫描收件箱，有没有紧急邮件？
*   检查我今天的待办事项，有没有快过期的？
*   如果未来2小时没有会议，提醒我可以专注工作。

    配置好心跳后，CoPaw 就会像心跳一样，默默地按固定间隔执行这套检查。

  • 定时任务 (Cron Jobs)：
    这更像一个通用的定时提醒和自动化工具。你可以通过 copaw cron create 命令或控制台创建多个任务。每个任务都可以独立配置时间、内容和投递目标。

    • 类型一：文本任务。比如，每天上午 9 点，向钉钉群发一句“早上好！”。
    • 类型二：Agent 任务。比如，每 2 小时，向 CoPaw 提问“我有什么待办事项？”，然后把它的回答转发到你的 QQ。
      定时任务的调度使用的是标准的 Cron 表达式，非常灵活。

七、扩展它的能力（Skills）

CoPaw 能做什么，完全由“技能 (Skills)”决定。你可以在控制台的“智能体” -> “技能”页面，像开关一样启用或禁用它们。

技能管理界面

内置的技能覆盖了很多常用场景：

  • 文档处理：pdf, docx, pptx, xlsx，可以创建、读取、编辑常见办公文档。
  • 信息获取：news 可以获取并摘要最新新闻；himalaya 可以通过命令行管理邮件。
  • 系统交互：browser_visible 可以启动一个真实的浏览器窗口，用于处理需要登录或验证码的场景。
  • 基础工具：file_reader 读取文本文件；cron 是定时任务的核心支撑。

如果你有自己的特殊需求，还可以创建自定义技能。在 ~/.copaw/customized_skills/ 目录下新建一个文件夹，里面放一个 SKILL.md 文件，用 Markdown 格式写清楚这个技能的 name、description 和使用说明，CoPaw 就能学会它。

八、核心配置与命令（CLI）

对于喜欢命令行的用户，CoPaw 提供了 copaw 命令来管理一切。

命令 功能 举例
copaw init 初始化工作目录和配置文件 copaw init --defaults
copaw app 启动核心服务 copaw app --port 9090
copaw models 配置 LLM 模型提供商和 API Key copaw models config
copaw env 管理工具需要的环境变量（如 Tavily API Key） copaw env set TAVILY_API_KEY "你的密钥"
copaw channels 配置聊天频道 copaw channels config
copaw cron 管理定时任务（需要服务运行中） copaw cron list
copaw chats 管理所有聊天会话 copaw chats list --channel dingtalk
copaw skills 管理技能开关 copaw skills config
copaw clean 清空工作目录所有内容 copaw clean --yes

所有与运行中服务交互的命令（如 cron, chats）都会自动读取 copaw app 运行时记录的 host 和 port。

九、常见问题解答 (FAQ)

  • 我的聊天记录和数据安全吗？
    是的。你的所有对话记录、配置文件、长期记忆文件，都默认存放在你本地电脑的 ~/.copaw 目录下。CoPaw 不会主动将任何数据上传到第三方服务器，除非你配置了需要调用外部 API 的技能（如新闻查询）。

  • 我必须一直开着终端和浏览器吗？
    你需要一直运行着 copaw app 这个服务（可以在后台运行）。控制台的浏览器页面可以关掉，当你需要配置或与它聊天时再打开。copaw app 服务运行着，你的频道（钉钉、飞书）才能收到并回复消息。

  • 如果我不小心把 ~/.copaw 目录删了怎么办？
    那你的所有配置、对话历史和记忆就都丢了。建议定期备份这个目录。当然，你也可以重新运行 copaw init 再配置一遍。

  • 可以用它来写代码、查资料吗？
    这取决于你给它配置的大模型和开启的技能。如果你配置的模型本身有很强的代码能力，那就可以。如果你开启了新闻技能，它就能帮你查新闻。

  • 我的电脑关机了，它还能工作吗？
    不能。CoPaw 服务运行在你的本地电脑上，电脑关机或休眠，服务就会停止，它也就无法接收消息或执行定时任务了。

总结

CoPaw 提供了一个很不一样的个人助理思路：它把数据和主动权完全交给你，同时利用你现有的聊天软件作为交互界面，尽可能地降低使用门槛。它不是一个需要你去适应的新平台，而是一个嵌入到你现有数字生活中的工具。无论是自动化的“心跳”检查，还是可扩展的“技能”体系，都让它有可能成为一个真正“为你工作，与你一起成长”的伙伴。

如果你对数据隐私比较在意，又喜欢折腾一些能真正提升效率的工具，不妨按照上面的步骤，在自己的电脑上部署一个试试看。详细的文档链接都附在下面，遇到问题随时查阅。

相关文档与链接：