AgentRx
v1.0.0用于AI代理工具故障的AgentRx恢复层。每当任何外部工具调用失败、返回错误、超时或表现出意外行为时,请使用此技能...
运行时依赖
安装命令
点击复制技能文档
AgentRx — AI Agent Recovery AgentRx 是一个用于 AI 代理的生产恢复 API。当您的工具调用失败时,AgentRx 告诉您接下来要做什么。 何时使用此技能 当以下任何情况发生时调用 AgentRx: 工具调用返回错误、超时或意外响应 工具调用成功,但结果看起来不正确或为空 您即将调用高风险工具(支付、删除、API 写入) 您已经多次重试同一个工具但没有成功 设置 在您的 OpenClaw 配置中设置以下环境变量: AGENTRX_API_KEY=beta_openclaw_try_agentrx_2026 AGENTRX_BASE_URL=https://agentrx-production.up.railway.app 验证集成是否激活: curl -s "${AGENTRX_BASE_URL}/ready" 恢复 工具调用失败后,立即使用恢复脚本调用 AgentRx: bash ~/.openclaw/skills/agentrx/scripts/recover.sh \ "您的代理 ID" \ "失败的工具名称" \ "错误消息" \ 0 参数: agent_id — 您的稳定代理标识符(例如 "lamar_cmo") tool_name — 失败的工具名称(例如 "web_search") error_message — 返回的错误文本 error_code — 如果可用,HTTP 状态代码,否则为 0 读取响应 AgentRx 返回一个 JSON 对象。最重要的字段是: openclaw_instruction — 读取此字段并立即执行它。它是一个直接的纯文本命令,不需要解释。 示例: "等待 2000ms,然后重试同一个工具调用到 'web_search'。" "停止执行。立即通过 Telegram 提醒 Steven。" "跳过此步骤并继续下一个计划操作。" "使用此修正后的有效负载重试 'payment_tool':{...}" 也请检查: action_type — 分类的恢复操作 failure_signature — 检测到的故障类型 confidence_score — AgentRx 的置信度(0.0 到 1.0) corrected_payload — 如果提供,使用它代替原始有效负载 预检 在调用任何写入数据、发送消息或花费钱的工具之前: bash ~/.openclaw/skills/agentrx/scripts/preflight.sh \ "您的代理 ID" \ "工具名称" \ "{'您的': '有效负载'}" \ "{'type': 'object', 'properties': {'您的': {'type': 'string'}}}" 如果响应包含 "proceed": false — 不要执行工具。使用 suggested_correction 修正有效负载,然后重试。 恢复协议 在每个工具失败时遵循此确切序列: 调用 recover.sh 以获取失败详细信息 读取 openclaw_instruction 字段 执行指令,确切按照写的那样 如果 action_type 是 HUMAN_HANDOFF — 停止并立即提醒 Steven 如果 action_type 是 RETRY_WITH_BACKOFF — 等待 retry_after_ms 然后重试 如果 action_type 是 RELAX_SCHEMA — 使用 corrected_payload 重试 如果 action_type 是 SKIP_AND_CONTINUE — 跳过工具,继续计划 如果 action_type 是 REFRESH_AUTH — 在重试之前获取新凭证 使用每个恢复的 trace_id 进行调试 安全注意事项 永远不要在任何脚本或提示中硬编码 AGENTRX_API_KEY 总是从环境变量中读取它 每个响应中的 trace_id 链接到服务器端日志