Revenium 智能体计量护栏

要解决什么问题

OpenClaw 这类会多轮调工具、长回复的代理，开销往往按「会话」汇总，却很难回答更细的问题：这笔钱主要花在 research 还是 generation？某次「把分页接口做完」的目标弧是成功、失败还是被预算掐断？若 Revenium 里配置了按指标、时间窗的硬上限，代理侧也必须在每次回应与工具调用之前知道当前是否已 halt 或 warn，而不是事后看账单。

技能如何工作

技能把运行时状态固定在 ~/.openclaw/skills/revenium/：由 cron 周期性同步 Revenium 护栏结果到本地 guardrail-status.json，代理只读该文件做闸门判断（文档强调在 OpenClaw 注入未确认前，HALT CHECK 是主 enforcement，而非可选提示）。

• 护栏流程：halted === true 时只能输出带规则名、指标类型、当前值/硬上限的 halt 文案，禁止继续读技能、调工具或回答问题；warned === true 时先列出 warnedRules，询问用户是否仍在 warn-and-ask 模式下继续，未获许可不得执行操作。
• 任务分类：在触发条件满足时（例如调用了非只读工具、新内容超过约 200 词、或需多步推理），从 8 类固定标签选 task_type，调用 write-marker.sh，让后续 completion 能带上正确的 --task-type。
• 作业声明：在目标弧结束（成功自证、确定失败、或 pivot 前先对旧弧写 CANCELLED）时，选定 11 类 job_type、生成 agentic_job_id，调用 write-job-marker.sh 上报 SUCCESS / FAILED / CANCELLED（失败需 --failure-reason）。
• 初始化门槛：若 config.json 不存在或 ruleIds 为空，必须先走 Setup Flow（验证 Revenium CLI、由流程写入规则绑定），不能由代理自行填写预算或 rule ID。

注意点

护栏文件缺失时技能会提示并fail open 继续执行，与硬 halt 不同；生产环境应确保 install-cron.sh 已部署。任务/作业 marker 漏写不会阻断回答，但计量会落入 unclassified 或仅会话级，按任务类型与 job 的预算规则将失真。HALT 与分类规则依赖模型每轮执行 SKILL 指令，在缺少平台级 hook 时仍有被跳过的可能。