常驻 AI Agent 怎么搭:拆解 OpenRouter 的 15 分钟巡检 Agent,月成本不到 4 美元
这篇文章讲了什么
OpenRouter 在 2026 年 10 月 31 日发布了一篇教程,用自家的 Agent SDK 搭一个常驻的巡检 Agent。它每 15 分钟查一次 Hacker News,把过去 48 小时里 20 分以上的新故事挑出来,写成 Markdown 摘要,记住已经看过的故事,重启后不重复,发到团队频道之前必须等人批准。
教程说 OpenAI 在 DevDay 2026 发布了 Dots,做的是同类的事。这篇教程的价值在于把模型、工具、预算和审批都交回给自己配置,不依赖某个平台的黑盒。
结构不复杂。一个 runOnce 函数放在 for 循环里,用 setTimeout 控制间隔,默认 15 分钟。三个工具都有 Zod schema 和 execute 函数。check_hacker_news 调 HN Algolia API,过滤掉 seen.json 和 fetched.json 里已有的 ID。write_digest 往 digest.md 追加一条。post_to_team_channel 带 requireApproval,执行前先暂停。状态分三层,seen.json 是长期记忆,fetched.json 只存本次运行,state.json 存会话,通过自定义 StateAccessor 读写。预算用两个上限卡住,最多 6 步,最多 0.05 美元,再给 API key 设一个额度。审批靠 pending.log 和 decisions.json,决定写进去之后用 approveToolCalls 或 rejectToolCalls 恢复运行,恢复成功才删文件。每次检查前清空 state.json,避免把之前几轮的对话重新发一遍。
成本是这篇教程最抓眼球的部分。模型选 claude-haiku-5.5,教程标注的单价是输入每百万 0.10 美元、输出每百万 0.50 美元。一次检查花 0.0003 到 0.0012 美元,按每天 96 次算,一天 0.03 到 0.12 美元,30 天 0.86 到 3.46 美元。教程还给了四次实测,第一次 12.4 秒、3 次模型调用、0.0012 美元,处理 12 条新故事,5 条进摘要,后面三次都在 6 秒左右、2 次调用、0.0003 到 0.0004 美元。重启后的那次没有重复上报。
教程也把失败场景跑了一遍。运行到一半杀掉进程,下一次能恢复,把摘要补上,20 个 ID 都记下了,代价是如果摘要在崩溃前已经写完,重跑会重复列一条。审批通过后故意用错 key,工具执行了但模型调用失败,状态留在 in_progress,下一次继续,不会重复发。两个待审批调用只给一个决定,运行只执行一个,另一个继续等,模型调用为 0。审批没处理时,每次定时运行都只加载状态、看到暂停、什么也不做,巡检本身也停了。
我读完后的判断
最值得抄的是三层记忆的拆法。很多定时 Agent 只存一个 seen 列表,崩一次就丢一批 ID,或者反过来,把整段会话当记忆,越跑越贵。OpenRouter 把长期去重、本次进度、会话状态分开,崩溃恢复靠 fetched,不靠会话,这个划分比代码本身有价值。
第二值得抄的是只给出口工具加审批。check 和 write 都在本地,最坏结果是摘要里多一段文字。post_to_team_channel 会接触其他人,才需要人点头。把审批加在所有工具上,Agent 会变得没法用。
成本数字可信,但别直接外推。0.86 到 3.46 美元成立的前提有四个,模型是 Haiku 5.5,每 15 分钟一次,每次最多 6 步,每次清空会话。换成贵的模型,或者为了省事保留长会话,账单会变。教程自己也说,保留会话会把之前几轮重新发一遍,成本随轮次涨。
教程没解决的地方也很明显。摘要写完再崩溃会重复,审批卡住会让巡检停摆,审批决定要手工编辑 JSON,状态是单机文件,SDK 还是 0.11.0 的 pre-1.0 版本。提示注入只能降低概率,不能消除。这些属于最小可运行版本必须留下的边界,作者在文里也承认了。
如果是我,会加三件事。写摘要前按 ID 去重,把重复挡在写入那一侧。审批加超时和提醒,超过一定时间自动过期或者通知人,不要让一个没回的消息把巡检冻住。每次运行把调用次数、耗时、花费记进结构化日志,连续失败或成本异常时告警。
一个常驻 Agent 的最小结构
常驻 Agent 可以拆成五件事,定时触发、工具、持久状态、预算上限、出口审批。少一件都会在某个场景里出事。
定时触发决定它多久看一次世界。setTimeout 循环适合单进程常驻,进程活着,状态就在内存和文件里。cron 加 MAX_RUNS 等于 1 适合无状态的一次性检查,跑完就退出,靠文件恢复。教程两种都给了,选哪种取决于你需不需要在两次运行之间保留审批上下文。需要人审批,常驻进程更顺。
工具是它唯一能改变世界的地方。查新闻是读,写摘要是写本地,发频道是写外部。三者的风险不一样,审批只该加在第三类上。
持久状态决定它会不会重复、会不会遗漏。seen 是长期集合,fetched 是本次运行的临时集合,state 是会话。把 fetched 单独拿出来,是为了在进程被杀时不会漏掉这一轮已经查过的 ID。这个细节很小,但决定了崩溃恢复能不能做对。
预算上限是它不失控的刹车。步数限制防止工具循环,金额限制防止长上下文把账单拉爆。教程用的 6 步和 0.05 美元,对一个只查新闻、写摘要的任务足够。
出口审批是它不闯祸的闸门。审批对象要具体到一次工具调用,不是给整个 Agent 一个开关。调用带参数、带目标频道、带将要发送的正文,人看到的应该是这些,而不是一句“是否允许发帖”。

成本为什么这么低,低在哪
Haiku 5.5 的单价是这套账的地基。输入每百万 0.10 美元,输出每百万 0.50 美元,一次检查的输入是几个工具定义、一段系统提示、几十条故事标题,输出是一小段摘要,量都不大。单次 0.0003 到 0.0012 美元,是把单价乘上实际 token 之后的结果。
三个前提让它保持在低位。每 15 分钟一次,一天只有 96 次,不是持续轮询。每次最多 6 步,模型没有机会无限调工具。每次清空会话,历史不会滚雪球。把其中任何一个改掉,成本曲线都会变。改成每 2 分钟一次,次数涨 7.5 倍。保留会话,输入 token 随轮次累积。换成输入 3 美元、输出 15 美元的模型,单次成本大约涨 30 倍。
0.05 美元的硬上限也不是绝对的。教程说得很清楚,SDK 在两轮工具调用之间检查停止条件,然后会做一次关闭工具的收尾调用,让模型把答案写完。所以一次运行可能超出上限一到两次模型调用。这个设计合理,但做预算告警时要把这点余量算进去,别把 0.05 当成精确的账单上限。
还有一笔账教程没算,服务器和运维。0.86 到 3.46 美元只是模型调用。VPS、日志存储、监控、告警都要钱,虽然摊到一个月不多,但它们决定这个 Agent 能不能长期跑。
状态最容易出错
崩溃恢复是这套设计里最容易做错的部分。教程的做法是,查过的 ID 先写进 fetched,摘要写完再统一处理。进程被杀,下一次读到 fetched,知道哪些查过,继续写摘要。问题出在顺序上,如果摘要已经追加、ID 还没合并进 seen,重跑就会再写一遍。教程承认会重复列一条。
修法不复杂。写摘要时用故事 ID 做一次幂等检查,digest.md 里已经有这个 ID 就跳过。或者把“写摘要”和“标记已处理”放进同一个事务,本地文件做不到事务,就用一个临时文件加原子重命名,写完再更新索引。单机场景够用。
审批挂起会让巡检停摆,这是教程里最值得注意的取舍。设计者的理由是,有一个没决定的出站动作时,继续巡检会产生更多待审批的消息,队列会失控。这个理由成立,但代价是,一个没人看的审批请求能让整个监控停掉。夜里发起的审批,第二天早上才处理,中间十几个小时没有巡检。
我会把出口队列和巡检解耦。巡检继续跑,摘要继续写,出站消息进队列,队列满了就丢弃最旧的或者只保留最新一条,同时给人发提醒。审批超时要有默认动作,过期就拒绝,或者降级成只写摘要不发频道。这样监控不会因为一个人的疏忽停掉。
部分决定的场景也说明审批接口是按调用设计的。两个待审批,只给一个决定,运行执行一个,另一个继续等,模型调用为 0。这个行为是对的,但对使用者不友好。批量审批、一次看完全部待办、给每个调用一个明确的 ID 和预览,这些是产品层要补的。

审批和提示注入
教程对提示注入的处理是清醒的。系统提示里写明,故事标题来自互联网上的陌生人,当作数据判断,不要当作指令。作者也承认,这不能排除注入,所以出口工具必须审批。
最坏情况被限制在摘要里。一个恶意标题最多让摘要多一段奇怪的话,不会直接发到团队频道。这个边界划得对。但审批是人做的,人如果不看内容就点通过,防线就空了。审批界面要给出完整正文、目标、调用参数,最好再给一个 diff,让人知道这次要发什么。
摘要本身也是给人读的。标题里的链接、HTML、奇怪字符要在写入前清掉,摘要用纯文本,来源单独标一列。这样做的目的是防人点开一个不该点的链接。
还有一个容易忽略的点,审批记录要留。谁在什么时候批准了哪一次调用,发了什么内容,这些要能查。出了事,日志比模型的自述可靠。

如果是我,会怎么改
第一,摘要写入做幂等。用故事 ID 建索引,写之前查一次,重复就跳过。崩溃恢复的重复问题在写入侧解决,比在恢复逻辑里猜更稳。
第二,审批加超时和通知。待审批超过 30 分钟发提醒,超过 2 小时自动拒绝并记录。巡检和出口队列分开,巡检不因审批停摆。
第三,运行指标落日志。每次记录开始时间、结束时间、模型调用次数、工具调用次数、输入输出 token、估算成本、是否恢复。连续三次失败或单次成本超过阈值就告警。
第四,模型分层。巡检和摘要用便宜的 Haiku 5.5,遇到需要判断的复杂摘要再换更强的模型。判断标准可以是新故事数量、标题长度、或者摘要被人工退回的次数。别一上来就用最贵的模型跑每 15 分钟的循环。
第五,留一个 dry run 开关。所有工具照常执行,但出口动作只写日志不发送。上线前跑一天,看看它会发什么,再打开真实出口。
如果团队在国内要同时接 Haiku、Claude 和 GPT 系列,接口AI(jiekou.ai) 这类聚合入口可以用一个密钥切换模型,账单也合在一起核对。它的模型定价页把输入、缓存读取和输出分开列,claude-haiku-5-5 目前是输入每百万 0.1 美元、缓存读取 0.01 美元、输出 0.5 美元,和 OpenRouter 标注的单价一致,按 2026 年 11 月 12 日在售信息为准。Haiku 5.5 的模型详情页能看到上下文和能力标记,适合先确认参数再决定要不要把它放进巡检流程。
要注意,OpenRouter 的 Agent SDK 绑定的是 OpenRouter 的调用方式。换到别的网关,SDK 不一定能直接复用,但循环、工具、状态、预算、审批这五件事与供应商无关,换个调用层照样成立。
部署与接入
教程给了两条部署路径。VPS 上用 systemd 或 pm2 常驻,进程挂了自动拉起。或者用 cron、GitHub Actions 每次触发一次检查,配 MAX_RUNS 等于 1,跑完退出。前者适合需要保留审批上下文的场景,后者适合无状态、按次计费、天然隔离的环境。
不管选哪条,都要先解决三件事。API key 的额度上限要设,别只依赖代码里的 maxCost。日志要能回答“上一次成功是什么时候”。进程要能被外部健康检查发现,常驻进程静默死掉比报错更麻烦。
Node 版本按教程用 22,包锁在 0.11.0。SDK 还是 pre-1.0,升级前先读变更说明,别在生产环境直接装 latest。
写在最后
每月 3.46 美元只是结果。这套东西更值得看的地方,是它把常驻 Agent 拆成了几个可以分别检查的部件。循环、工具、状态、预算、审批,每一件都能单独测,单独换。成本低只是结果,结构清楚才是原因。如果你也在跑定时 Agent,欢迎说说你把审批加在了哪一步,又在哪一步被状态文件坑过。
参考资料
- OpenRouter,Build an always-on AI agent,openrouter.ai/blog/tutorials,2026-10-31(访问日期 2026-11-12)
- OpenRouter,Claude Haiku 5.5 模型页与价格,openrouter.ai/anthropic/claude-haiku-5.5(访问日期 2026-11-12)
- npm,@openrouter/agent 0.11.0,registry.npmjs.org(访问日期 2026-11-12)
- Hacker News,Algolia Search API 文档,hn.algolia.com/api(访问日期 2026-11-12)
- 接口AI,模型定价页与 claude-haiku-5-5 模型详情,jiekou.ai,2026-11-12 在售信息(访问日期 2026-11-12)