产品简介
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:
- 进入左侧菜单的 Settings (设置)。
- 选择 Models (模型) 选项卡。
- 点击 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 和隐私数据泄露。