TL;DR

  • OpenClaw Enterprise(OCE)는 OpenClaw Control Plane(OCC)을 포함하며, 로컬 환경 또는 운영 중인 Kubernetes 클러스터에 설치해 Agent를 배포·관리하는 플랫폼임.
  • 로컬에서 Agent를 배포하려면 Kubernetes 전용 프로필을 선택해야 하며, 프로필을 지정하지 않으면 Agent를 배포할 수 없는 Compose 미리보기 환경이 시작됨.
  • 첫 Agent를 배포하고 모델 요청을 보내려면 기본 모델 또는 선택한 모델에 접근할 수 있는 OpenAI API 키가 필요함.
  • 플랫폼 개발에는 Node.js 24 이상, package.json에 고정된 pnpm 버전, go.mod에 지정된 Go 버전이 필요하며, 로컬 점검과 기여 정책을 따라야 함.
  • OCC는 컨트롤러, 리소스 수명 주기·저장소·작업 큐, 권한 관리, 감사, Go CLI 및 테스트 등의 구성 요소로 나뉘며, 문서 빌드와 라이선스 정보도 제공함.

OpenClaw Enterprise

  • OpenClaw Enterprise(OCE)는 Agent 배포와 관리를 위한 OpenClaw Control Plane(OCC)을 포함함.
  • 플랫폼 사용은 시작하기, 운영·관리, 소스 코드 기여의 흐름으로 안내됨.

시작하기

  • OCC를 실행할 위치에 따라 로컬 설정 또는 이미 운영 중인 클러스터에 설치하는 Kubernetes 설정을 선택함.
  • 로컬 설정에서는 저장소 루트에서 CLI를 빌드하고, 컴퓨트 드라이버와 컨트롤 플레인을 Kubernetes로 지정하며, 샌드박스 드라이버를 사용하지 않도록 설정한 뒤 ./bin/occ dev up을 실행함.
  • 이 설정은 Agent 배포를 위한 Kubernetes 전용 프로필을 선택함. 프로필 선택이 없으면 occ dev up은 Agent를 배포할 수 없는 Compose 컨트롤 플레인 미리보기를 시작함.
  • 필요한 도구는 Docker Engine 또는 Podman, k3d, kubectl, Helm, Bash, Python 3, go.mod에 지정된 Go 버전, Node.js 24 이상, package.json에 지정된 pnpm 버전임.
  • 빠른 시작 안내에는 설치 확인, 로컬 API 자격 증명, 정리 절차가 포함됨.
  • 로컬 설정 후 첫 Agent를 배포하고 모델 요청을 전송함. 이 단계에는 기본 모델 또는 선택한 모델에 접근할 수 있는 OpenAI API 키가 필요함.
  • 기존 클러스터에 설치한 경우에는 해당 설치 환경에 Agent를 배포하고 작동을 확인함.
  • Agent Presets로 설정을 재사용한 뒤 변수를 채우고 콘솔에서 복사된 초안을 검토함.

개발

  • 첫 플랫폼 변경 안내에 따라 개발 환경을 설정하고, 작은 소스 코드를 수정한 뒤 집중 검증을 수행함.
  • 필요한 도구는 Node.js 24 이상, package.json에 고정된 pnpm 버전, go.mod에서 지정한 Go 버전임.
  • 로컬 점검 안내에는 현재 포맷팅, 린트, 타입, CLI, API 명령이 설명되어 있으며, PR을 열기 전에 기여 정책을 따름.
  • 테스트 안내에는 추가 PostgreSQL, Docker 또는 Podman, Kubernetes 설정이 설명되어 있음. CI 범위 안내는 PR에서 안전하게 실행할 점검과 보호된 통합 테스트를 구분함.

코드 구성

  • apps/controller/: HTTP API, 브라우저 콘솔, 워커, 드라이버(Drivers).
  • packages/contracts/: 리소스 모델, 드라이버 인터페이스, API 스키마.
  • packages/occ/: 리소스 수명 주기, 영속성, 작업 큐.
  • packages/iam/: ID, 역할, 리소스 권한 부여.
  • packages/audit/: 감사 이벤트, 민감 값 정화.
  • cmd/occ/: OCC 도메인 CLI의 Go 진입점.
  • internal/occcli/: OCC 리소스 명령과 사람이 읽을 수 있거나 구조화된 출력.
  • internal/occclient/: OCC 전송과 인증을 담당하는 내부 Go 클라이언트.
  • packages/utils/: 공용 검증, 해싱, 객체 헬퍼.
  • tests/: 적합성 테스트와 통합 테스트.

문서

  • npm run docs:install을 한 번 실행한 뒤 npm run docs:dev로 문서를 미리 볼 수 있으며, 미리보기 주소는 http://127.0.0.1:4173임.
  • 전체 정적 빌드에는 npm run docs:build을 사용함. 로컬 미리보기 안내에는 설정과 점검 절차가 포함됨.
  • Getting Started and Concepts: 설정, 첫 Agent, 제품 모델.
  • Topics and Integrations: 기능 동작, 명명된 구현.
  • Operate and Reference: 플랫폼 운영, CLI, HTTP API.
  • Contribute: 개발, 설계, 문서.

라이선스

  • MIT 라이선스가 적용됨. 타사 구성 요소는 각자의 라이선스를 유지함.