stubbi/openclaw-operator

解決する課題

OpenClaw Kubernetes Operatorは、Kubernetes上でのOpenClaw AIエージェントのデプロイと管理を簡素化します。複数のKubernetesリソース（StatefulSetやService、NetworkPolicyなど）を手動で設定する代わりに、単一の宣言的なカスタムリソースを使用して、セルフホストAIエージェントの本番グレードのセキュリティ、可観測性、ライフサイクル管理を実現します。

仕組み

このOperatorは、OpenClawInstanceというカスタムリソース定義（CRD）を使用して、エージェントスタック全体を管理します。ユーザーがインスタンスを定義すると、OperatorはそれをRBAC、永続ストレージ、ネットワーク分離を含む9つ以上の管理リソースのセットに調整（reconcile）します。また、OpenClawSelfConfigリソースもサポートしており、エージェントがKubernetes APIを介して自身のスキル、構成、環境変数を自律的に更新できます（許可リストポリシーに従います）。

対象読者

Kubernetesを使用してOpenClaw AIエージェントを自社インフラ上で運用したいと考えている開発者やプラットフォームエンジニア向けです。運用の厳格さ、セキュリティ強化、自動化されたライフサイクル管理が必要な方に最適です。

主な特長

• 宣言的管理: 単一のCRDで、StatefulSet、Service、Ingressなどスタック全体を管理します。
• エージェントの自己構成: エージェントがKubernetes APIを介してスキルを自律的にインストールし、自身の構成をパッチ適用できます。
• 強化されたセキュリティ: デフォルトで非rootユーザー、読み取り専用のルートファイルシステム、デフォルト拒否のNetworkPolicyを適用します。
• 運用上の回復力: S3バックアップによるスナップショット（バックアップ/リストア）、HPAによる自動スケーリング、OCIレジストリのポーリングによる自動更新を備えています。
• 拡張可能なアーキテクチャ: Chromium（ブラウザ自動化）、Ollama（ローカルLLM）、Tailscale（テイルネットアクセス）用のサイドカーをサポートします。
• ディスク認識型レディネス: ワークスペースボリュームが満杯または読み取り専用の場合に、ポッドがトラフィックを受け入れないようにするオプションのガードです。