mcpField
P
proactive-agent

proactive-agent

github.com/alphaonedevAgent 工作流65 次安装
代码仓库

关于 proactive-agent

为 OpenClaw 提供自主监控条件并触发操作的 Skill。它支持定时或事件驱动检查，可通过配置文件设定规则，并使用命令行或 REST API 控制。

主要功能

  1. 01按可配置规则监控条件
  2. 02运行脚本、发送通知或调用 API
  3. 03支持定时和事件触发
  4. 04记录操作状态与日志
  5. 05通过命令行或 REST API 控制

适用场景

  1. 01响应服务器指标越过阈值
  2. 02无需提示词即可按事件触发操作
  3. 03自动化 CI/CD 工作流中的响应
  4. 04通过 Webhook 发送告警

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/alphaonedev/openclaw-graph --skill proactive-agent

安装后在 Claude Code 中输入/proactive-agent确认已加载。

详细介绍

主动 Agent

用途

此技能让 OpenClaw 能够充当主动 Agent，监控系统状况，并在无需用户输入的情况下自主触发预定义操作。它适用于需要持续监督的场景，例如资源监控或自动响应，并借助 AI 减少人工干预。

适用场景

当你需要自主运行时使用此技能，例如监控服务器指标并在达到阈值时做出响应，或在没有提示词的情况下根据事件触发工作流。可将其用于生产环境中的错误预防、IoT 设置中的实时响应，或 CI/CD 流水线中的自动修复。

主要功能

  • 使用可配置规则监控状况，例如 CPU 使用率 > 80% 或文件大小 > 1GB。
  • 在无需用户交互的情况下触发操作，例如执行脚本、发送通知或调用 API。
  • 支持定期检查（例如每 5 分钟一次）或事件驱动触发。
  • 通过 webhook 或 API 与外部服务集成，实现无缝自主运维。
  • 记录日志并跟踪状态，以保留触发操作的审计线索。

使用模式

要使用此技能，请先定义一个指定监控项和操作的配置文件，然后通过 CLI 或 API 启动 Agent。务必先设置身份验证。例如，可让 Agent 在循环中运行以持续监控，或将其集成到更大的脚本中，以便有条件地启动。在部署到生产环境之前，确保在预发布环境中测试监控项。

常用命令/API

快速启动可使用 OpenClaw CLI，程序化控制可使用 REST API。执行命令前，必须设置环境变量 $OPENCLAW_API_KEY 进行身份验证。

  • CLI 命令：使用配置文件启动 Agent。

    openclaw proactive-agent start --config path/to/config.json --interval 300

    此命令每 300 秒监控一次状况；使用 --dry-run 可模拟运行而不执行操作。

  • API 端点：通过 HTTP 触发 Agent 或查询其状态。 POST /api/v1/proactive-agent/run with body: {"monitor": "cpu>80", "action": "restart"}

    curl -H "Authorization: Bearer $OPENCLAW_API_KEY" -X POST -d '{"monitor":"cpu>80","action":"restart"}' https://api.openclaw.com/api/v1/proactive-agent/run

    响应中包含状态和任何错误。

  • 配置格式：用于定义规则的 JSON 文件。

    {
  "monitors": [{"type": "cpu", "threshold": ">80"}],
  "actions": [{"type": "exec", "command": "systemctl restart service"}]
}

    通过 CLI 或 API 加载此文件，以定义要监控的内容及要执行的操作。

  • 停止命令：平稳停止 Agent。

    openclaw proactive-agent stop --id agent123

    使用启动命令输出中的 --id 标志。

集成说明

可将此技能嵌入脚本或服务中进行集成。例如，设置 webhook 并与 Prometheus 等监控工具结合：在配置中添加 "webhook": "https://your-service.com/hook"，以通知外部系统。在 Node.js 应用中使用 API：

const fetch = require('node-fetch');
fetch('https://api.openclaw.com/api/v1/proactive-agent/run', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.OPENCLAW_API_KEY}` }, body: JSON.stringify({monitor: 'memory>90', action: 'alert'})});

确保环境中已设置 $OPENCLAW_API_KEY。对于容器化部署，将配置文件挂载为卷，并将 Agent 作为 sidecar 运行。

错误处理

通过检查 CLI 命令的退出码（例如，非零表示失败）并解析 API 响应中的错误字段（如 "error_code: 403"）来处理错误。常见问题包括配置无效——运行前请使用 openclaw proactive-agent validate --config path/to/config.json 验证 JSON。对于运行时错误，请在配置中启用日志记录："log_level": "debug"，以捕获详细信息，并在脚本中实现重试，例如：

try {
  await fetch('https://api.openclaw.com/api/v1/proactive-agent/run', options);
} catch (error) {
  console.error('Retry in 5s:', error);
  setTimeout(() => { /* retry logic */ }, 5000);
}

通过确认 $OPENCLAW_API_KEY 为最新值，监控身份验证失败情况。

图关系

  • 相关：monitoring-agent（共享监控功能）
  • 依赖：autonomous-ops（用于操作执行框架）
  • 集群：community（依据元数据分组）
  • 标签：proactive、autonomous、monitoring、ai（用于跨技能查询）

评论

支持 Markdown