openclaw fleet

openclaw fleet beheert volledige OpenClaw-instanties die cellen worden genoemd. Elke cel heeft een eigen Gateway, status, inloggegevens, kanaalaccounts, container en hostpoort die alleen via loopback bereikbaar is. Gebruik één cel per vertrouwensgrens van een tenant; gebruik niet één gedeelde Gateway als grens tussen vijandige tenants.

Fleet is experimenteel. Namen van opdrachten, vlaggen, uitvoerstructuren en het containerprofiel kunnen zonder afschrijvingsperiode tussen releases veranderen.

Fleet ondersteunt Docker en Podman. De standaardimage is ghcr.io/openclaw/openclaw:latest.

Fleet is getest op Linux- en macOS-hosts. Windows-hosts zijn momenteel niet getest.

Snel aan de slag

openclaw fleet create acmeopenclaw fleet status acmeopenclaw fleet list

fleet create toont het gegenereerde Gateway-token eenmalig samen met de URL van de cel. Sla het token onmiddellijk op en configureer vervolgens de kanaalaccounts van elke tenant in de cel van die tenant.

Tenant-ID's

Tenant-ID's moeten overeenkomen met:

^[a-z0-9](?:[a-z0-9-]{0,38}[a-z0-9])?$

Hiermee zijn 1 tot 40 kleine letters, cijfers en interne koppeltekens toegestaan. Een ID moet met een letter of cijfer beginnen en eindigen. Hoofdletters, underscores, schuine strepen, punten, witruimte en padtraversalreeksen zoals ../acme worden geweigerd.

De ID wordt onderdeel van de containernaam: openclaw-cell-<tenant>.

fleet create

Maak een cel en start deze:

openclaw fleet create acme

Maak een Podman-cel op een vaste poort zonder deze te starten:

openclaw fleet create acme \  --runtime podman \  --port 19125 \  --no-start

Geef tenantspecifieke omgevingsvariabelen door door --env te herhalen:

openclaw fleet create acme \  --env TZ=America/Los_Angeles \  --env OPENCLAW_DISABLE_BONJOUR=1

Omgevingssleutels gebruiken letters, cijfers en underscores en mogen niet met een cijfer beginnen. Waarden moeten uit één regel bestaan, omdat Fleet ze doorgeeft via een beveiligd omgevingsbestand van de runtime. Fleet weigert pogingen om de beheerde variabelen voor containerpaden en Gateway-tokens te overschrijven die onder Opslag- en containerindeling worden vermeld.

Aanmaakopties

Bij automatische toewijzing wordt de eerste ongebruikte registerpoort op of boven 19100 geselecteerd. Fleet weigert dubbele tenant-ID's en expliciete poorten die al aan een andere cel zijn toegewezen.

Imageverwijzingen worden als één argument aan de containerruntime doorgegeven. Lege verwijzingen en waarden die met - beginnen, worden geweigerd, zodat een image niet als een Docker- of Podman-optie kan worden geïnterpreteerd.

Het geselecteerde Docker- of Podman-eindpunt moet lokaal zijn. Fleet weigert externe Docker-contexten, DOCKER_HOST-eindpunten en externe Podman-services voordat een poort wordt gereserveerd of lokale status wordt aangemaakt. Externe celhosts worden niet ondersteund.

Wanneer Fleet een nieuwe cel start, wacht de aanmaakopdracht maximaal ongeveer een minuut totdat de Gateway op /healthz reageert. Als de cel niet gezond wordt, laat Fleet de container en registerrij intact voor fleet status, fleet logs of expliciete verwijdering. --no-start slaat deze gezondheidscontrole over. Het gegenereerde Gateway-token van een ongezonde nieuwe cel gaat niet verloren: het blijft in de containeromgeving (docker|podman inspect) en omdat de cel nog geen verkeer heeft verwerkt, is fleet rm --force gevolgd door een nieuwe aanmaakopdracht altijd een veilig alternatief.

Vastzetten op digest

De aanmaak- en upgradeopdrachten accepteren op digest vastgezette imageverwijzingen, zoals --image ghcr.io/openclaw/openclaw@sha256:<digest>. Fleet geeft de imageverwijzing ongewijzigd door aan Docker of Podman, zodat een beheerder een cel op onveranderlijke imagebytes kan houden in plaats van op een veranderende tag.

Het aanmaakresultaat bevat de tenant-ID, containernaam, hostpoort, het Gateway-token en de lokale URL. Behandel het resultaat ook bij JSON-uitvoer als geheimhoudingsplichtig, omdat het token erin staat.

Schijflimieten

--disk beperkt alleen de beschrijfbare laag van de container. De via bind-mount gekoppelde status- en authenticatiemappen per tenant blijven hostopslag; gebruik projectquota van het hostbestandssysteem wanneer ook voor deze mappen een harde limiet nodig is.

Beleid voor uitgaand verkeer

Behoud voor Docker de bridge-modus en dwing het beleid voor uitgaand verkeer af met firewallregels op de host, zoals de DOCKER-USER-keten.

fleet list

Toon cellen in volgorde van tenant-ID:

openclaw fleet listopenclaw fleet lsopenclaw fleet list --json

De tabel bevat:

Registerrijen blijven zichtbaar wanneer Docker of Podman niet beschikbaar is; alleen de actuele status wordt dan unknown.

fleet status

Inspecteer één cel:

openclaw fleet status acmeopenclaw fleet status acme --json

De status combineert de registerrij van Fleet, actuele containerinspectie en een kort verzoek op basis van beste inspanning aan:

http://127.0.0.1:<host-port>/healthz

Het gezondheidsresultaat is ok, failed of skipped. /healthz bewijst dat de Gateway actief is, niet dat elk geconfigureerd kanaal of elke Plugin volledig gereed is. De controle wordt overgeslagen wanneer er geen bruikbaar lokaal eindpunt beschikbaar is om te controleren.

fleet logs

Stream de containerlogs van een cel rechtstreeks naar de terminal:

openclaw fleet logs acmeopenclaw fleet logs acme --followopenclaw fleet logs acme --tail 200openclaw fleet logs acme --since 10m

Fleet controleert de eigendomlabels van de geregistreerde container voordat logs worden gelezen en weigert daarom een vreemde container die de verwachte celnaam gebruikt. De stream wordt vastgezet op de ID van de geïnspecteerde container, zodat een gelijktijdige vervanging deze niet naar een nieuwere generatie kan omleiden. Druk op Ctrl-C om --follow te beëindigen zonder dat de stopactie van de beheerder als een opdrachtfout wordt behandeld. Loguitvoer wordt door een redactiefilter geleid dat het huidige Gateway-token van de cel vervangt door <redacted> voordat iets de terminal bereikt.

fleet logs heeft geen --json-modus, omdat containerlogs een onbewerkte stdout/stderr-stream zijn. Beperk voor scripts de uitvoer met --tail en gebruik normale shellomleiding of pipelines.

fleet start, fleet stop en fleet restart

Beheer een bestaande cel met de geregistreerde runtime:

openclaw fleet start acmeopenclaw fleet stop acmeopenclaw fleet restart acme

Deze opdrachten werken met de geregistreerde containernaam. Ze mislukken als de tenant onbekend is of als de geregistreerde runtime de bewerking niet kan uitvoeren.

fleet upgrade

Haal de geregistreerde image opnieuw op en vervang de celcontainer:

openclaw fleet upgrade acme

Verplaats de cel naar een andere image:

openclaw fleet upgrade acme --image ghcr.io/openclaw/openclaw:<version>

Upgrade haalt de doelimage op, inspecteert de bestaande container en het netwerk per cel, stopt en verwijdert de container en maakt en start deze vervolgens opnieuw. De vervanging behoudt dezelfde hostpoort, gegevensmappen, hetzelfde bridgenetwerk per cel, runtimeprofiel, resourcelimieten, herstartbeleid, dezelfde door Fleet beheerde omgeving en de waarden die oorspronkelijk met --env zijn opgegeven. Gekoppelde status blijft behouden bij vervanging van de container; de standaardomgeving van de image kan met de doelimage veranderen.

De vervanging wordt pas definitief gemaakt nadat de Gateway op de loopbackpoort van de cel reageert op /healthz, overeenkomstig het statuscontract dat het officiële compose-bestand gebruikt. Een vervanging die wordt afgesloten, in een crashlus terechtkomt of niet binnen ongeveer een minuut gezond wordt, wordt verwijderd en de vorige container wordt hersteld, zodat een defecte image een werkende cel niet buiten werking stelt.

Het Gateway-token wordt bewust niet in het Fleet-register opgeslagen. Voordat de oude container wordt verwijderd, leest Fleet de omgeving ervan en neemt OPENCLAW_GATEWAY_TOKEN over in de vervanging. Verwijder de oude container vóór een upgrade niet handmatig als het token nergens anders onder jouw beheer bestaat.

fleet backup en fleet restore

Maak een back-up van één gestopte cel:

openclaw fleet stop acmeopenclaw fleet backup acme --out ./acme.tgz

Herstel dat archief naar de geregistreerde cel:

openclaw fleet restore acme --from ./acme.tgz

Dit zijn opdrachten met hostoperatorbevoegdheden. Archieven bevatten tenantstatus en authenticatiegeheimen, worden aangemaakt met modus 0600 en moeten als aanmeldgegevens worden opgeslagen. Back-up weigert een actieve cel, zodat de SQLite-status consistent wordt vastgelegd. Herstellen weigert een actieve cel tenzij --force is opgegeven, vervangt alleen de status van die tenant, roteert het Gateway-token en geeft het nieuwe token eenmaal weer. Fleet maakt van één tenant tegelijk een back-up; een back-up van alle tenants is een afzonderlijke operatoractie.

Voor herstel is een bestaande gestopte container nodig, omdat het geïnspecteerde runtimeprofiel daarvan de vervangende limieten, gebruikerstoewijzing, herkomst van de omgeving en image levert. Als de geregistreerde container buiten Fleet om is verwijderd, voer dan eerst fleet rm <tenant> --force uit zonder --purge-data, maak de cel opnieuw aan met de gewenste image en --no-start en probeer het herstel vervolgens opnieuw. Bij de eerste verwijdering blijven beide tenantgegevensmappen intact.

Beide opdrachten accepteren --max-bytes <bytes> om de hoeveelheid gearchiveerde of uitgepakte bestandsgegevens te begrenzen, en beide passen hetzelfde vaste budget van één miljoen archiefpadsegmenten toe, zodat archiefbommen die alleen uit metadata bestaan de inodes van de host niet kunnen uitputten en elke geaccepteerde back-up herstelbaar blijft. Back-up accepteert --out <path> en beide opdrachten ondersteunen --json.

Archieven bevatten uitsluitend gewone bestanden en mappen. Back-up volgt of bewaart nooit symbolische koppelingen, harde koppelingen, sockets of apparaatknooppunten; aantallen overgeslagen items worden in het resultaat vermeld. Herstellen weigert archieven die een ander type item bevatten. Opnieuw aanmaakbare bomen met symbolische koppelingen, zoals node_modules van de werkruimte, moeten na een herstel opnieuw in de cel worden geïnstalleerd.

fleet doctor

Controleer elke cel of één tenant zonder de runtime- of bestandssysteemstatus te wijzigen:

openclaw fleet doctoropenclaw fleet doctor acme --json

Doctor controleert de lokaliteit van de runtime, eigendomslabels, status, beveiliging, resourcelimieten, binding aan de loopbackpoort, aanwezigheid van het token, netwerkeigendom en de uitgaande-verbindingsmodus, en machtigingen voor privémappen met statusgegevens. Waarschuwingen beschrijven gestopte cellen of verschillen in eigendom; elke mislukte bevinding stelt een procesafsluitcode anders dan nul in.

fleet rm

Verwijder een gestopte cel uit de runtime en het register, maar behoud de tenantgegevens:

openclaw fleet rm acme

Voor een actieve container is --force vereist:

openclaw fleet rm acme --force

Verwijder ook de celgegevens permanent:

openclaw fleet rm acme --purge-data --force

Fleet verwijdert de celcontainer voordat het toegewezen bridgenetwerk wordt verwijderd. --purge-data vereist --force. Vóór recursieve verwijdering herleidt Fleet zowel de twee basismappen die eigendom zijn van Fleet als de twee mappen per tenant. Elk doel moet exact het verwachte tenantblad zijn, zich strikt binnen de basismap bevinden en mag geen symbolische koppeling zijn. Deze insluitingscontroles voorkomen dat een beschadigd registerpad of een symbolische koppeling tussen tenants de verwijdering naar een andere locatie omleidt.

Opschonen kan opnieuw worden geprobeerd als een exact verwachte tenantmap al ontbreekt. Hierdoor kan een latere aanroep de opschoning na een gedeeltelijke bestandssysteemfout voltooien zonder de padcontroles te versoepelen voor mappen die nog bestaan.

Opslag- en containerindeling

De celstatus en versleutelingssleutels voor authenticatieprofielen gebruiken afzonderlijke hostpaden per tenant onder de actieve OpenClaw-statusmap:

<state-dir>/fleet/cells/<tenant>/<state-dir>/fleet/auth-profile-secrets/<tenant>/

De eerste map wordt gekoppeld aan /home/node/.openclaw. De tweede wordt gekoppeld aan /home/node/.config/openclaw, overeenkomstig de koppeling van de versleutelingssleutel in de officiële Docker-configuratie. De versleutelingssleutel wordt daardoor niet onder de gewone statuskoppeling beschikbaar gemaakt en wordt niet opgenomen wanneer alleen de celstatusmap wordt geback-upt of gedeeld. Beide mappen blijven behouden bij normale verwijdering en upgrades; fleet rm --purge-data --force verwijdert beide na afzonderlijke insluitingscontroles.

Vóór de eerste start initialiseert Fleet de celconfiguratie met gateway.mode=local, tokenauthenticatie, de LAN-containerbinding en Control UI-oorsprongen voor de toegewezen hostpoort. De tokenwaarde wordt niet naar die configuratie geschreven; deze blijft in de containeromgeving.

Fleet zet de containerpaden van de officiële image vast met deze omgevingswaarden:

De officiële image gebruikt standaard de niet-rootgebruiker node met UID 1000. Fleet houdt de privé-bindmounts van 0700 beschrijfbaar zonder ze voor iedereen toegankelijk te maken. Rootful Docker voert de cel uit met de UID en GID van de niet-rootgebruiker die de opdracht aanroept; rootless Docker gebruikt container-UID 0, die binnen de gebruikersnaamruimte van de daemon wordt toegewezen aan de niet-bevoorrechte hostgebruiker die de opdracht aanroept. Podman gebruikt keep-id met de aanroepende UID en GID. Wanneer Fleet zelf als root wordt uitgevoerd met een rootful runtime, behoudt het de imagegebruiker en wijst het de oorspronkelijke mountbestanden toe aan UID/GID 1000.

Op SELinux-hosts krijgen Docker- en Podman-mounts een privé-herlabeling met :Z. Als je celgegevens herstelt of verplaatst, zorg dan dat de bindmountpaden beschrijfbaar blijven voor de effectieve containergebruiker. Het profiel is geschikt voor rootless gebruik, maar Docker of Podman moet al voor rootless werking op de host zijn geconfigureerd; Fleet zet een rootful daemon niet om in een rootless daemon.

Beveiligingsprofiel

Fleet past het volgende profiel toe op elke cel:

Fleet koppelt nooit /var/run/docker.sock, gebruikt nooit --privileged of hostnetwerken en voegt geen mogelijkheden toe. De bridge per cel is een scheidingsgrens tussen cellen, geen uitgaande firewall: cellen behouden de netwerktoegang die nodig is voor providers en kanalen. Plaats vóór de loopbackpoort een proxy, SSH-tunnel of tailnetconfiguratie die bij je implementatie past. http://127.0.0.1:<port> is alleen rechtstreeks bereikbaar vanaf de Fleet-host.

Dit profiel scheidt tenantcontainers, maar beschermt tenants niet tegen de Fleet-operator, de beheerder van de containerruntime of een gecompromitteerde host. Zie Hosting voor meerdere tenants voor het volledige vertrouwensmodel en sterkere isolatieopties.

Tokenverwerking

Standaard genereert fleet create een cryptografisch willekeurig hexadecimaal Gateway-token van 32 tekens en geeft het eenmaal weer in het aanmaakresultaat. Bewaar het in je goedgekeurde geheimenbeheerder en voorkom dat aanmaakuitvoer in logboeken wordt vastgelegd.

--gateway-token plaatst een aangepast token in de argumenten van het lokale proces, die in de shellgeschiedenis kunnen worden bewaard of zichtbaar kunnen zijn in proceslijsten. Gebruik bij voorkeur het gegenereerde token, tenzij een bestaande workflow voor geheimenbeheer een opgegeven waarde vereist.

Het token en elke waarde die met --env wordt doorgegeven, bevinden zich in de containeromgeving. Fleet schrijft ze naar een kortlevend omgevingsbestand met modus 0600, geeft alleen het pad van dat bestand door aan Docker of Podman en verwijdert het nadat de runtimeopdracht is voltooid. Waarden die expliciet in openclaw fleet create --gateway-token ... of --env KEY=VALUE worden getypt, kunnen nog steeds zichtbaar zijn in de argumenten van het buitenste openclaw-proces en in de shellgeschiedenis.

Omgevingswaarden van containers zijn niet verborgen voor de vertrouwde hostbeheerder: Docker- of Podman-beheerders kunnen ze uitlezen via containerinspectie. De opmerking ‘eenmalig weergegeven’ van Fleet beschrijft de normale CLI-uitvoer, niet de bescherming tegen een hostbeheerder.

Gerelateerd

• Hosting voor meerdere tenants
• Docker
• Podman
• Gateway-beveiliging