← Back to Blog

OpenClaw Fleet Instruction: Multi-Tenant Management for Cloud Hosting

A comprehensive guide to OpenClaw Fleet — from CLI commands to TypeScript API, and how to integrate it with your cloud hosting platform.

Published by GetClawCloud · Fleet Management Guide

1. Is There a Ready-Made Tenant Management UI?

Currently, there is no dedicated Web UI for admin management. Fleet tenant management is done entirely through the CLI, and is marked as an experimental feature:

// src/cli/fleet-cli/register.ts:58-59 .program("fleet") .description("Provision and manage isolated tenant cells (experimental)")

However, each tenant container runs a full OpenClaw Gateway internally, complete with a Control UI (src/gateway/control-ui.ts). Tenants can access it via browser:

Tenant Gateway URL:

http://127.0.0.1:{hostPort}

Note: This is the tenant's own Gateway control panel, not a host-level multi-tenant management interface.

2. Are There APIs for Cloud Hosting Platform Integration?

There is no REST or GraphQL API, but Fleet CLI provides comprehensive JSON output — ideal for cloud hosting platform integration.

Available Fleet CLI Commands

Command	Function	JSON Output
`openclaw fleet create`	Create tenant	✅ `--json`
`openclaw fleet list / ls`	List all tenants	✅ `--json`
`openclaw fleet status`	View tenant status	✅ `--json`
`openclaw fleet start`	Start tenant	❌
`openclaw fleet stop`	Stop tenant	❌
`openclaw fleet restart`	Restart tenant	❌
`openclaw fleet upgrade`	Upgrade tenant image	❌
`openclaw fleet rm`	Remove tenant	❌
`openclaw fleet backup`	Backup tenant data	✅ `--json`
`openclaw fleet restore`	Restore tenant data	✅ `--json`
`openclaw fleet doctor [tenant]`	Diagnose tenant health	✅ `--json`
`openclaw fleet logs`	View tenant logs	❌

Cloud Hosting Integration Example

All commands support --json output for easy script parsing:

# Create a tenant and get JSON result openclaw fleet create mytenant --json # Output: { "tenant": "mytenant", "containerName": "openclaw-cell-mytenant", "port": 19100, "image": "ghcr.io/openclaw/openclaw:latest", "runtime": "docker", "started": true, "token": "abc123...", "tokenNote": "Shown once. Store this Gateway token securely.", "url": "http://127.0.0.1:19100", "nextStep": "Open http://127.0.0.1:19100, then configure per-tenant channel accounts inside the cell." }

# List all tenants openclaw fleet list --json # Output: { "cells": [ { "tenant": "acme", "state": "running", "port": 19100, "image": "...", "created": "..." }, { "tenant": "beta", "state": "stopped", "port": 19101, "image": "...", "created": "..." } ] } # View tenant status openclaw fleet status acme --json

Programmatic Integration via TypeScript API

The core Fleet logic is also exposed as a TypeScript API (src/fleet/service.runtime.ts):

import { createFleetService } from "./src/fleet/service.runtime.js"; const service = createFleetService(); // Create tenant const result = await service.create({ tenant: "mytenant", image: "ghcr.io/openclaw/openclaw:latest", runtime: "docker", port: 19100, memory: "2g", cpus: "2", pidsLimit: 512, network: "bridge", env: ["FEATURE_X=enabled"], gatewayToken: "my-custom-token", start: true, }); // List tenants const cells = await service.list(); // View status const status = await service.status("mytenant"); // Lifecycle management await service.lifecycle("mytenant", "start"); await service.lifecycle("mytenant", "stop"); await service.lifecycle("mytenant", "restart"); // Backup / Restore await service.backup({ tenant: "mytenant", out: "/backups/mytenant.tgz" }); await service.restore({ tenant: "mytenant", from: "/backups/mytenant.tgz", force: true }); // Remove await service.remove({ tenant: "mytenant", purgeData: true, force: false });

3. Recommendations for Cloud Hosting Platforms

If you're building a cloud hosting platform, here are recommended integration approaches:

CLI + JSON Output: Call openclaw fleet commands via child_process.spawn() and parse --json output
Direct API Import: In Node.js environments, directly import createFleetService()
Tenant Gateway URL: After creation, the returned http://127.0.0.1:{port} can be exposed externally via reverse proxy
Backup & Recovery: Use fleet backup/restore for tenant data migration
Health Checks: Use fleet doctor or poll the {port}/healthz endpoint

⚠️ Note: Fleet is currently marked as experimental. The API may change in future versions. Please review release notes before upgrading.

Summary

OpenClaw Fleet provides a powerful foundation for multi-tenant AI deployment. While there's no Web UI yet, the CLI with JSON output and TypeScript API offer robust integration paths for cloud hosting platforms.

Whether you're building a managed OpenClaw service or managing internal tenant isolation, Fleet gives you the primitives to provision, monitor, and manage AI agent environments at scale.

Ready to Deploy Multi-Tenant AI Agents?

GetClawCloud provides hosted OpenClaw infrastructure with full Fleet support.

Get Started with GetClawCloud