Chloe

产品简介

Chloe 是一款以 TypeScript 代码为核心的 AI 代理框架。它把代理写成一个普通的异步函数,每一步用最合适的工具：能用代码的就用代码,需要模型判断的才让模型上场,需要自主决策的才放开给模型。它不是又一个让大模型自己决定每一步的聊天框架,而是把控制权交还给开发者。安装方式 npm install @chloejs/core && npx chloe setup,要求 Node 22.18 及以上,MIT 协议,自带 npm skill 一键安装。

核心功能

1. 三段式原语 work.step / work.model / work.agent：开发者主动选择每一步由代码、模型还是代理执行,默认用最确定的方式,避免让 LLM 决定一切造成的不可控与不稳定。
2. 步骤级全记录：每一次运行都把每一步做了什么、花了多少钱记到档案里,任务可以挂起,等人在 Slack 里确认几天后再继续,适合需要人工把关的关键工作流。
3. 多渠道触发：Cron 定时、聊天指令（Telegram / Slack）、HTTP API、网页 chat 都可以启动同一个代理,所有运行记录统一归档到同一份 SQLite 文件。
4. 测试与评估分离：npm run test 用真实作业流水线跑集成测试（占位模型,免费），npm run evals 逐条评估模型决策正确率,eval 不会真实调用工具,跑过不会发邮件或下单。
5. 本地优先 + 自托管：可在自己 Mac、Linux 上用 npx chloe install 启动,不绑定任何云平台；也可以接入任意 LLM（自付费的 Claude/ChatGPT、OpenRouter 免费模型都行），不调模型的任务零成本。
6. 网页聊天能力：Agent 文件里加 web 渠道,站点服务端贴一段 script 标签,访客就能和同一个代理对话；token 按域名+智能体+访客三重配额限制,适合做站点客服。
7. 代码优先：Agent 是普通 TypeScript 文件,可以像任何代码一样 review、单元测试、版本管理、CI/CD,没有 nonce 的隐藏状态。
8. 可计费：每次运行的成本一目了然,适合需要按调用量计费的内部场景或对外服务。

特色优势

• 按预算升档：三个原语对应不同的成本与确定性,任务从低到高逐级使用,默认走最稳的路径。
• 决策权归人：模型只能问“是不是/写什么/怎么排”,工作流怎么走由开发者设置,部署后不会被模型随意改变。
• 开源与可移植：MIT 协议,代码自托管,无平台绑定,无 vendor lock-in,可以无成本切换底层模型。
• 与 LangChain 互补：LangChain.js 适合大型状态图,Chloe 适合“用代码能写 80% + 只在剩下的地方问模型”的典型业务自动化。

应用场景

• 定时巡查：扫订单、扫邮件、扫数据库,发现异常自动发飞书/邮件。
• 客服分诊：模型读消息分类,代码根据分类把工单分到不同队列。
• 审批工作流：关键步骤挂起,等人在 Slack 里点确认,适合发票、报销、权限变更等需要人工把关的场景。
• 跨服务自动化：从数据库读数据、调外部 API、生成报告、自动写回 Google Sheet。
• 个人助理：把“每日提醒+查一下新闻+生成摘要+翻译长文”写成一个小型工程,本地跑、私密、零云费。

适用人群

• 后端工程师想把内部流程交给代理但不想失去控制
• 把“定时任务”升级成“能自主判断”的产品经理
• 对数据合规、本地部署有要求的企业团队
• 不想被 LangChain 等大型框架绑死的技术决策者

出品方

作者 carlosmartinezt,GitHub 仓库 carlosmartinezt/chloejs,npm 包名 @chloejs/core,MIT 许可。提供 npx skills add carlosmartinezt/chloejs -y 一键安装 Skills,方便 AI 代理在接手前了解项目用法。

官网链接

• 官网与文档：https://chloejs.org/
• GitHub 仓库：https://github.com/carlosmartinezt/chloejs
• npm 包：https://www.npmjs.com/package/@chloejs/core