mcpField
P
proactive-agent

proactive-agent

github.com/alphaonedevエージェントワークフロー65 回インストール
リポジトリ

proactive-agent について

OpenClaw が設定した条件を監視し、自律的にアクションを実行するためのスキルです。定期またはイベント駆動のチェックに対応し、設定ファイルでルールを定義して、コマンドラインまたは REST API から操作できます。

主な機能

  1. 01設定可能なルールによる条件監視
  2. 02スクリプト実行、通知送信、API 呼び出し
  3. 03定期実行とイベント駆動のトリガー
  4. 04アクション状態とログの記録
  5. 05コマンドラインまたは REST API で操作

活用シーン

  1. 01サーバー指標がしきい値を超えた際の対応
  2. 02プロンプトなしでイベントに応じて実行
  3. 03CI/CD ワークフローでの対応を自動化
  4. 04Webhook によるアラート送信

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/proactive-agentを入力して読み込まれたか確認します。

詳細

proactive-agent

目的

このスキルを使うと、OpenClaw がプロアクティブなエージェントとして動作し、システムの状態を監視して、ユーザーの入力なしで事前に定義されたアクションを自律的に実行できます。リソースの監視や自動応答など、継続的な監視が必要なシナリオを想定しており、AI を活用して手動での介入を減らします。

使用するタイミング

サーバーのメトリクスを監視してしきい値に応じて対応する場合や、プロンプトなしでイベントに応じたワークフローを実行する場合など、自律的な運用が必要なときにこのスキルを使います。本番環境でのエラー防止、IoT 環境でのリアルタイム応答、CI/CD パイプラインでの修正の自動化などに適用できます。

主な機能

  • 設定可能なルール（CPU 使用率 > 80% やファイルサイズ > 1GB など）を使って条件を監視します。
  • ユーザーの操作なしで、スクリプトの実行、通知の送信、API の呼び出しなどのアクションを実行します。
  • 定期的なチェック（5 分ごとなど）やイベント駆動型のトリガーに対応します。
  • Webhook や API を介して外部サービスと連携し、自律的な運用をスムーズに行います。
  • ログ記録と状態追跡により、実行したアクションの監査証跡を保持します。

使用パターン

このスキルを使うには、まず監視対象とアクションを指定する設定ファイルを定義し、次に CLI または API からエージェントを起動します。必ず最初に認証を設定してください。たとえば、継続的な監視のためにエージェントをループで実行したり、条件に応じて起動する大きなスクリプトに組み込んだりできます。本番環境にデプロイする前に、ステージング環境で監視対象をテストしてください。

主なコマンド/API

手早く起動するには OpenClaw CLI を、プログラムから制御するには REST API を使います。コマンドを実行する前に、環境変数 $OPENCLAW_API_KEY を設定して認証を行ってください。

  • CLI コマンド：設定ファイルを指定してエージェントを起動します。

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

    条件を 300 秒ごとに監視します。アクションを実行せずにシミュレーションするには --dry-run を使います。

  • API エンドポイント：HTTP 経由でエージェントを起動するか、状態を照会します。 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 から読み込み、監視対象と実行するアクションを定義します。

  • 停止コマンド：エージェントを正常に停止します。

    openclaw proactive-agent stop --id agent123

    起動コマンドの出力に含まれる --id フラグを使います。

連携に関する注意

このスキルをスクリプトやサービスに組み込んで連携させます。たとえば、設定に "webhook": "https://your-service.com/hook" を追加して Webhook を設定すれば、Prometheus などの監視ツールと連携し、外部システムに通知できます。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 が設定されていることを確認してください。コンテナ環境では、設定ファイルをボリュームとしてマウントし、エージェントをサイドカーとして実行します。

エラー処理

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 対応