openclaw-admin

openclaw-admin

目的

このスキルは OpenClaw ゲートウェイの管理を担い、ゲートウェイの起動、停止、再起動、更新、設定パッチの適用、コンパクション設定の調整、core-openclaw クラスター内のエージェント管理などのタスクを実行できます。

使用するタイミング

デプロイ時（例：更新の適用）、トラブルシューティング時（例：エラー発生後の再起動）、設定の調整時（例：パフォーマンス向上のためのコンパクション調整）など、ゲートウェイのメンテナンスに使用してください。core-openclaw クラスターが稼働している本番環境や、分散環境でのエージェントのライフサイクル管理に適用してください。

主な機能

• ゲートウェイのライフサイクル：openclaw gateway start --cluster core-openclaw --force などの CLI コマンドを使用して、起動、停止、再起動、または更新します。
• 設定パッチ：JSON Patch ドキュメントを適用します。例：{"op": "replace", "path": "/settings/compaction", "value": {"interval": 60}}。
• コンパクションの調整：openclaw compaction tune --threshold 80 --interval 300 などのフラグで設定を調整し、メモリのしきい値と間隔を指定します。
• エージェント管理：openclaw agent add --name agent1 --cluster core-openclaw などのコマンドで、エージェントの追加、削除、一覧表示を行います。
• 認証：すべての操作で $OPENCLAW_API_KEY 環境変数が必要です。

使用パターン

コマンドを実行する前に、必ず $OPENCLAW_API_KEY を設定してください。例：export OPENCLAW_API_KEY=your_api_key。CLI では、コマンドの先頭に openclaw を付け、--cluster core-openclaw フラグを指定してください。API エンドポイントには、Authorization: Bearer $OPENCLAW_API_KEY ヘッダーを含めた HTTP リクエストを使用してください。スクリプトでは、設定にパッチを適用する前にクラスターの存在を確認するなど、呼び出しをエラーチェックで囲んでください。自動化では、bash スクリプトから CLI を呼び出し、cron ジョブや CI/CD パイプラインなどのツールと連携させてください。

一般的なコマンド／API

• ゲートウェイの起動：CLI：openclaw gateway start --cluster core-openclaw --env prod。API：POST /api/gateway/start、リクエスト本文は {"cluster": "core-openclaw", "env": "prod"}。
• ゲートウェイの停止：CLI：openclaw gateway stop --cluster core-openclaw --force。API：POST /api/gateway/stop、リクエスト本文は {"cluster": "core-openclaw"}。
• ゲートウェイの再起動：CLI：openclaw gateway restart --cluster core-openclaw。API：POST /api/gateway/restart、リクエスト本文は {"cluster": "core-openclaw"}。
• ゲートウェイの更新：CLI：openclaw gateway update --cluster core-openclaw --version 2.1.0。API：POST /api/gateway/update、リクエスト本文は {"cluster": "core-openclaw", "version": "2.1.0"}。
• 設定パッチの適用：CLI：openclaw config patch --file config.patch.json --cluster core-openclaw。API：PATCH /api/config、JSON ファイルの内容をリクエスト本文に指定します。例：{"op": "add", "path": "/agents", "value": ["agent1"]}。
• コンパクションの調整：CLI：openclaw compaction tune --cluster core-openclaw --threshold 75 --interval 600。API：PUT /api/compaction、リクエスト本文は {"threshold": 75, "interval": 600}。
• エージェントの管理：CLI：openclaw agent add --name agent2 --cluster core-openclaw。API：POST /api/agents、リクエスト本文は {"name": "agent2", "cluster": "core-openclaw"}。
• API 呼び出しのコードスニペット（ゲートウェイの再起動）：

  export OPENCLAW_API_KEY=your_key
  curl -X POST https://api.openclaw.com/api/gateway/restart \
  -H "Authorization: Bearer $OPENCLAW_API_KEY" \
  -d '{"cluster": "core-openclaw"}'
  

• 設定パッチのコードスニペット：

  {"op": "replace", "path": "/settings/logLevel", "value": "debug"}
  

統合に関する注意事項

「openclaw-admin」ID を使用して AI ワークフローにインポートし、このスキルを統合してください。ナレッジグラフでのベクトルベース検索には、「openclaw gateway restart update config compaction agent」という埋め込みヒントを使用してください。外部システムでは、core-openclaw クラスターのエンドポイント（例：HTTPS 経由）との互換性を確保してください。他のスキルと組み合わせる場合は、このスキルのエージェント ID を監視ツールで使用するなど、出力を入力として渡してください。安全にアクセスできるよう、環境ファイルに $OPENCLAW_API_KEY を設定し、すべてのコマンドに --cluster core-openclaw を追加して、クラスター固有の設定を処理してください。

エラー処理

認証エラー（HTTP 401 など）は、$OPENCLAW_API_KEY が設定され、有効であることを確認してください。スクリプトでは echo $OPENCLAW_API_KEY を使用します。ゲートウェイが見つからない場合（HTTP 404）は、openclaw gateway status --cluster core-openclaw でクラスターのステータスを確認してください。CLI のエラーは標準エラー出力から解析します。たとえば、「Error: Cluster core-openclaw not reachable」はネットワークの問題を示しているため、指数バックオフで再試行してください。設定パッチでは、スクリプト内の try-catch で無効な JSON を処理してください。たとえば、bash では次のようにします：openclaw config patch --file invalid.json || echo "Invalid JSON format"。一般的な API エラー：リクエストの形式が不正な場合は 400（本文の形式を確認）、サーバーに問題がある場合は 500（ログを記録してアラートを送信）。

具体的な使用例

1. 設定変更後にゲートウェイを再起動する：まず、キーをエクスポートします：export OPENCLAW_API_KEY=your_api_key。次に、パッチを適用します：openclaw config patch --file patch.json --cluster core-openclaw。ここで、patch.json には {"op": "replace", "path": "/settings/restartTrigger", "value": true} が含まれます。最後に、再起動します：openclaw gateway restart --cluster core-openclaw。
2. パフォーマンス最適化のためにコンパクションを調整し、エージェントを追加する：まず、次のコマンドで調整します：openclaw compaction tune --cluster core-openclaw --threshold 85 --interval 900。次に、エージェントを追加します：openclaw agent add --name monitoring-agent --cluster core-openclaw。openclaw agent list --cluster core-openclaw でエージェントが有効であることを確認します。

グラフの関係

• 依存先：core-openclaw（すべての操作に使用するクラスター）
• 関連項目：openclaw（メインのエコシステム）、admin（ロールベースのアクセス）、gateway（主要なリソース）、config（設定管理）
• タグ：openclaw、admin、gateway、config（検索とリンク用）