Multi-tenant hosting
기준일: 2026-07-26
공식 기준: Multi-tenant hosting
Multi-tenant hosting 문서는 OpenClaw 공식 문서(gateway/multi-tenant-hosting)를 한국어로 정리한 가이드입니다. Host multiple tenant trust domains as one isolated OpenClaw Gateway cell per tenant 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.
핵심 요약
Host multiple tenant trust domains as one isolated OpenClaw Gateway cell per tenant
한국어 가이드 범위: gateway/multi-tenant-hosting 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.
문서 구성
공식 문서의 주요 섹션은 다음과 같습니다.
- Multi-tenant hosting
- Why each tenant needs a cell
- 아키텍처
- Trust boundary
- Isolation ladder
- 빠른 시작
- Current scope
- 관련 문서
상세 내용
Multi-tenant hosting
OpenClaw's default security model is one trusted operator boundary per Gateway, not hostile multi-tenant isolation inside one shared Gateway. Hosting users or organizations that do not share a trust boundary therefore means running a separate complete OpenClaw instance for each tenant.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
Why each tenant needs a cell
An authenticated operator inside one Gateway has a trusted control-plane role. Session IDs select routing; they do not authorize one tenant against another. Agent sandboxing can reduce the effect of untrusted content and tool execution, but it does not turn one shared Gateway into a tenant authorization boundary.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
아키텍처
The Fleet CLI is a host-side lifecycle supervisor. It records cells in the OpenClaw state database and asks a local Docker or Podman runtime to create, inspect, start, stop, replace, and remove their containers. Remote runtime endpoints are not supported because Fleet's bind paths and loopback URLs belong to the local host. Fleet does not proxy tenant messages and does not add a shared application-level data path between cells.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
Trust boundary
Multi-tenancy protects tenants from each other. The Fleet operator and the host are trusted by every tenant. Resistance to a compromised host is a non-goal.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
Isolation ladder
Choose the boundary that matches the tenants you host:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
빠른 시작
Create a cell. The command prints a generated Gateway token once, so store it immediately:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw fleet create acme
openclaw fleet status acme
openclaw fleet upgrade acme
openclaw fleet rm acme --force
Current scope
These capabilities need explicit identity, routing, authorization, and failure-domain contracts. Do not approximate them by sharing one Gateway or its credentials across tenants. Fleet is a single-host lifecycle supervisor; multi-machine, identity-governed fleets require a separate control-plane layer.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
주요 항목:
- Shared channel accounts or a shared ingress router
- Slimmed-down per-tenant host processes instead of complete OpenClaw instances
- Remote cell hosts managed by one supervisor
- A tenant self-service portal, billing plane, or delegated administration UI
관련 문서
주요 항목:
openclaw fleet- Gateway security
- Multiple gateways
- Docker
- Podman
실습 체크리스트
- 공식 문서와 로컬 버전을 대조합니다:
https://docs.openclaw.ai/gateway/multi-tenant-hosting - 관련 CLI는
openclaw --help및 하위 명령--help로 옵션을 확인합니다. - 설정 변경 시
openclaw config/openclaw doctor로 유효성을 검사합니다. - Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.
자주 쓰는 명령·설정 예시
openclaw fleet create acme
openclaw fleet status acme
openclaw fleet upgrade acme
openclaw fleet rm acme --force
openclaw fleet rm acme --purge-data --force
관련 링크
이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.