openclaw-enterprise README

The project's README from github.com/openclaw/openclaw-enterprise. As one markdown file: README.md.

OpenClaw Enterprise

OpenClaw Enterprise (OCE) is the open source, vendor neutral platform for managing agents. Think of it as Kubernetes for agents.

OpenClaw in a mech suit, the OpenClaw Enterprise mascot

OCE includes the OpenClaw Control Plane (OCC) for deploying and managing Agents. Start with Getting Started to use the platform, Operate to administer it, or Contribute to change its source.

Getting started

Choose Local Setup to run OCC on your machine, or Kubernetes Setup to install it on a cluster you already operate. For local setup, run from the repository root:

pnpm cli:build
export OCC_DEVELOPMENT_COMPUTE_DRIVER=kubernetes
export OCC_DEVELOPMENT_CONTROL_PLANE=kubernetes
export OCC_DEVELOPMENT_SANDBOX_DRIVER=none
./bin/occ dev up

This selects the Kubernetes-only profile for Agent deployment. With no profile selection, occ dev up starts a Compose control-plane preview that cannot deploy Agents.

You need Docker Engine or Podman, k3d, kubectl, Helm, Bash, Python 3, Go (the version in go.mod), Node.js 24 or newer, and the pnpm version in package.json. The quickstart covers installation checks, the local API credentials, and cleanup.

After local setup, deploy your first Agent and send it a model request. You need an OpenAI API key with access to the default model or your selected override for that step. If you installed on an existing cluster, deploy and verify an Agent on that installation.

Reuse settings with Agent Presets, then fill variables and review the copied draft in the console.

Develop

Follow Make your first platform change for setup, a small source edit, and focused verification. You need Node.js 24 or newer, the pnpm version pinned in package.json, and the Go version selected by go.mod.

Use the local checks for the current formatting, lint, type, CLI, and API commands; follow the contribution policy before opening a PR. Testing explains additional PostgreSQL, Docker/Podman, and Kubernetes setup; CI coverage distinguishes PR-safe checks from protected integrations.

Code layout

Path Responsibility
apps/controller/ HTTP API, browser console, worker, and Drivers.
packages/contracts/ Resource models, Driver interfaces, and API schemas.
packages/occ/ Resource lifecycle, persistence, and work queue.
packages/iam/ Identities, roles, and resource authorization.
packages/audit/ Audit events and sensitive-value sanitization.
cmd/occ/ Go entry point for the OCC domain CLI.
internal/occcli/ OCC resource commands and human or structured output.
internal/occclient/ Internal Go client that owns OCC transport and authentication.
packages/utils/ Shared validation, hashing, and object helpers.
tests/ Conformance and integration tests.

Documentation

Run npm run docs:install once, then npm run docs:dev to preview the docs at http://127.0.0.1:4173. Use npm run docs:build for the full static build. See the local preview instructions for setup and checks.

Contributors

Thanks to everyone contributing code, documentation, reviews, and ideas. See the full contributor graph and how to update recognition.

derekwaynecarr drew ericcaiwx-star freeqaz freeqaz-openai jacobtomlinson kevinlin-openai kevinslin Kimiyu-186 mrunalp natedemoss rclarke0 RomneyDa russellb sallyom sjenning steipete stevenlee-oai vincentkoc

License

MIT. Third-party components retain their own licenses.

openclaw-enterprise (openclaw/openclaw-enterprise)

Searching Database…

419 ·GitHub
Openclaw-enterprise
Что это?OpenClaw Enterprise (OCE) — открытая, независимая от вендоров управляющая плоскость для развёртывания и управления ИИ-агентами, которую авторы описывают как «Kubernetes для агентов».
OCC — это CLI-инструмент, веб-консоль или и то и другое?И то и другое: CLI на Go (occ) для управления ресурсами плюс HTTP API и браузерная консоль, которые раздаёт компонент контроллера.
Как запустить OCC?Выполните occ dev up из корня репозитория для локальной настройки, используя профиль Kubernetes-only, чтобы реально разворачивать агентов, или следуйте руководству Kubernetes Setup, чтобы установить OCC на существующий кластер.
Что должно быть установлено перед запуском?Нужны Docker Engine или Podman, k3d, kubectl, Helm, Bash, Python 3, версия Go, зафиксированная в go.mod, Node.js 24 или новее и версия pnpm из package.json.
Что будет, если запустить occ dev up без выбора профиля?Без выбора профиля Kubernetes-only команда occ dev up откатится к превью управляющей плоскости на Docker Compose, которое не может реально разворачивать агентов.
Чем именно занимается пакет IAM?packages/iam отвечает за идентичности, роли и авторизацию доступа к ресурсам платформы, а packages/audit записывает события аудита и обезличивает чувствительные значения в логах.
Как организована кодовая база?Это монорепозиторий, разделённый на apps/controller (API, консоль, worker, драйверы), packages/ для общих контрактов, жизненного цикла ресурсов, логики IAM и аудита, cmd/occ как точку входа Go CLI и tests/ для тестов соответствия и интеграционных тестов.
Можно ли попробовать это, не имея своего кластера Kubernetes?Можно запустить occ dev up локально, но без профиля Kubernetes-only он лишь стартует превью управляющей плоскости на Compose, которое не может разворачивать настоящих агентов.
Что нужно для первого изменения кода?Нужны Node.js 24+, версия pnpm из package.json и версия Go, выбранная go.mod; затем перед открытием PR прогоните локальные проверки форматирования, линта, типов, CLI и API.
What are similar projects?ruflo, turnstone, evenfire, casdoor, trueforge, vcluster, zitadel, infisical
Which topics is it in?iam, authorization, k8s, audit-log, pnpm, rbac, infrastructure, cloud-native, enterprise, monorepo, ci, orchestration
Creator
openclaw
Size
96.9 MB
Stars
419
Updated
CommitOct 20
Age
1mo
Commits · 90 Days