Guides

Create A Fleet

Create fleets from the dashboard, CLI, SDK, or API.

Dashboard

Open:

http://localhost:3000/dashboard

Use the create fleet form, choose a world type, and submit. The dashboard calls POST /fleets.

CLI

commonos fleet create --name product-team --provider aws --region eu-west-1
commonos fleet ls
commonos fleet status flt_xxx

SDK

import { CommonOSClient } from "@common-os/sdk";

const client = new CommonOSClient({
  apiKey: "cos_live_xxx",
  apiUrl: "http://localhost:3001",
});

const fleet = await client.fleets.create({
  name: "product-team",
  provider: "aws",
  region: "eu-west-1",
});

API

curl -X POST http://localhost:3001/fleets \
  -H "Authorization: Bearer cos_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"name":"product-team","provider":"aws","region":"eu-west-1"}'

Next Step

Deploy a manager agent first when building multi-agent teams. Workers can then report task completion and messages to a manager.

Security Model

Tenant keys, agent tokens, permission tiers, pod isolation, and practical safety notes.

Deploy Agents

Add native, OpenClaw, or guest agents to a fleet.

On this page

DashboardCLISDKAPINext Step