ヘルスチェックAPI詳解

ヘルスチェックの概要

ヘルスチェックAPIはOpenClaw Gatewayが提供する組み込みエンドポイントで、サービスの実行状態を報告します。ロードバランサー、監視システム、コンテナオーケストレーションプラットフォームがサービスの正常動作を判断するために使用します。

基本ヘルスチェック

curl http://localhost:3000/health

詳細ヘルスチェック

curl http://localhost:3000/health/detailed

Liveness/Readinessチェック

curl http://localhost:3000/health/live   # プロセスが実行中なら200
curl http://localhost:3000/health/ready  # すべての依存関係が準備完了後に200

Kubernetes統合

containers:
  - name: openclaw
    livenessProbe:
      httpGet:
        path: /health/live
        port: 3000
    readinessProbe:
      httpGet:
        path: /health/ready
        port: 3000

Prometheusメトリクス

{
  "gateway": {
    "metrics": {
      "enabled": true,
      "path": "/metrics",
      "format": "prometheus"
    }
  }
}

まとめ

ヘルスチェックAPIはOpenClaw本番運用のコアコンポーネントです。Livenessチェック、Readinessチェック、アラートメカニズムを適切に設定することで、サービス障害の迅速な発見と自動復旧を実現し、AIアシスタントの高可用性を確保します。