用途:让 OpenClaw 作为主动智能体运行,持续监控系统条件,并在满足规则时自动触发动作,无需用户输入,适合需要持续值守的自动化运维场景。
主要能力:用可配置规则监控条件(如 CPU 使用率 > 80%、文件大小 > 1GB);自动执行脚本、发送通知或调用 API;支持周期性检查(如每 5 分钟)或事件驱动触发;可通过 webhook 或 API 与外部服务集成;提供日志与状态跟踪以保留触发动作的审计记录。
使用方式:先定义包含 monitors 与 actions 的 JSON 配置文件,并设置环境变量 $OPENCLAW_API_KEY 完成认证,再通过 CLI 或 REST API 启动。CLI 示例:openclaw proactive-agent start --config path/to/config.json --interval 300,其中 --interval 300 表示每 300 秒检查一次,--dry-run 可仅模拟不执行动作。API 示例:POST /api/v1/proactive-agent/run,请求体为 {"monitor": "cpu>80", "action": "restart"},需带 Authorization: Bearer $OPENCLAW_API_KEY。停止命令:openclaw proactive-agent stop --id agent123。运行前可用 openclaw proactive-agent validate --config path/to/config.json 校验配置。
适用场景:生产环境错误预防、IoT 实时响应、CI/CD 流水线自动修复,以及需要基于事件触发工作流的自动化操作。
限制与注意:需先完成认证;配置须为合法 JSON;建议先在 staging 环境测试监控规则再上生产;错误可通过 CLI 退出码与 API 响应中的 error_code 判断,可在配置中设置 "log_level": "debug" 并实现重试。其余未在资料中说明的细节暂未提供。