stubbi/openclaw-operator

해결하는 문제

OpenClaw Kubernetes Operator는 Kubernetes에서 OpenClaw AI 에이전트의 배포 및 관리를 단순화합니다. 여러 Kubernetes 리소스(예: StatefulSet, Service, NetworkPolicy)를 수동으로 구성하는 대신 단일 선언적 커스텀 리소스를 사용하여 자체 호스팅 AI 에이전트에 대한 프로덕션 등급의 보안, 관찰 가능성, 수명 주기 관리를 보장합니다.

작동 방식

이 Operator는 OpenClawInstance라는 커스텀 리소스 정의(CRD)를 사용하여 에이전트 스택 전체를 관리합니다. 사용자가 인스턴스를 정의하면 Operator는 이를 RBAC, 영구 스토리지, 네트워크 격리를 포함한 9개 이상의 관리 리소스 집합으로 조정합니다. 또한 OpenClawSelfConfig 리소스를 지원하여 에이전트가 Kubernetes API를 통해 자신의 스킬, 구성, 환경 변수를 자율적으로 업데이트할 수 있습니다(허용 목록 정책에 따름).

대상 독자

Kubernetes를 사용하여 자체 인프라에서 OpenClaw AI 에이전트를 실행하려는 개발자 및 플랫폼 엔지니어를 위한 제품입니다. 운영의 엄격함, 보안 강화, 자동화된 수명 주기 관리가 필요한 경우에 적합합니다.

주요 기능

• 선언적 관리: 단일 CRD가 StatefulSet, Service, Ingress를 포함한 전체 스택을 관리합니다.
• 에이전트 자체 구성: 에이전트가 Kubernetes API를 통해 스킬을 자율적으로 설치하고 자체 구성을 패치할 수 있습니다.
• 강화된 보안: 기본 비루트 사용자, 읽기 전용 루트 파일시스템, 기본 거부 NetworkPolicy를 적용합니다.
• 운영 복원력: 백업/복원을 위한 S3 기반 스냅샷, HPA를 통한 자동 확장, OCI 레지스트리 폴링을 통한 자동 업데이트를 포함합니다.
• 확장 가능한 아키텍처: Chromium(브라우저 자동화), Ollama(로컬 LLM), Tailscale(테일넷 액세스)용 사이드카를 지원합니다.
• 디스크 인식 준비 상태: 워크스페이스 볼륨이 가득 차거나 읽기 전용인 경우 포드가 트래픽을 수락하지 못하도록 방지하는 선택적 가드입니다.