安装
curl -fsSL https://get.cotal.ai | shCotal 是一个面向 AI 智能体的开源发布/订阅(pub/sub)标准,让不同应用和机器上的智能体与服务共享一个协作空间。它的 TypeScript 实现运行在 NATS + JetStream 之上,包含 CLI、连接器、进程管理器、持久化工作流和观测工具。
适合谁
- 想让多个 AI 智能体在本地跨应用、跨机器协同工作的开发者或团队,尤其是希望用统一的服务契约(描述与调用)来组合智能体能力的场景。
- 适合愿意在本地跑一套后台进程(mesh、投递守护进程、管理器)的用户。
- 不适合的情况:如果你的需求是纯一次性脚本、无法接受本地常驻后台进程,或环境没有 Node 22.10+(且不便使用官方 curl 安装器),需要先确认可行性。Windows 用户官方给出的路径是 npm 安装方式。
3 分钟完成第一次尝试
推荐主路径是官方 curl 安装器(写入用户主目录,无需 sudo,并会打开引导式设置):
curl -fsSL https://get.cotal.ai | sh
安装完成后启动本地环境:
cotal up
cotal up 会在后台启动本地 mesh、投递守护进程和管理器。随后可以:
cotal spawn:在终端打开一个智能体。cotal console:查看团队(智能体)情况。
一个低风险的首次观察动作是运行 cotal console,观察本地团队状态;不产生远端写操作。若要停止本地堆栈,官方命令是 cotal down。
次要方式(官方明确给出,非并列主入口):已有 Node 22.10+ 或在 Windows 上,可用 npm install -g cotal-ai,然后运行 cotal setup。设置过程会准备一个空间(space)、配置所选应用并种下一个 default persona;如果只想做准备而不应用配置,可用 cotal setup --configure-only。
注意:引导式设置会写入本地配置(空间、应用配置、persona),这是本地状态写入,不是只读动作。
使用案例
案例一:查看本地团队状态。场景:你刚装好 Cotal,想确认本地 mesh 已启动。做法:先 cotal up 启动后台进程,再运行 cotal console。可期待的结果:看到当前空间中团队成员的展示;这是证据范围内可直接确认的观察步骤。
案例二:让智能体请求队友协作。场景:你在终端用 cotal spawn 打开一个智能体后,希望它拉入新的队友。做法:Cotal 暴露给智能体的工具包括 cotal_spawn(请求队友)以及 cotal_describe 和 cotal_invoke(在其连接器和授权允许的范围内发现并调用服务的命令契约)。可期待的结果:智能体通过这些工具发起队友请求或调用服务契约;具体输出细节官方文档未逐一列出,能确认到的是这些工具的存在与触发方式。
使用边界
- 读写性质:
cotal up/down管理本地后台进程,cotal setup会写入本地配置(空间、应用配置、persona);cotal console属于观察类操作。不要把本地写入当成"只读"。 - 副作用与确认点:CLI 默认发送使用遥测数据;这是官方明确说明的副作用,可在启动前执行
cotal telemetry off关闭。 - 凭证与权限:智能体的调用能力受其连接器与授权(grants)限制;官方未说明授权的默认范围,使用前需在自身环境中确认。
- 尚未确认的信息:遥测的具体数据内容、mesh 的网络暴露范围、
cotal_describe/cotal_invoke的具体返回格式,官方页面均未给出说明,无法替你判断隐私与网络边界。 - 以上不构成独立安全结论;是否适合你的环境,请结合上述已知与未知自行判断。