Yuan-lab-LLM/ClawManager

A Kubernetes-native control plane for AI agent instance management, with governed AI access, runtime orchestration, and reusable resources across multiple agent runtimes.

ClawManager – AI 에이전트를 위한 Kubernetes 네이티브 제어 플레인

무엇인가요 – ClawManager는 Kubernetes 클러스터 내에서 AI 에이전트 워크스페이스(예: 챗봇, 코드 어시스턴트)를 실행하고, 관리하며, 공동 작업할 수 있는 오픈소스 플랫폼입니다. 단일 웹 콘솔을 통해 런타임 오케스트레이션, 모델 접근 관리, 재사용 가능한 리소스 주입, 팀 기반 협업, 보안 모니터링을 통합 제공합니다.

왜 중요한가요 – AI 에이전트를 대규모로 배포하려면 일반적으로 수많은 수동적인 Kubernetes 설정이 필요합니다: 포드 생성, 스토리지 관리, 모델 API 키 보안, 사용량 추적 등. ClawManager는 이를 모두 "제어 플레인"으로 추상화하여 운영자가 클릭 한 번으로 에이전트를 프로비저닝하고, 정책을 적용하며, AI 트래픽을 감사할 수 있도록 합니다. 최종 사용자는 하위 클러스터에 직접 노출되지 않아도 됩니다.

핵심 기능 (README에 설명됨)

영역	제공되는 기능
런타임 및 인스턴스 관리	OpenClaw, Hermes, OpenCode, 또는 DeepSeek Harness 워크스페이스를 Lite (공유 게이트웨이 풀) 또는 Pro (전용 데스크톱) 모드로 생성 및 관리. CPU/메모리/스토리지 제어, 파일 보기, 쉘/데스크톱 접근, 비밀번호 보호된 공유 링크 생성 가능.
노스바운드 API 및 기업 인증	JWE 인증, 스코프 토큰, mTLS, LDAP/LDAPS 지원, 레이트 제한을 갖춘 별도의 API 게이트웨이. 외부 시스템은 프로그래밍 방식으로 인스턴스 생성, 질의, 재시작, 리셋 가능.
AI 게이트웨이	모델 호출(OpenAI, Anthropic 등)을 위한 중앙 집중식이고 관리되는 진입점. 모델 카탈로그, 상태, 가격, 감사 로그, 인스턴스별 토큰 계산, 리스크 규칙 기반 라우팅 제공.
에이전트 제어 플레인	런타임 에이전트가 안전하게 등록되고, 허트비트를 전송하며, 명령을 수신하고, 콘솔에서 정의된 원하는 상태와 동기화됩니다.
리소스 관리	채널, 스킬 ZIP, 스케줄된 작업, 환경 변수용 재사용 가능한 "리소스", "리소스 팩", "인젝션 기록". Skill Hub는 버전 관리, 소유권, 게시를 지원합니다.
팀 협업	리더 주도 워크스페이스. 단일 OpenClaw Lite "리더"가 사용자 요청을 분해하고, 워커(OpenClaw/Hermes Lite)에게 작업을 할당하며, 실행 칸반을 통해 진행 상황을 추적하고 최종 합성 결과를 게시합니다.
보안 보호 플랫폼	관리자 전용 콘솔. 런타임, 호스트/컨테이너, 컴포넌트 신뢰성, 아웃바운드 관리의 4단계 방어층, 실시간 알림, 킬 스위치, 전체 체인 감사, 정책 구성 표시.

아키텍처 스냅샷

프론트엔드 – React (v19) UI, 사용자 및 관리자용 웹 포털로 제공.
백엔드 – Go 1.21+ 서비스로 제어 플레인 로직, API 게이트웨이, 보안 모듈 처리.
상태 저장소 – 지속적인 플랫폼 데이터를 위한 MySQL.
Kubernetes – 어떤 K8s 배포판(예: k3s 또는 전체 크기 클러스터)에서도 배포 가능. 표준 CSI 스토리지 클래스(예: Longhorn) 사용 가능하며, 싱글노드 또는 멀티노드 환경 모두 지원.
런타임 포드 – 관리되는 워크스페이스는 클러스터 내에 사이드카 컨테이너(Lite) 또는 전용 Deployment(Pro)로 실행됩니다.
보조 서비스 – 스킬 스캐너, 객체 스토리지, Redis Team Bus(팀 메시징용), 및 선택적 LDAP 통합.

일반적인 워크플로우

관리자는 거버넌스 정책(모델 접근, 비용 한도, 보안 규칙)을 정의하고 재사용 가능한 리소스(스킬, 채널 템플릿)를 생성.
사용자는 포털을 열고 런타임(예: OpenClaw Lite)을 선택하여 워크스페이스를 시작.
워크스페이스 포드가 에이전트 제어 플레인에 등록되고 원하는 구성 정보를 수신.
워크스페이스에서 발생하는 모든 AI 호출은 AI 게이트웨이를 통해 흐르며, 로깅, 비용 추적, 리스크 규칙 기반으로 선택적 라우팅이 수행됨.
공동 작업 작업의 경우, 사용자가 팀을 생성. 리더가 요청을 분해하고 워커에 작업을 할당하며 결과를 집계.
관리자는 보안 알림을 모니터링하고, 의심스러운 활동을 중단하기 위해 서킷 브레이커를 트리거할 수 있음.

시작하기 (README에서)

Kubernetes 배포판 선택 – k3s (싱글노드 또는 클러스터) 또는 표준 k8s 클러스터.
deployments/ 폴더에서 적절한 clawmanager.yaml 매니페스트 적용 (예: 싱글노드용 HostPath, 클러스터용 CSI/RWX).
첫 로그인 흐름은 User Guide (docs/use_guide_en.md) 참조.
외부 프로그래밍 제어가 필요할 경우, Northbound API 애드온 (deployments/k8s/northbound/)을 선택적으로 배포.
필요 시 관리자 콘솔에서 LDAP 또는 기타 인증 방법 구성.

누구에게 추천할까

플랫폼/DevOps 팀 – 각 사용자나 고객에게 수많은 AI 에이전트 인스턴스를 제공해야 하지만, 매번 Kubernetes 오브젝트를 수작업으로 만들고 싶지 않은 경우.
프로덕트 팀 – 모델 사용의 거버넌스, 비용 가시성, 감사 추적을 필요로 하는 AI 증강 애플리케이션을 개발하는 경우.
보안 중심 조직 – 런타임 하드닝, 정책 강제, AI 워크로드용 인시던트 대응 도구를 내장하고 싶은 경우.
연구 랩 – 여러 에이전트가 하나의 문제에 공동 작업할 수 있는 공유 "팀" 워크스페이스를 원하는 경우.

커뮤니티 및 지원

Discord 및 WeChat 그룹 (README에 QR 코드 포함)에서 실시간 토론 가능.
GitHub의 오픈 이슈 트래커로 버그 및 기능 요청 제출.
MIT 라이선스 – 무료로 사용, 수정, 상용화 가능.

결론 – ClawManager는 AI 에이전트를 일관성 있고, 거버넌스 가능한 워크로드로 다룰 수 있게 해주는 풀스택의 Kubernetes 네이티브 플랫폼입니다. 프로비저닝부터 보안, 비용 회계까지 단일 웹 기반 제어 플레인에서 모든 것을 처리합니다.