Cortico - 围绕事件流构建的自主智能体运行框架

Cortico 是一个围绕事件流（event stream）设计的 agent harness，目标场景是自主运行、持续在线、需要处理混合实时输入的智能体。按照项目自述，它适合人格机器人（persona bot）、AI 主播、角色扮演、陪伴类应用以及其他下游任务。它并不把自己定位成一个聊天机器人框架：项目说明中称，Cortico 的智能体系统围绕事件流构建，用来搭建能够处理复杂输入的持久化 AI 智能体，并通过外部扩展让同一个机器人同时观察和作用于多个环境，包括聊天平台、实时游戏，甚至物理环境。项目把目标概括为「把你的 AI 带到世界里」。适合的读者是希望自建长期在线智能体、并且愿意通过扩展接入外部环境的开发者。

维护者与状态

项目由 Pal-AI-Lab 维护，仓库创建于 2026-09-13，最后一次提交时间为 2026-10-11。最新 release 为 v0.1.12，发布于 2026-10-11。截至 2026-10-12，仓库星标数为 203。许可证为 MIT。从版本号看，项目仍处于 0.1.x 阶段，属于早期发布节奏。

主要能力

以下能力均来自项目自述（README），并非第三方评测结论。

• 原生 agent harness：项目称其一切设计都围绕 agent 展开，而不是在既有聊天框架上叠加智能体逻辑。
• 模块化 LLM provider 组件：内部基于 Responses 协议构建，项目说明其支持多种上游 LLM API，也支持在本地部署的模型。
• 不受约束的内部上下文管理：据项目说明，这为 agent 行为模式与 Memory 系统的设计留出了较大自由度。
• 扩展系统（Cortico World）：与内部隔离，以事件投递和工具调用作为输入与输出，项目称其具备良好的兼容性和近乎无限的扩展空间。
• WebUI 控制台：项目称操作直观；控制台界面提供简体中文、繁體中文、English、日本語、한국어、Français、Deutsch、Español (Latinoamérica)、Português (Brasil)、Italiano、Русский 等语言。项目同时说明，控制台语言不改变模型读到的内容，Core 加入模型上下文的文本为英文。
• Extension Creator 系统（Cortina）：面向 AI 开发的扩展创建工具，项目称非开发者也能借助 AI agent 构建想要的扩展，或把已有实现迁移到 Cortico 上。

项目自述中还给出了四层职责划分：Core 负责会话生命周期、事件流与模型调用，本身不含语义；Persona 定义某一类机器人的语义，包括上下文合成、认知循环与 Memory 协议；Memory 是内部状态的权威持久化存储，其布局与生命周期由 Persona 决定；World 是与外部环境之间的隔离边界，负责事件摄入、工具声明与环境提示词；Bot 则是装配定义，把一个 Persona 与一组指定的 World 组合起来。

内置 World 方面，README 列出了终端、QQ、Bilibili 直播、Minecraft 与网页搜索五项，分别对应控制台内的双向对话、多群与私聊频道（可选视觉模型转写）、实时弹幕与礼物等直播事件加本地 OBS 叠加层、基于 Mineflayer 的 vanilla 服务器客户端，以及由 Brave Search API 驱动的实时网页搜索。项目还说明，每个 release 会同时把 minecraft、qq、bilibili、websearch 以 cortico-world-* 的形式发布到 npm，供未内置这些 World 的下游应用使用；若框架已有同 id 的 World，则已安装的包不会被加载。

模型 provider 方面，README 列出 openai-responses-compat（任何支持 Responses 协议规范的模型 API）与 llamacpp（本地 llama-server 运行时，含二进制自动下载与进程管理）。项目称其他上游协议与 provider 可通过扩展接入。

使用入口

仓库地址：Pal-AI-Lab/Cortico。

据项目说明，运行需要 Node 22 及以上版本，快速开始命令为：

corepack pnpm install
pnpm start

首次在空部署目录启动时，项目称 Cortico 会自动初始化一个名为 mybot 的默认部署（使用参考机器人 cormini，并启用终端聊天），并在 http://127.0.0.1:7788/ 启动 Web 控制台。终端页面会给出三步引导：配置模型端点、查看已激活的 World、调整系统提示词；配置好端点后点击 Say hello 即可让机器人主动发起对话。端点、凭据与运行时参数都可以在控制台直接调整，已保存的改动在下一个请求生效，托管运行时的启动参数在其下次启动时生效。控制台初始语言取自 config.json 中的 language，其次取 CORTICO_LANGUAGE，再其次取系统区域设置；Settings → General 可在不重启机器人的情况下为当前浏览器切换语言。

部署管理方面，每个部署是 deployments/ 下相互隔离的配置目录。新增部署使用 pnpm start --new，按名称启动指定部署使用 pnpm start second。启动脚本（pnpm start、./start.sh 以及 Windows 上的 start.bat）会自动安装缺失依赖、在控制台资源缺失或早于源码时重新构建、在交互式终端列出所有部署供选择（含新建入口），并可按控制台请求重启进程。

许可与限制

Cortico 主仓库采用 MIT 许可证。需要留意的是，项目自述中提到的 AI VTuber 扩展 cortico-world-vtuber 使用另一套源码许可（AGPL-3.0 + CLA），因此放在独立仓库而非 Cortico 主树中；如果打算使用该扩展，需按其自身仓库的许可条款判断。

已知前置条件与边界：运行环境要求 Node 22 及以上；本地模型推理依赖 llamacpp provider 与 llama-server 运行时；网页搜索 World 依赖 Brave Search API；Minecraft World 面向 vanilla 服务器。项目自述中的扩展系统与 World 之间存在隔离边界，且框架已内置同 id World 时不会加载同名 npm 包，这一点在组合扩展时需要确认。此外，README 中关于能力、兼容性与扩展性的表述均为项目自述，实际表现需以自行部署验证为准。