runvouch

RunVouch

无人值守 AI Agent 的看门狗：证明任务已完成，并在任务未完成（或开始花钱）时立即发出警报；每次运行都有防篡改证明。
Claude Code Routines · headless claude -p · OpenClaw · n8n · cron

网站 · 文档 · 验证一次运行 · 一线笔记 · MCP Registry · Product Hunt

绿色状态表示调度器正常运行，不代表任务已完成。RunVouch 会在几分钟内针对计划任务中的 Agent 缺失、失败、循环、超出预算、行为偏移或无证据却报告成功等情况发出警报。

pip install runvouch     # or: npm install -g runvouch  (zero-dependency client + rv CLI)
rv agent nightly-report --cadence 24h --cap-run-cost 2 --evidence
rv run nightly-report --evidence-file out/report.html -- claude -p "build tonight's report"

无需客户端，也无需请求头：每个 Agent 还有一个 ping URL，因此任何能调用 URL 的工具都能上报。

0 3 * * * /usr/local/bin/nightly.sh; curl -fsS -m 10 https://api.runvouch.com/ping/<token>/$?

成功时无需任何操作；使用 /start 开始一次运行，使用 /fail，或提供退出代码。rv agent NAME 会显示 URL。

可验证的运行记录

每次完成的运行都会生成一条 sha256 记录；每天（UTC）都会生成一个 Merkle 根，与前一天的根链接，并通过 OpenTimestamps 在 Bitcoin 中加盖时间戳。每日文件公开发布在 https://api.runvouch.com/proof/，而 templates/verify_proof.py（仅使用标准库）无需我们的代码即可验证证明。所有套餐均包含此功能，Free 也不例外。

rv proof RUN_ID --verify     # recomputes leaf + Merkle path against the public day file, exit 0 or 1

亲自验证，无需账户： https://runvouch.com/verify 会提供我们自有集群中的一条真实密封运行记录，在浏览器中重新计算每个哈希，并提供一个可编辑字段的按钮，让你亲眼看到验证失败。

工作原理与限制：https://runvouch.com/docs/proof · 适用对象：https://runvouch.com/verifiable-agent-runs

检测器

警报	含义
MISSED	预期的运行从未开始（调度器失效、身份验证过期、首行日志写入前崩溃）
FAILED	运行以非零状态结束 / status=fail
NO_EVIDENCE	运行报告成功，但缺少所需证明（文件已写入、URL 返回 200、断言）；绿色 ≠ 完成
RETRY_STORM	同一次运行中，相同工具收到完全相同的输入 ≥ N 次（看不见的循环，造成 $437 的费用）
BUDGET_RUN / BUDGET_DAY	费用或 token 超出你设置的上限。在 Solo 和 Team 套餐中，Agent 会暂停，且在你运行 rv agent NAME --resume 前会拒绝下一次运行
DRIFT	时长 / 输出大小偏离过去 7 次运行的基线（稳健 MAD），悄悄开始做别的事
STALLED	已启动，但超过最长运行时间后仍未结束且没有心跳

警报会发送到电子邮件、Telegram、Slack、任意 JSON webhook、PagerDuty（Team）以及仪表板。

目录结构

runvouch/server.py            FastAPI + SQLite, all detectors, dashboard at /
runvouch/cli.py               `rv`, stdlib-only client: rv agent / rv run -- CMD / rv status / rv alerts / rv proof
integrations/claude-code-plugin Claude Code plugin: SessionStart/PostToolUse/Stop hooks → RunVouch
integrations/mcp                MCP server (stdio): runvouch_status/alerts/ack/runs/run_start/run_end
site/build.py                   generates the site into site/public/ (served by the same server)
tests/                          123 tests (pytest, no network)
docs/SELF_HOSTING.md            run it yourself: Docker or venv, what differs from hosted

自托管

单个进程、一个 SQLite 文件，可通过 Docker 或 venv 运行。完整指南见 docs/SELF_HOSTING.md（十分钟即可读完，介绍与托管服务的差异，以及之后如何迁移）。

cp .env.example .env && docker compose up -d          # or: pip install -r requirements.txt && ./run.sh
curl -X POST "localhost:8787/admin/accounts?name=me&plan=team" -H "X-Admin-Token: $RUNVOUCH_ADMIN_TOKEN"   # -> api_key

使用

export RUNVOUCH_KEY=rv_... RUNVOUCH_URL=http://localhost:8787
rv agent nightly-report --cadence 24h --cap-run-cost 2 --evidence
rv run nightly-report --evidence-file out/report.html -- claude -p "build tonight's report"
rv status ; rv alerts

Claude Code 插件：参阅 integrations/claude-code-plugin/README.md。 MCP：claude mcp add runvouch -e RUNVOUCH_KEY=... -- python3 integrations/mcp/runvouch_mcp.py

测试和贡献

.venv/bin/pip install -r requirements-dev.txt && .venv/bin/python -m pytest -q tests

请参阅 CONTRIBUTING.md。

托管版与自托管版

托管于 runvouch.com：3 个 Agent 免费，Solo 版 $19，Team 版 $99，包含警报、仪表板、服务器上的每夜数据库备份以及 EU 托管。自托管：本仓库，MIT 许可。代码相同。

比较

与 Healthchecks.io 对比 · 与 Cronitor 对比 · 与 Langfuse 对比

许可证

MIT。