产品简介

CoPaw (Co Personal Agent Workstation) 是由阿里巴巴团队开源的个人智能体工作站。它基于高级的 AgentScope 框架,旨在为用户提供一个统一的、具备长期记忆的 AI 代理环境。

核心差异: 与 OpenClaw 相比,CoPaw 更专注于长期记忆 (Long-term Memory) 和多 Agent 协作流的图形化管理。

安装与初始化

CoPaw 推荐通过 Node.js 全局安装,这可以确保您在任何终端都能快速调用命令。

1. 全局安装

npm i -g copaw

2. 环境初始化

安装完成后,运行以下命令进行首次环境检查和依赖配置:

copaw init

系统会引导您设置基础的存储路径和默认模型偏好。

控制台使用

CoPaw 提供了一个非常直观的 Web 图形化界面(Dashboard),方便您管理 Agent 和观察 AI 的思考过程。

启动 Dashboard

copaw app
访问地址: 启动后,请在浏览器中打开 http://127.0.0.1:8088 进入控制面板。

API 对接详解 (Codex API)

在 CoPaw 控制面板中,您可以按照以下步骤对接 Codex API:

  1. 进入左侧菜单的 Settings (设置)。
  2. 选择 Models (模型) 选项卡。
  3. 点击 Add Custom Model 或编辑现有 OpenAI 类型配置。

配置参数对应表

参数项 填入内容
Provider OpenAI (或自定义名称)
Model Name claude-3-5-sonnet (推荐)
API Key 您的 Codex API 令牌
Base URL https://ai.zkmjnic.tech/v1
注意: 修改配置后,请确保点击页面底部的“Save & Test”以验证连接是否畅通。

核心概念 (ReMe)

理解以下概念有助于您发挥 CoPaw 的最大潜力:

ReMe (Remote Memory)

这是 CoPaw 的杀手锏功能。它允许 Agent 将对话中的重要事实、个人偏好和技术细节存储在持久化数据库中。即使开启新对话,AI 依然记得您的习惯。

Channels (渠道)

CoPaw 可以将同一个 Agent 同时分发到不同的平台。您可以在飞书上收到来自 CoPaw 的工作提醒,在 Discord 上与之讨论代码。

常见问题 FAQ

Dashboard 无法打开?

请确认 8088 端口未被占用。如果冲突,可以使用命令 copaw app --port 8090 更改端口。

记忆功能不生效?

检查 ReMe 服务是否已开启。部分模型(如轻量级模型)可能无法很好地处理记忆检索指令,建议优先使用 Claude 3.5 系列模型。

紧急提示: CoPaw 运行在本地。请勿将控制面板地址(127.0.0.1:8088)通过内网穿透直接暴露在公网,这可能导致您的 API Key 和隐私数据泄露。