快速开始 - Failproof AI

本快速开始指南将帮助你完成：让一台机器上报会话、运行审计，并部署一个策略。你可以使用技能包来完成 Failproof 的配置，也可以按照手动步骤操作。 选择适合你的路径： 如果你的 Agent 运行在 12 个受支持的执行环境之一中——例如编码 CLI，或 Hermes、OpenClaw 等网关——请按照以下步骤操作；你需要 Node.js 20.9 或更高版本。如果你的 Agent 没有执行环境，请使用 Python SDK 对其进行埋点以实现追踪和审计，然后从运行你的首次故障检查处继续；该路径下的执行能力需要在你的运行时中添加一个 hook。

使用技能包
手动配置

安装 Failproof AI 技能包

npx skills add FailproofAI/skills

让你的 Agent 完成所有配置

Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives.

你的 Agent 会检查项目、选择相关集成、执行配置并验证会话是否正常到达。如需了解各个技能及高级安装选项，请参阅 FailproofAI 技能仓库。

开始之前

打开 Failproof AI 控制台，创建账号或使用工作邮箱登录。
进入 Administration → Keys，创建一个具有 events:add 和 policies:pull 权限的密钥。
复制一次性密钥，并将其保存到目标机器上：

export FAILPROOFAI_KEY="<one-time-secret>"

安装

安装并连接 Failproof AI

npm install -g failproofai
failproofai config --connect https://app.befailproof.ai --token "$FAILPROOFAI_KEY"

默认情况下会发送会话记录。添加 --no-transcripts 可在不包含记录内容的情况下上报 hook 活动和策略决策。如果这台机器上已有 Agent 历史记录，可预览并导入最近七天的数据，然后等待传输完成。若是全新机器，请跳过此步骤。

failproofai backfill --since 7d --dry-run
failproofai backfill --since 7d
failproofai flush --wait

在 Failproof AI 中打开 Sessions，选择一个已导入的会话。

安装 Agent hook 和策略

此步骤会将 Failproof AI 附加到你的执行环境，并安装 39 个内置策略。在 Failproof AI 审计你的会话并为你的 Agent 编写策略之前，你可以先通过这些策略查看本地策略决策并试用执行功能。你可以让安装程序自动检测你的执行环境，也可以明确指定一个。12 个执行环境都是有效的 --cli 参数值——claude、codex、copilot、cursor、opencode、pi、hermes、openclaw、factory、devin、antigravity、goose。

failproofai policies --install --cli claude --scope user     # 编码 CLI
failproofai policies --install --cli hermes --scope user     # Slack/Telegram 网关

在工具调用执行前拦截的功能已在全部 12 个执行环境中验证。轮次结束门控已在 8 个环境中验证——各执行环境的详细矩阵请参阅执行能力。

审计行为

按照运行你的首次故障检查进行操作。请使用具体的目标，例如”查找 Agent 在未改变方法的情况下重试失败工具的会话”。

预防故障

按照使用策略预防首次故障进行操作。先以观察模式启动，检查匹配结果，然后对审查后的版本执行强制策略。

运行 failproofai config --status。配置健康时，该命令会报告云连接状态、守护进程状态，以及执行功能是否已暂停。

​开始之前

​安装

开始之前

安装