Fleet
기준일: 2026-07-26
공식 기준: Fleet
Fleet 문서는 OpenClaw 공식 문서(cli/fleet)를 한국어로 정리한 가이드입니다. CLI reference for provisioning and managing isolated per-tenant OpenClaw cells 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.
핵심 요약
CLI reference for provisioning and managing isolated per-tenant OpenClaw cells
한국어 가이드 범위: cli/fleet 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.
문서 구성
공식 문서의 주요 섹션은 다음과 같습니다.
- 빠른 시작
- Tenant IDs
- fleet create
- Create options
- Pinning by digest
- Disk limits
- Egress policy
- fleet list
- fleet status
- fleet logs
- fleet start, fleet stop, and fleet restart
- fleet upgrade
- fleet backup and fleet restore
- fleet doctor
- fleet rm
- Storage and container layout
- Security profile
- Token handling
- 관련 문서
상세 내용
openclaw fleet
openclaw fleet manages complete OpenClaw instances called cells. Each cell has its own Gateway, state, credentials, channel accounts, container, and loopback-only host port. Use one cell for each tenant trust boundary; do not use one shared Gateway as a hostile multi-tenant boundary.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
빠른 시작
fleet create prints the generated Gateway token once along with the cell URL. Store the token immediately, then configure each tenant's channel accounts inside that tenant's cell.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw fleet create acme
openclaw fleet status acme
openclaw fleet list
Tenant IDs
This allows 1 to 40 lowercase letters, digits, and internal hyphens. An ID must start and end with a letter or digit. Uppercase letters, underscores, slashes, dots, whitespace, and traversal strings such as ../acme are rejected.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
^[a-z0-9](?:[a-z0-9-]{0,38}[a-z0-9])?$
fleet create
Create a Podman cell on a fixed port without starting it:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw fleet create acme
openclaw fleet create acme \
--runtime podman \
--port 19125 \
--no-start
openclaw fleet create acme \
--env TZ=America/Los_Angeles \
--env OPENCLAW_DISABLE_BONJOUR=1
Create options
Automatic allocation selects the first unused registry port at or above 19100. Fleet rejects duplicate tenant IDs and explicit ports already assigned to another cell.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
| Option | Default | Description |
|---|---|---|
--image <ref> |
ghcr.io/openclaw/openclaw:latest |
Container image for the cell. |
--runtime <runtime> |
docker |
Container CLI: docker or podman. |
--port <number> |
Automatically allocated from 19100 |
Loopback host port. An explicitly selected port must not belong to another registered cell. |
--memory <value> |
2g |
Container memory limit in Docker/Podman syntax. |
--cpus <value> |
2 |
Container CPU limit. |
--disk <size> |
None | Cap the container writable layer when the storage backend supports quotas. |
--network <mode> |
bridge |
Outbound network mode: bridge or internal. |
--pids-limit <number> |
512 |
Maximum number of processes in the container. |
--env <KEY=VALUE> |
None | Pass an environment variable to the cell. Repeat for multiple values. |
--gateway-token <value> |
Random 32-character hexadecimal token | Use a supplied Gateway token instead of generating one. See Token handling. |
--no-start |
Cell starts | Create the container without starting it. |
--json |
Human-readable output | Print machine-readable output. |
Pinning by digest
Create and upgrade accept digest-pinned image references such as --image ghcr.io/openclaw/openclaw@sha256:. Fleet passes the image reference through verbatim to Docker or Podman, which lets an operator keep a cell on immutable image bytes instead of a moving tag.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
Disk limits
--disk limits only the container writable layer. The bind-mounted per-tenant state and auth directories remain host storage; use host filesystem project quotas when those directories also need a hard limit.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
| Runtime/storage backend | --disk support |
|---|---|
| Docker overlay2 on XFS | Requires the XFS pquota mount option. |
| Docker btrfs or zfs | Supported by the storage driver. |
| Podman overlay | Requires XFS backing storage. |
| Other backends | Container creation fails with the daemon error and Fleet's backend guidance. |
Egress policy
For Docker, keep the bridge mode and enforce outbound policy with host firewall rules such as the DOCKER-USER chain.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
| Mode | Docker | Podman |
|---|---|---|
bridge |
Supported; outbound egress is unrestricted by default. | Supported; outbound egress is unrestricted by default. |
internal |
Rejected because Docker does not preserve the published loopback Gateway port on an internal network. | Supported; the loopback Gateway remains published while outbound egress is blocked. |
fleet list
Registry rows remain visible when Docker or Podman is unavailable; only live state becomes unknown.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
| Column | Meaning |
|---|---|
tenant |
Tenant ID. |
state |
Live container state from Docker or Podman inspection. unknown means the runtime was unavailable, or a container with the cell's name exists but its Fleet ownership labels do not match the registry record (a collision or tampering signal — inspect it manually before acting). |
port |
Loopback host port mapped to the cell Gateway. |
image |
Recorded container image. |
created |
Cell creation time. |
openclaw fleet list
openclaw fleet ls
openclaw fleet list --json
fleet status
Status combines the fleet registry row, live container inspection, and a short best-effort request to:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw fleet status acme
openclaw fleet status acme --json
http://127.0.0.1:<host-port>/healthz
fleet logs
Stream a cell's container logs directly to the terminal:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw fleet logs acme
openclaw fleet logs acme --follow
openclaw fleet logs acme --tail 200
openclaw fleet logs acme --since 10m
fleet start, fleet stop, and fleet restart
Control an existing cell with its recorded runtime:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw fleet start acme
openclaw fleet stop acme
openclaw fleet restart acme
fleet upgrade
Re-pull the recorded image and replace the cell container:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw fleet upgrade acme
openclaw fleet upgrade acme --image ghcr.io/openclaw/openclaw:<version>
fleet backup and fleet restore
Restore that archive into the registered cell:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw fleet stop acme
openclaw fleet backup acme --out ./acme.tgz
openclaw fleet restore acme --from ./acme.tgz
fleet doctor
Audit every cell or one tenant without changing runtime or filesystem state:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw fleet doctor
openclaw fleet doctor acme --json
fleet rm
Remove a stopped cell from the runtime and registry while keeping tenant data:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw fleet rm acme
openclaw fleet rm acme --force
openclaw fleet rm acme --purge-data --force
Storage and container layout
Cell state and auth-profile encryption keys use separate per-tenant host paths under the active OpenClaw state directory:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
| Variable | Container value |
|---|---|
HOME |
/home/node |
OPENCLAW_HOME |
/home/node |
OPENCLAW_STATE_DIR |
/home/node/.openclaw |
OPENCLAW_CONFIG_PATH |
/home/node/.openclaw/openclaw.json |
OPENCLAW_WORKSPACE_DIR |
/home/node/.openclaw/workspace |
OPENCLAW_GATEWAY_TOKEN |
Generated or supplied cell token |
<state-dir>/fleet/cells/<tenant>/
<state-dir>/fleet/auth-profile-secrets/<tenant>/
Security profile
Fleet applies the following profile to every cell:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
| Control | Applied profile | Why |
|---|---|---|
| Linux capabilities | --cap-drop=ALL |
The Gateway is a Node.js process and needs no added Linux capabilities. |
| Privilege escalation | --security-opt no-new-privileges |
Prevents processes from gaining privileges through setuid or setgid binaries. |
| Init process | --init |
Reaps descendant processes and forwards container lifecycle signals. |
| Process limit | --pids-limit 512 by default |
Bounds fork and process exhaustion. |
| Memory limit | --memory 2g by default |
Bounds cell memory use. |
| CPU limit | --cpus 2 by default |
Bounds cell CPU use. |
| Writable-layer disk | Optional --disk |
Bounds the container layer when the runtime storage backend supports quotas. |
| Restart policy | --restart unless-stopped |
Restarts a failed cell without overriding an intentional stop. |
| Host publishing | 127.0.0.1:<host-port>:18789 only |
Keeps the Gateway off wildcard host interfaces. |
| Cell network | One bridge or Podman internal network per cell | Separates container-IP traffic and optionally blocks Podman outbound egress. |
| Container identity | Host-matched user mapping | Keeps private bind mounts writable without granting world access. |
| Persistent state | Per-cell mounts; no shared state mount | Keeps tenant config, credentials, sessions, and workspaces in that tenant's data tree. |
| Container command | node dist/index.js gateway --bind lan --port 18789 |
Listens on the container network so the loopback-only host port mapping can reach it. |
Token handling
By default, fleet create generates a cryptographically random 32-character hexadecimal Gateway token and prints it once in the create result. Store it in your approved secret manager and avoid capturing create output in logs.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
관련 문서
주요 항목:
- Multi-tenant hosting
- Docker
- Podman
- Gateway security
실습 체크리스트
- 공식 문서와 로컬 버전을 대조합니다:
https://docs.openclaw.ai/cli/fleet - 관련 CLI는
openclaw --help및 하위 명령--help로 옵션을 확인합니다. - 설정 변경 시
openclaw config/openclaw doctor로 유효성을 검사합니다. - Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.
자주 쓰는 명령·설정 예시
openclaw fleet create acme
openclaw fleet status acme
openclaw fleet list
^[a-z0-9](?:[a-z0-9-]{0,38}[a-z0-9])?$
openclaw fleet create acme
openclaw fleet create acme \
--runtime podman \
--port 19125 \
--no-start
openclaw fleet create acme \
--env TZ=America/Los_Angeles \
--env OPENCLAW_DISABLE_BONJOUR=1
openclaw fleet list
openclaw fleet ls
openclaw fleet list --json
관련 링크
- 공식 원문: cli/fleet
- OpenClaw 문서 홈
이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.