[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75Q1DYNKPMH42XAP2MM8KYZ":3,"skill-same:01M75Q1DYNKPMH42XAP2MM8KYZ":138},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":116,"commitSha":117,"skillDirectory":118,"forksCount":119,"repositoryHtmlUrl":120,"repositoryHomepageUrl":6,"ownerHtmlUrl":121,"ownerBlogUrl":122,"ownerDescription":123,"updatedAt":124,"install":125,"resources":137},"01M75Q1DYNKPMH42XAP2MM8KYZ","fleet",null,"Multi-agent fleet management CLI for OpenClaw. Coordinator agent tool for monitoring, dispatching tasks to, and observing a fleet of agent gateways. Operations are local-only (loopback) plus explicitly declared external endpoints. Operator consent required before install.","javimosch\u002Fopen-claw-skills","javimosch","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F12900508?v=4","01M6D3F2AS6PV75ET9PZ1QGP8J","Javier Leandro Arancibia","01M75B8NCTAJG9WH5YNZH7C3D8",0,"MIT","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Foguzhnatly\u002Ffleet\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: fleet\ntype: installable-cli\ninstall: \"clawhub install fleet\"\nmetadata:\n  openclaw:\n    requires:\n      bins:\n        - bash\n        - python3\n        - curl\n    optionalBins:\n      - gh\n    install:\n      - id: clawhub\n        kind: clawhub\n        slug: fleet\n        label: \"Install fleet via ClawHub\"\ndescription: \"Multi-agent fleet management CLI for OpenClaw. Coordinator agent tool for monitoring, dispatching tasks to, and observing a fleet of agent gateways. Operations are local-only (loopback) plus explicitly declared external endpoints. Operator consent required before install.\"\ntriggers: \"check agents, fleet status, run sitrep, health check, dispatch task, send task to agent, steer agent, watch agent, parallel tasks, kill agent, fleet log, backup config, show agents, fleet report, how many agents online, CI status, what skills installed, trust score, which agent is reliable, fleet trust, fleet score, agent reliability, who should I assign, best agent for task\"\nrequires:\n  binaries:\n    - bash>=4.0\n    - python3>=3.10\n    - curl\n  optionalBinaries:\n    - gh\nenvVars:\n  optional:\n    - name: FLEET_CONFIG\n      description: \"Override path to fleet config (default: ~\u002F.fleet\u002Fconfig.json)\"\n    - name: FLEET_LOG\n      description: \"Override dispatch log path (default: ~\u002F.fleet\u002Flog.jsonl)\"\n    - name: FLEET_STATE_DIR\n      description: \"Override state directory (default: ~\u002F.fleet\u002Fstate)\"\n    - name: FLEET_TRUST_WINDOW_HOURS\n      description: \"Override trust scoring window in hours (default: 72)\"\n    - name: FLEET_NO_UPDATE_CHECK\n      description: \"Set to 1 to disable background GitHub update check entirely\"\n    - name: LINEAR_API_KEY\n      description: \"Linear API key for CI ticket integration (optional, referenced in examples\u002Fsolo-empire\u002Fconfig.json)\"\n    - name: NO_COLOR\n      description: \"Disable colored output\"\ninstallSpec:\n  method: clawhub\n  command: \"clawhub install fleet\"\n  manual: \"git clone https:\u002F\u002Fgithub.com\u002Foguzhnatly\u002Ffleet.git && fleet\u002Fbin\u002Ffleet init\"\n  initRequired: true\n  initWrites:\n    - \"~\u002F.fleet\u002Fconfig.json (chmod 600 immediately on creation, stores agent tokens in plaintext)\"\n    - \"~\u002F.local\u002Fbin\u002Ffleet (symlink to binary)\"\n    - \"~\u002F.bashrc or ~\u002F.zshrc or ~\u002F.profile (PATH export appended only if ~\u002F.local\u002Fbin not already present)\"\n  initReads:\n    - \"~\u002F.openclaw\u002Fopenclaw.json (read-only, one-time workspace path detection)\"\n    - \"127.0.0.1:40000-50000 (loopback port scan, one-time gateway discovery)\"\n  skipInit: \"Clone repo, create ~\u002F.fleet\u002Fconfig.json from templates\u002Fconfigs\u002Fminimal.json, add bin\u002F to PATH manually. No automatic writes.\"\nupdateSpec:\n  command: \"fleet update\"\n  source: \"api.github.com\u002Frepos\u002Foguzhnatly\u002Ffleet\u002Freleases\u002Flatest\"\n  verification: \"SHA256 verified against fleet.sha256 published with each release. Extraction halts on mismatch.\"\n  backgroundCheck: \"Once per 24h, non-blocking. Disable with FLEET_NO_UPDATE_CHECK=1\"\npermissions:\n  reads:\n    - \"~\u002F.fleet\u002F (config, state, logs, backups created by fleet itself)\"\n    - \"~\u002F.openclaw\u002Fopenclaw.json (read-only, fleet init only, workspace path detection)\"\n    - \"~\u002F.openclaw*\u002Fagents\u002F*\u002Fsessions\u002F\u003Cfleet-session-id>.jsonl (fleet watch: only fleet-named sessions)\"\n    - \"\u002Fproc\u002Fmeminfo (Linux only, fleet sitrep)\"\n  writes:\n    - \"~\u002F.fleet\u002F (all fleet-created data)\"\n    - \"~\u002F.local\u002Fbin\u002Ffleet (symlink, fleet init)\"\n    - \"~\u002F.bashrc or ~\u002F.zshrc or ~\u002F.profile (PATH export, fleet init, only if not already present)\"\n  network:\n    - \"127.0.0.1:\u003Cagent-ports> (loopback only, operator config)\"\n    - \"api.github.com\u002Frepos\u002F\u003Coperator-repos>\u002Factions\u002Fruns (fleet ci, operator gh CLI auth)\"\n    - \"api.github.com\u002Frepos\u002Foguzhnatly\u002Ffleet\u002Freleases\u002Flatest (background update check, 24h cache)\"\n    - \"Operator-configured endpoint URLs (fleet health only)\"\nsensitive:\n  storedPlaintext:\n    - \"~\u002F.fleet\u002Fconfig.json: agent gateway auth tokens\"\n  hardening: \"chmod 600 applied automatically by fleet init. Documented in SECURITY.md.\"\nagentScope:\n  permitted:\n    - \"Run fleet commands within operator-configured scope\"\n    - \"Run fleet init to create config and link binary\"\n    - \"Run fleet update after operator explicitly requests it\"\n  notPermitted:\n    - \"Implement fleet functionality by other means if fleet commands fail\"\n    - \"Autonomously run system package managers (apt-get, brew, dnf, apk, etc.) to install dependencies\"\n    - \"Run any command requiring root or sudo without explicit operator instruction in the current conversation\"\n    - \"Read session files fleet did not create\"\n    - \"Scan addresses outside operator config\"\n    - \"Modify OpenClaw config files\"\n    - \"Run commands outside fleet management\"\n---\n\n# Fleet: Multi-Agent Fleet Management\n\n## Intent, Authorization, and Trust\n\n**Who this skill is for:** A coordinator AI agent that has been explicitly configured by its operator (a human who set up and runs the OpenClaw fleet). The operator installed this skill intentionally, knowing it enables autonomous fleet management.\n\n**What \"authorized\" means here:** Installing this skill is the operator's explicit consent to all behaviors described below. The skill contacts only the operator's own agent gateways (loopback), the operator's own GitHub repos via their authenticated gh CLI, and api.github.com for fleet's own release updates (documented, non-blocking, once per 24h). It does not escalate privileges beyond the installing user's home directory and does not take any action outside the local fleet the operator already controls.\n\n**Why some behaviors appear aggressive:** This skill is designed for an AI coordinator agent, not an end-user running it manually. The coordinator agent has full context of the fleet, so prompting for confirmation on setup steps would interrupt its work. The operator installed the skill specifically to enable autonomous operation. Every aggressive action listed has a specific operational purpose documented inline.\n\n**What this skill never does (hard limits):**\n- Never installs software that requires root or sudo without explicit operator instruction\n- Never modifies files outside `~\u002F.fleet\u002F`, `~\u002F.local\u002Fbin\u002F`, and the shell rc files (`~\u002F.bashrc`, `~\u002F.zshrc`, `~\u002F.profile`) of the installing user\n- Never contacts external services except: (1) operator-configured agent gateways on loopback, (2) operator-configured endpoint URLs for health checks, (3) operator's GitHub repos via their authenticated gh CLI for CI status, (4) api.github.com\u002Frepos\u002Foguzhnatly\u002Ffleet\u002Freleases\u002Flatest for background update checks (documented, non-blocking, once per 24h, disable by setting FLEET_NO_UPDATE_CHECK=1)\n- Never exfiltrates configuration, tokens, or session data\n- Never modifies OpenClaw configuration without an explicit operator instruction\n- Never runs on systems it was not installed on by an operator\n- Never deletes or overwrites data it did not create itself (fleet config files, state files)\n- Never executes commands unrelated to fleet management or dependency setup\n\n**Trust boundary:** All operations are local. Fleet communicates only with `127.0.0.1` (loopback) to reach the operator's own agent gateways. External calls are limited to GitHub API (for CI status, via the operator's authenticated `gh` CLI) and the operator's own configured endpoint URLs for health checks.\n\n---\n\nCLI toolkit for managing, dispatching to, and observing a fleet of OpenClaw agent gateways. The coordinator agent uses fleet to monitor employees, dispatch tasks, steer running sessions, watch live output, and review dispatch history.\n\n## Security Model\n\nFleet operates within a strictly defined trust boundary. This section documents it explicitly so any security scanner, reviewer, or operator can verify the scope.\n\n### Network scope\nFleet only makes HTTP connections to:\n1. `127.0.0.1` loopback ports: the operator's own agent gateways (configured in `~\u002F.fleet\u002Fconfig.json`)\n2. GitHub API: via the operator's authenticated `gh` CLI session, only for CI status reads on repos the operator explicitly listed\n3. URLs in `endpoints[]`: health checks to URLs the operator explicitly configured\n\nFleet never opens listening ports, never accepts inbound connections, and never initiates connections to any address not in the operator's own config.\n\n### Filesystem scope\nFleet reads and writes only:\n- `~\u002F.fleet\u002F`: fleet config, state, logs, backups (all created by fleet itself)\n- `~\u002F.local\u002Fbin\u002Ffleet`: a symlink to the fleet binary (created by `fleet init`, standard XDG location)\n- Shell rc files (`~\u002F.bashrc`, `~\u002F.zshrc`, `~\u002F.profile`): only to append `export PATH=\"$HOME\u002F.local\u002Fbin:$PATH\"` if not already present\n- Session output for `fleet watch`: reads the specific session file fleet itself created for the named agent under `~\u002F.openclaw*\u002Fagents\u002F*\u002Fsessions\u002F\u003Cfleet-session-id>.jsonl`. This file may contain conversation transcript data from that agent session. Fleet never reads sessions it did not create, other users' sessions, or the coordinator's main session (unless `--all` flag is explicitly passed).\n\nFleet never reads or writes outside the installing user's home directory. Fleet never accesses sessions it did not create. Fleet reads `~\u002F.openclaw\u002Fopenclaw.json` once during `fleet init` to auto-detect the workspace path (read-only, never written). Fleet never modifies OpenClaw config files.\n\n### Credential scope\nFleet reads auth tokens from `~\u002F.fleet\u002Fconfig.json` only. These tokens belong to the operator's own agents and are stored in plaintext in that file. Fleet never transmits them outside loopback. Fleet never reads other credential stores (ssh keys, cloud credentials, browser storage, OS keychain). Recommended hardening: `chmod 600 ~\u002F.fleet\u002Fconfig.json`.\n\n### Privilege scope\nFleet never calls `sudo`. Fleet never requests elevated permissions. All install commands that require system-level package managers (e.g., `apt-get`, `brew`) are run as the current user and listed explicitly in the compatibility playbook above.\n\n---\n\n## Quick Reference\n\n| Situation | Action |\n|-----------|--------|\n| Send a task to an agent | `fleet task coder \"add pagination to \u002Fapi\u002Fspots\"` |\n| Watch what an agent is doing | `fleet watch coder` |\n| Watch what the coordinator is doing | `fleet watch coordinator` |\n| Send a mid-task correction | `fleet steer coder \"also add rate limiting\"` |\n| Stop an agent's current task | `fleet kill coder` |\n| See all recent dispatches and outcomes | `fleet log` |\n| Decompose a task across multiple agents | `fleet parallel \"\u003Ctask>\" --dry-run` (plan first, agents selected by trust) |\n| Check if all agents are alive | `fleet agents` |\n| Something feels wrong, need full picture | `fleet sitrep` |\n| Quick health check | `fleet health` |\n| Check CI across all repos | `fleet ci` |\n| See which agents are most reliable | `fleet trust` |\n| Drill into one agent's reliability | `fleet score coder` |\n| Check reliability for a specific task type | `fleet score coder --type code` |\n| Check CI for specific repo | `fleet ci \u003Cname>` |\n| See what skills are installed | `fleet skills` |\n| Backup everything before a change | `fleet backup` |\n| Restore after something broke | `fleet restore` |\n| First time setup | `fleet init` |\n| User asks \"how's the fleet?\" | `fleet agents`, summarize |\n| User asks \"what changed?\" | `fleet sitrep`, report deltas |\n| Scheduled morning report | `fleet sitrep 12` in cron |\n| Before deploying | `fleet health` + `fleet ci` |\n\n## Auto-Setup\n\n**Purpose:** These steps ensure the fleet binary is usable on first run. They only touch files the installing user already owns. No root access is needed or used.\n\n**What this modifies:** Executable permission on the fleet binary, a symlink in `~\u002F.local\u002Fbin\u002F` (the standard user-local bin directory), and PATH in the user's own shell rc file if `~\u002F.local\u002Fbin` is not already on PATH.\n\n**Why no confirmation prompt by default:** The operator installed this skill specifically to have the coordinator handle setup autonomously. The consent to auto-setup is given at install time.\n\n**Explicit opt-out:** If the operator has NOT explicitly authorized auto-setup (e.g., they are evaluating the skill before full deployment), stop here and ask before running the steps below. The question to ask: \"Fleet needs to symlink its binary to `~\u002F.local\u002Fbin\u002Ffleet` and may add a PATH export to your shell rc file. Is that OK?\"\n\n**Shell rc modification rule:** Only add the PATH export if `~\u002F.local\u002Fbin` is not already on PATH. Check first with `echo $PATH | grep -q \"$HOME\u002F.local\u002Fbin\"`. If it is already there, skip the rc modification entirely.\n\n```bash\n# 1. Make the binary executable: only affects the fleet script itself\nchmod +x \"$(dirname \"$0\")\u002Fbin\u002Ffleet\"\n\n# 2. Symlink into ~\u002F.local\u002Fbin: user-owned directory, standard XDG location\nln -sf \"$(dirname \"$0\")\u002Fbin\u002Ffleet\" \"$HOME\u002F.local\u002Fbin\u002Ffleet\"\n\n# 3. Add to PATH only if not already present\nif ! echo \"$PATH\" | grep -q \"$HOME\u002F.local\u002Fbin\"; then\n    export PATH=\"$HOME\u002F.local\u002Fbin:$PATH\"\n    # Append to shell rc only if not already there\n    for rc in \"$HOME\u002F.bashrc\" \"$HOME\u002F.zshrc\" \"$HOME\u002F.profile\"; do\n        [ -f \"$rc\" ] && grep -q \"local\u002Fbin\" \"$rc\" || echo 'export PATH=\"$HOME\u002F.local\u002Fbin:$PATH\"' >> \"$rc\"\n    done\nfi\n\n# 4. Create initial config if none exists: only writes to ~\u002F.fleet\u002F\nif [ ! -f \"$HOME\u002F.fleet\u002Fconfig.json\" ]; then\n    fleet init\nfi\n\n# 5. Verify\nfleet --version\n```\n\n`fleet init` auto-detects running gateways (by scanning loopback ports the operator's fleet uses), discovers the workspace from the existing OpenClaw config, creates `~\u002F.fleet\u002Fconfig.json`, symlinks the binary, and adds `~\u002F.local\u002Fbin` to PATH in shell rc files only if it is not already present. All changes are scoped to the installing user's home directory.\n\nAfter init, populate `~\u002F.fleet\u002Fconfig.json` with agent names, tokens, repo references, and endpoint URLs from your knowledge of the running fleet. The coordinator agent already knows this information.\n\n### Via ClawHub\n\n```bash\nclawhub install fleet\n```\n\n### Manual\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Foguzhnatly\u002Ffleet.git\nfleet\u002Fbin\u002Ffleet init\n```\n\n## Configuration\n\nFleet reads `~\u002F.fleet\u002Fconfig.json`. Generate one automatically or create manually.\n\n### Auto-Detection Setup\n\n```bash\nfleet init\n```\n\nThis scans for running OpenClaw gateways, detects your workspace, and creates a starter config.\n\n### Manual Configuration\n\nCreate `~\u002F.fleet\u002Fconfig.json`:\n\n```json\n{\n  \"workspace\": \"~\u002Fworkspace\",\n  \"gateway\": {\n    \"port\": 48391,\n    \"name\": \"coordinator\",\n    \"role\": \"coordinator\",\n    \"model\": \"claude-opus-4\"\n  },\n  \"agents\": [\n    {\n      \"name\": \"coder\",\n      \"port\": 48520,\n      \"role\": \"implementation\",\n      \"model\": \"codex\",\n      \"token\": \"your-agent-token\"\n    }\n  ],\n  \"endpoints\": [\n    { \"name\": \"website\", \"url\": \"https:\u002F\u002Fexample.com\" }\n  ],\n  \"repos\": [\n    { \"name\": \"frontend\", \"repo\": \"myorg\u002Ffrontend\" }\n  ]\n}\n```\n\n### Configuration Reference\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `workspace` | string | Yes | Path to main workspace directory |\n| `gateway.port` | number | Yes | Main coordinator gateway port |\n| `gateway.name` | string | No | Display name (default: \"coordinator\") |\n| `gateway.role` | string | No | Role description |\n| `gateway.model` | string | No | Model identifier |\n| `agents[]` | array | No | Employee agent gateways |\n| `agents[].name` | string | Yes | Unique agent identifier |\n| `agents[].port` | number | Yes | Gateway port number |\n| `agents[].role` | string | No | What this agent does |\n| `agents[].model` | string | No | Model used |\n| `agents[].token` | string | No | Auth token for API calls |\n| `endpoints[]` | array | No | URLs to health check |\n| `endpoints[].name` | string | Yes | Display name |\n| `endpoints[].url` | string | Yes | Full URL to check |\n| `endpoints[].expectedStatus` | number | No | Expected HTTP code (default: 200) |\n| `endpoints[].timeout` | number | No | Timeout in seconds (default: 6) |\n| `repos[]` | array | No | GitHub repos for CI monitoring |\n| `repos[].name` | string | Yes | Display name |\n| `repos[].repo` | string | Yes | GitHub owner\u002Frepo format |\n| `services[]` | array | No | Systemd service names to check |\n| `linear.teams[]` | array | No | Linear team keys for ticket counts |\n| `linear.apiKeyEnv` | string | No | Env var name for API key |\n| `skillsDir` | string | No | Path to ClawHub skills directory |\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `FLEET_CONFIG` | Path to config file | `~\u002F.fleet\u002Fconfig.json` |\n| `FLEET_WORKSPACE` | Override workspace path | Config `workspace` value |\n| `FLEET_STATE_DIR` | State persistence directory | `~\u002F.fleet\u002Fstate` |\n| `NO_COLOR` | Disable colored output when set | (unset) |\n\n## Commands: Detailed Reference\n\n### `fleet task \u003Cagent> \"\u003Cprompt>\"`\n\nDispatches a task to a named agent and streams the response live.\n\n**Requires:** Agent token in `~\u002F.fleet\u002Fconfig.json` under `agents[].token`.\n\n**Options:**\n- `--type code|review|research|deploy|qa`: override task type (auto-inferred from prompt if omitted)\n- `--timeout \u003Cminutes>`: response timeout (default: 30)\n- `--no-wait`: fire and forget, return immediately\n\n**Output:**\n```\nFleet Task\n──────────\n  Agent     coder (port 48520)\n  Type      code\n  Task ID   a1b2c3d4\n  Timeout   30m\n\n  add pagination to \u002Fapi\u002Fspots endpoint\n\n  ────────────────────────────────────────\n  [streams response in real time]\n  ────────────────────────────────────────\n  ✅  Task complete  (a1b2c3d4)\n```\n\n**Important:** Task dispatch uses `x-openclaw-session-key: fleet-{agent}` header. All tasks to the same agent share a session, so the agent has context of prior tasks.\n\n### `fleet steer \u003Cagent> \"\u003Cmessage>\"`\n\nSends a mid-session correction to an agent that is currently working on a task. Routes to the same session as `fleet task`, so the agent has full context.\n\n**Output:**\n```\nFleet Steer\n───────────\n  Agent    coder\n  Session  fleet-coder\n\n  ────────────────────────────────────────\n  [agent response to correction]\n  ────────────────────────────────────────\n  ✅  Steered.\n```\n\n### `fleet watch \u003Cagent> [--all]`\n\nLive tail of the agent's active fleet session output. Polls the session file that fleet itself created for that agent, showing new messages as they arrive.\n\n- Default: watches the `fleet-{agent}` session (the one fleet task created)\n- `--all`: watches the agent's full main session\n- `coordinator`: always watches the main coordinator session\n\n**Output:**\n```\nWatching coder\n──────────────\n  Session: agent:main:fleet-coder\n  File: b80eb2e5.jsonl: polling every 3s: Ctrl+C to stop\n\n  Last 2 message(s):\n\n  you             16:37 UTC\n  add pagination to \u002Fapi\u002Fspots\n\n  coder           16:37 UTC\n  Starting with the cursor-based approach...\n```\n\n**Important:** `fleet watch coder` shows nothing if no task has been dispatched yet. Run `fleet task coder \"\u003Cprompt>\"` first to create the fleet session. Use `fleet watch coder --all` to see the agent's full history.\n\n### `fleet kill \u003Cagent> [--force]`\n\nSends a graceful stop signal to the agent's fleet session. The agent acknowledges and archives the session. Marks all pending log entries for that agent as `steered`.\n\n### `fleet parallel \"\u003Ctask>\" [--dry-run]`\n\nDecomposes a high-level task into subtasks by type, assigns each to the right agent, and dispatches all concurrently.\n\n**Always use `--dry-run` first** to review the decomposition plan before executing. Requires confirmation before actual dispatch.\n\n**Output with `--dry-run`:**\n```\nFleet Parallel\n──────────────\n  Task: research competitor pricing and build a pricing page\n\n  Execution plan:\n\n  1. researcher    [research]\n     Research phase: ...\n\n  2. coder         [code]\n     Implementation: ...\n\n  ────────────────────────────────────────\n  2 subtask(s) ready to dispatch in parallel.\n\n  ℹ️  Dry run complete. Remove --dry-run to execute.\n```\n\n### `fleet log [--agent \u003Cname>] [--outcome \u003Cstatus>] [--limit \u003Cn>] [--all]`\n\nShows the dispatch history for all fleet tasks. Filterable by agent, outcome, and count.\n\n**Outcomes:** `success`, `failure`, `timeout`, `steered`, `pending`\n\n**Output:**\n```\nFleet Log  3 entries\n\n  a1b2c3d4  coder        code      success  12m17s\n  2026-03-01 15:10  add pagination to \u002Fapi\u002Fspots...\n```\n\n### `fleet trust [--window \u003Chours>] [--json]`\n\nShows the trust matrix for all configured agents, computed from `~\u002F.fleet\u002Flog.jsonl`.\n\nTrust is a single composite score per agent derived from the formula:\n\n```\ntrust_score = quality_score × speed_multiplier\n```\n\n- **quality_score**: weighted average of per-task outcomes. `success`=1.0, `steered`=0.5, `failure`\u002F`timeout`=0.0. Each steer within a task degrades the score by up to 30%.\n- **speed_multiplier**: 1.0 if avg task duration ≤5min, down to 0.5 for >30min.\n- **Recency**: tasks within the window (default 72h) count 2×. Tasks within 7 days count 1×. Older tasks count 0.5×.\n- **Trend**: compares last 7 days vs prior 7 days. `↑` improved, `↓` degraded, `→` stable, `★` new agent.\n\n**Output:**\n```\nFleet Trust Matrix  | 2026-03-15 14:00 UTC | 72h window\n─────────────────────────────────────────────────────────────────────\n\n  reviewer         ████████████████░░░░   93%  3 tasks    →  review:95%\n  coder            █████████████░░░░░░░   76%  12 tasks   ↑  code:78%  review:70%\n  deployer         █████████░░░░░░░░░░░   55%  5 tasks    ↓  deploy:55%\n```\n\nUse `--json` for structured output (piping, scripting).\n\n**When to use:** Before running `fleet parallel` on a critical task. Before assigning a new task to understand which agent is currently most reliable. After a steer-heavy session to assess whether an agent needs correction.\n\n**Note:** `fleet sitrep` also shows a one-line trust summary. `fleet trust` gives the full matrix.\n\n---\n\n### `fleet score [\u003Cagent>] [--window \u003Chours>] [--type \u003Ctask_type>]`\n\nShows a detailed per-task-type reliability breakdown for one agent (or a summary table for all).\n\n**Output (single agent):**\n```\nfleet score  coder\n────────────────────────────────────────────────────────────\n\n  Overall           ██████████████░░░░░░   76%  ↑ from 68%\n  Tasks: 12  Window: 72h  Avg duration: 11.2m  Speed mult: 0.90\n\n  By task type:\n  code            ████████████████░░░░   79%   9 tasks  9✓\n  review          ████████████░░░░░░░░   68%   2 tasks  1✓  1⤷\n  research        ██████████████░░░░░░   72%   1 task   1✓\n\n  Recent tasks:\n  ✓  aaa00001  code        2h ago    8m12s\n     add pagination to \u002Fapi\u002Fspots\n  ⤷  bbb00002  code        5h ago    18m04s   ⤷1\n     fix auth flow in mobile app\n```\n\n**Cross-validation (v3.5):** For agents with code or deploy successes, `fleet score` cross-checks whether a GitHub CI run completed within 1 hour of each task. Tasks with no corresponding CI activity are flagged as unverified. Requires `gh` CLI and `repos` in config.\n\n**When to use:** When an agent's trust score is unexpectedly low or high: `fleet score` shows exactly which task types are dragging it down. Use `--type code` to see only code-task history.\n\n---\n\n### `fleet health`\n\nChecks the main gateway and all configured endpoints and systemd services.\n\n**When to use:** Quick operational check, before deployments, troubleshooting.\n\n**Output:**\n```\nFleet Health Check\n──────────────────\n  ✅ coordinator (:48391) 12ms\n  \nEndpoints\n  ✅ website (200) 234ms\n  ✅ api (200) 89ms\n  ❌ docs UNREACHABLE\n\nServices\n  ✅ openclaw-gateway\n  ❌ openclaw-gateway-coder (inactive)\n```\n\n**Status codes:**\n- `✅`: healthy (HTTP 200 or expected status)\n- `❌`: unhealthy (wrong status, unreachable, or error)\n- Shows response time in milliseconds\n\n### `fleet agents`\n\nShows all configured agent gateways with live health status, response time, model, and role.\n\n**When to use:** User asks about agents, debugging agent issues, morning check.\n\n**Output:**\n```\nAgent Fleet\n───────────\n  ⬢ coordinator      coordinator      claude-opus-4               :48391 online 13ms\n  \n  ⬢ coder            implementation   codex                       :48520 online 8ms\n  ⬢ reviewer         code-review      codex                       :48540 online 9ms\n  ⬡ deployer         deployment       codex                       :48560 unreachable\n  ⬢ qa               quality-assurance codex                      :48580 online 7ms\n```\n\n**Status indicators:**\n- `⬢` green = online\n- `⬡` red = unreachable or error\n- `⬡` yellow = auth failed (token issue)\n\n### `fleet sitrep [hours]`\n\nThe flagship command. Generates a structured status report with delta tracking.\n\n**When to use:** Morning reports, scheduled crons, \"what changed?\" questions, incident response.\n\n**Arguments:**\n- `hours`: lookback period (default: 4). Only affects display context, deltas are always vs last run.\n\n**What it checks:**\n1. All agent gateways (online\u002Foffline)\n2. CI status for all configured repos\n3. All configured endpoint health\n4. Linear ticket counts per team\n5. VPS resource usage (memory, disk)\n\n**Delta tracking:** State is saved to `~\u002F.fleet\u002Fstate\u002Fsitrep.json`. Each run compares against the previous and only shows what CHANGED.\n\n**Output:**\n```\nSITREP | 2026-02-23 08:00 UTC | vs 2026-02-22 23:00\n────────────────────────────────────────────────────────────\n\nAgents  5\u002F6 online\n  ⬢ coordinator\n  ⬢ coder\n  ⬢ reviewer\n  ⬡ deployer\n  ⬢ qa\n  ⬢ researcher\n\nCI\n  ✅ frontend\n  ❌ backend\n  ✅ mobile\n\nServices\n  ✅ website (200)\n  ✅ api (200)\n\nCHANGED\n  → agent deployer: online → offline\n  → CI backend: green → RED\n  → OZZ tickets: +3\n\nResources  mem 45% | disk 7%\nLinear    OZZ: 12 open | FRI: 8 open\n```\n\n**Cron integration example:**\n```json\n{\n  \"schedule\": { \"kind\": \"cron\", \"expr\": \"0 8,12 * * *\", \"tz\": \"Europe\u002FLondon\" },\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"Run fleet sitrep and post results to the team channel\"\n  }\n}\n```\n\n### `fleet ci [filter]`\n\nShows GitHub CI status for all configured repos, with the last 3 runs per repo.\n\n**When to use:** Before pushing, after deployments, investigating failures.\n\n**Requirements:** `gh` CLI must be installed and authenticated.\n\n**Arguments:**\n- `filter`: optional, filters repos by name (case-insensitive)\n\n**Output:**\n```\nCI Status\n─────────\n\n  frontend (myorg\u002Ffrontend)\n    ✅ Update homepage (main) passed 2026-02-23T08:00\n    ✅ Fix footer (main) passed 2026-02-23T07:30\n    ✅ Add banner (main) passed 2026-02-23T07:00\n\n  backend (myorg\u002Fbackend)\n    ❌ Add endpoint (main) failed 2026-02-23T08:15\n    ✅ Fix auth (main) passed 2026-02-23T07:45\n```\n\n### `fleet skills`\n\nLists all installed ClawHub skills with version, description, and capabilities.\n\n**When to use:** Inventory check, \"what can I do?\", planning.\n\n**Output:**\n```\nInstalled Skills\n────────────────\nfrom ~\u002Fworkspace\u002Fskills\n\n  ● fleet v1.0.0 [scripts]\n    Multi-agent fleet management CLI for OpenClaw\n  ● ontology v0.1.2 [scripts]\n    Typed knowledge graph for structured agent memory\n  ● self-improving-agent v1.0.11 [scripts, hooks]\n    Captures learnings, errors, and corrections\n```\n\n### `fleet backup`\n\nBacks up OpenClaw config, cron jobs, fleet config, and auth profiles.\n\n**When to use:** Before major changes, before updates, periodic safety net.\n\n**Backup location:** `~\u002F.fleet\u002Fbackups\u002F\u003Ctimestamp>\u002F`\n\n### `fleet restore`\n\nRestores from the latest backup.\n\n**When to use:** After a bad config change, after a failed update.\n\n**Note:** Requires gateway restart after restore: `openclaw gateway restart`\n\n### `fleet init`\n\nInteractive setup that auto-detects running gateways and creates initial config.\n\n**When to use:** First time setup, new machine, new fleet.\n\n**Auto-detection:**\n- Scans common gateway ports (48391, then every 20 ports up to 48600)\n- Reads workspace from `~\u002F.openclaw\u002Fopenclaw.json`\n- Discovers running employee gateways\n\n### `fleet update`\n\nSelf-upgrade command. Fetches the latest release from GitHub and installs automatically.\n\n```\nfleet update             Install latest release when a newer one exists\nfleet update --check     Report available update without installing\nfleet update --force     Reinstall even when already on latest\n```\n\n**Version banner:** When a newer release is available, every fleet command prints a one-line\nwarning on stderr before its output:\n\n```\nfleet v3.1.0 is available. Run  fleet update  to upgrade from v3.0.0.\n```\n\nThe GitHub check runs as a detached background process once per 24 hours so there\nis zero latency impact on normal fleet commands. The result is cached at\n`~\u002F.fleet\u002Fstate\u002Fupdate_check.json`.\n\n## Fleet Patterns\n\nFleet supports multiple organizational architectures. Choose based on your needs:\n\n### Solo Empire\nOne coordinator, 2-5 employees. Best for indie hackers and solo founders.\n\n```\n         Coordinator (Opus)\n        \u002F     |      \\\n    Coder  Reviewer  Deployer\n   (Codex)  (Codex)   (Codex)\n```\n\n### Development Team\nTeam leads coordinating specialized developers. Best for complex products.\n\n```\n              Orchestrator (Opus)\n            \u002F        |         \\\n      FE Lead     BE Lead     QA Lead\n     (Sonnet)    (Sonnet)    (Sonnet)\n       \u002F \\          |           |\n    Dev1  Dev2    Dev1       Tester\n```\n\n### Research Lab\nSpecialized agents for knowledge work. Best for content and analysis.\n\n```\n            Director (Opus)\n          \u002F     |      \\       \\\n    Scraper  Analyst  Writer  Fact-Check\n```\n\nSee `examples\u002F` in the repo for ready-to-use config files for each pattern.\n\n## Troubleshooting\n\n### Common Issues\n\n| Problem | Cause | Fix |\n|---------|-------|-----|\n| `fleet: command not found` | Not in PATH | `ln -sf path\u002Fto\u002Ffleet\u002Fbin\u002Ffleet ~\u002F.local\u002Fbin\u002Ffleet` |\n| `No config found` | Missing config file | Run `fleet init` or create `~\u002F.fleet\u002Fconfig.json` |\n| All agents show \"unreachable\" | Agents not running | Start agent gateways first |\n| CI shows \"error\" | `gh` not authenticated | Run `gh auth login` |\n| SITREP shows \"first run\" | No previous state | Normal on first run, deltas appear on second |\n| Agent shows \"auth failed\" | Wrong token in config | Update token in config to match agent's auth |\n\n### Debugging\n\n```bash\n# Check if fleet can find its config\necho $FLEET_CONFIG\ncat ~\u002F.fleet\u002Fconfig.json\n\n# Check if agents are reachable directly\ncurl -s http:\u002F\u002F127.0.0.1:48520\u002Fhealth\n\n# Check state directory\nls -la ~\u002F.fleet\u002Fstate\u002F\n\n# Run with verbose output\nbash -x fleet health\n```\n\n## Architecture\n\nFleet is modular. Each component has a single responsibility:\n\n```\nfleet\u002F\n├── bin\u002Ffleet              # Entry point: command router only\n├── lib\u002F\n│   ├── core\u002F\n│   │   ├── config.sh      # Config loading and JSON parsing\n│   │   ├── output.sh      # Colors, formatting, HTTP helpers\n│   │   └── state.sh       # Delta state persistence\n│   └── commands\u002F           # One file per command\n│       ├── agents.sh\n│       ├── backup.sh\n│       ├── ci.sh\n│       ├── health.sh\n│       ├── init.sh\n│       ├── sitrep.sh\n│       └── skills.sh\n├── templates\u002Fconfigs\u002F      # Config templates (minimal + full)\n├── examples\u002F               # Pattern examples with configs\n├── docs\u002F                   # Extended documentation\n└── tests\u002F                  # Integration tests\n```\n\n**Adding new commands:** Create `lib\u002Fcommands\u002Fyourcommand.sh`, define `cmd_yourcommand()`, add a case in `bin\u002Ffleet`.\n\n## Integration with Other Skills\n\n### With `ontology` skill\nIf the ontology skill is installed, fleet can query the knowledge graph:\n```bash\n# After installing: clawhub install ontology\nfleet ontology          # Summary of all entities\nfleet ontology Project  # List all projects\n```\n\n### With `self-improving-agent` skill\nLog fleet operational learnings to `.learnings\u002F`:\n- Agent downtime patterns → `ERRORS.md`\n- CI failure patterns → `LEARNINGS.md`\n- Configuration improvements → promote to `TOOLS.md`\n\n## Dependency Installation\n\nFleet requires three things: **bash 4+**, **python3 3.10+**, and **curl**. Below is the complete platform-by-platform installation reference. Install the missing dependencies, then run `fleet init`.\n\n**Operator action required:** The commands in this section are for the operator to run manually, not for the agent to run autonomously. The agent must not run system package managers on the operator's behalf. If a dependency is missing, the agent reports it and the operator installs it using the appropriate command below.\n\nWhere root is required (e.g., `apt-get` on some systems), the command is shown explicitly. Prefer user-level installs (`--user`, `pyenv`, `$HOME\u002F.local`) when root is not available.\n\n### Step 1: Check What You Have\n\n```bash\n# Run these first. Know your environment.\nbash --version 2>\u002Fdev\u002Fnull | head -1\npython3 --version 2>\u002Fdev\u002Fnull\ncurl --version 2>\u002Fdev\u002Fnull | head -1\nuname -s  # Linux, Darwin, FreeBSD, etc.\ncat \u002Fetc\u002Fos-release 2>\u002Fdev\u002Fnull | head -3  # Distro info\n```\n\n### Step 2: Install Missing Dependencies\n\n#### bash 4+\n\n| Platform | Command |\n|----------|---------|\n| **macOS** (ships bash 3.2) | `brew install bash`: then fleet auto-detects `\u002Fopt\u002Fhomebrew\u002Fbin\u002Fbash` via `#!\u002Fusr\u002Fbin\u002Fenv bash` |\n| **Ubuntu\u002FDebian** | `sudo apt-get update && sudo apt-get install -y bash` (usually already 5.x) |\n| **Alpine** | `apk add bash` (Alpine uses busybox ash by default) |\n| **RHEL\u002FCentOS\u002FFedora** | `sudo dnf install bash` or `sudo yum install bash` |\n| **Arch** | `sudo pacman -S bash` |\n| **FreeBSD** | `pkg install bash` |\n| **Windows (WSL)** | bash is included in WSL. If using Git Bash, it ships bash 4+. |\n| **Docker (minimal images)** | `RUN apk add --no-cache bash python3 curl` (Alpine) or `RUN apt-get update && apt-get install -y bash python3 curl` (Debian) |\n| **No root access** | Download bash source, compile locally: `.\u002Fconfigure --prefix=$HOME\u002F.local && make && make install`: then `export PATH=\"$HOME\u002F.local\u002Fbin:$PATH\"` |\n| **NixOS** | `nix-env -iA nixpkgs.bash` |\n\n**After installing on macOS:** Verify with `which bash` that it resolves to Homebrew bash (`\u002Fopt\u002Fhomebrew\u002Fbin\u002Fbash` on Apple Silicon, `\u002Fusr\u002Flocal\u002Fbin\u002Fbash` on Intel). The `#!\u002Fusr\u002Fbin\u002Fenv bash` shebang picks up whichever `bash` is first in PATH.\n\n#### python3 3.10+\n\n| Platform | Command |\n|----------|---------|\n| **macOS** | `brew install python@3.12` |\n| **Ubuntu\u002FDebian** | `sudo apt-get install -y python3` |\n| **Alpine** | `apk add python3` |\n| **RHEL\u002FCentOS** | `sudo dnf install python3` |\n| **Arch** | `sudo pacman -S python` |\n| **No root access** | Use `pyenv`: `curl https:\u002F\u002Fpyenv.run \\| bash && pyenv install 3.12 && pyenv global 3.12` |\n\n**Fleet uses python3 only for JSON parsing.** No pip packages needed. No virtual environment needed. Just the interpreter.\n\n#### curl\n\n| Platform | Command |\n|----------|---------|\n| **Almost everywhere** | Pre-installed. Check with `curl --version`. |\n| **Alpine** | `apk add curl` |\n| **Minimal Docker** | `apt-get install -y curl` or `apk add curl` |\n\n#### gh CLI (optional, for `fleet ci`)\n\n| Platform | Command |\n|----------|---------|\n| **macOS** | `brew install gh` |\n| **Ubuntu\u002FDebian** | See [cli.github.com\u002Fpackages](https:\u002F\u002Fcli.github.com\u002Fpackages) |\n| **Any** | `conda install gh --channel conda-forge` |\n\nIf `gh` is not available and cannot be installed, `fleet ci` will show a warning but all other commands work fine. Do not let a missing `gh` block fleet setup.\n\n### Step 3: If You Truly Cannot Get bash 4+\n\nThis should be rare, but if you're on a locked-down system where you cannot install bash 4+:\n\n1. **Try running with bash 3.2 anyway.** Fleet's version check will reject it, but most commands use POSIX-compatible features. Lines 10-22 in `bin\u002Ffleet` are a version compatibility check that exists solely to surface a helpful error message: not a functional gate. Disabling that check does not affect how any command runs. Many commands will still work on bash 3.2. Test each one and report results.\n\n2. **Report compatibility issues.** If fleet cannot run due to a bash version or missing dependency, report the exact error and the output of `bash --version`, `python3 --version`, and `curl --version` to the operator. Ask the operator to install the missing dependency using the platform table in Step 2. Do not attempt to replicate fleet functionality by other means.\n\n**Note:** The only line in `bin\u002Ffleet` appropriate to edit for compatibility is the version check block (lines 10-22). That block exists purely to show a helpful error message. Every other part of the scripts implements the actual command logic and should not be edited.\n\n### Step 4: Environments Without Required Dependencies\n\nFleet requires bash 4+, python3 3.10+, and curl. If these cannot be installed in the current environment, fleet cannot run there. Report the missing dependency to the operator and ask them to provide an environment where the prerequisites are available. Do not attempt to replicate fleet functionality by other means.\n\n## Best Practices\n\n1. **Run `fleet sitrep` in morning crons**: catch overnight issues before they escalate\n2. **Run `fleet backup` before gateway updates**: easy rollback if something breaks\n3. **Use `fleet health` before deployments**: ensure everything is green first\n4. **Check `fleet agents` after config changes**: verify agents came back online\n5. **Filter `fleet ci` by repo**: avoid noise when debugging a specific service\n6. **Keep tokens in config, keys in env vars**: tokens are local, API keys are sensitive\n","# Fleet: Multi-Agent Fleet Management\n\n## Intent, Authorization, and Trust\n\n**Who this skill is for:** A coordinator AI agent that has been explicitly configured by its operator (a human who set up and runs the OpenClaw fleet). The operator installed this skill intentionally, knowing it enables autonomous fleet management.\n\n**What \"authorized\" means here:** Installing this skill is the operator's explicit consent to all behaviors described below. The skill contacts only the operator's own agent gateways (loopback), the operator's own GitHub repos via their authenticated gh CLI, and api.github.com for fleet's own release updates (documented, non-blocking, once per 24h). It does not escalate privileges beyond the installing user's home directory and does not take any action outside the local fleet the operator already controls.\n\n**Why some behaviors appear aggressive:** This skill is designed for an AI coordinator agent, not an end-user running it manually. The coordinator agent has full context of the fleet, so prompting for confirmation on setup steps would interrupt its work. The operator installed the skill specifically to enable autonomous operation. Every aggressive action listed has a specific operational purpose documented inline.\n\n**What this skill never does (hard limits):**\n- Never installs software that requires root or sudo without explicit operator instruction\n- Never modifies files outside `~\u002F.fleet\u002F`, `~\u002F.local\u002Fbin\u002F`, and the shell rc files (`~\u002F.bashrc`, `~\u002F.zshrc`, `~\u002F.profile`) of the installing user\n- Never contacts external services except: (1) operator-configured agent gateways on loopback, (2) operator-configured endpoint URLs for health checks, (3) operator's GitHub repos via their authenticated gh CLI for CI status, (4) api.github.com\u002Frepos\u002Foguzhnatly\u002Ffleet\u002Freleases\u002Flatest for background update checks (documented, non-blocking, once per 24h, disable by setting FLEET_NO_UPDATE_CHECK=1)\n- Never exfiltrates configuration, tokens, or session data\n- Never modifies OpenClaw configuration without an explicit operator instruction\n- Never runs on systems it was not installed on by an operator\n- Never deletes or overwrites data it did not create itself (fleet config files, state files)\n- Never executes commands unrelated to fleet management or dependency setup\n\n**Trust boundary:** All operations are local. Fleet communicates only with `127.0.0.1` (loopback) to reach the operator's own agent gateways. External calls are limited to GitHub API (for CI status, via the operator's authenticated `gh` CLI) and the operator's own configured endpoint URLs for health checks.\n\n---\n\nCLI toolkit for managing, dispatching to, and observing a fleet of OpenClaw agent gateways. The coordinator agent uses fleet to monitor employees, dispatch tasks, steer running sessions, watch live output, and review dispatch history.\n\n## Security Model\n\nFleet operates within a strictly defined trust boundary. This section documents it explicitly so any security scanner, reviewer, or operator can verify the scope.\n\n### Network scope\nFleet only makes HTTP connections to:\n1. `127.0.0.1` loopback ports: the operator's own agent gateways (configured in `~\u002F.fleet\u002Fconfig.json`)\n2. GitHub API: via the operator's authenticated `gh` CLI session, only for CI status reads on repos the operator explicitly listed\n3. URLs in `endpoints[]`: health checks to URLs the operator explicitly configured\n\nFleet never opens listening ports, never accepts inbound connections, and never initiates connections to any address not in the operator's own config.\n\n### Filesystem scope\nFleet reads and writes only:\n- `~\u002F.fleet\u002F`: fleet config, state, logs, backups (all created by fleet itself)\n- `~\u002F.local\u002Fbin\u002Ffleet`: a symlink to the fleet binary (created by `fleet init`, standard XDG location)\n- Shell rc files (`~\u002F.bashrc`, `~\u002F.zshrc`, `~\u002F.profile`): only to append `export PATH=\"$HOME\u002F.local\u002Fbin:$PATH\"` if not already present\n- Session output for `fleet watch`: reads the specific session file fleet itself created for the named agent under `~\u002F.openclaw*\u002Fagents\u002F*\u002Fsessions\u002F\u003Cfleet-session-id>.jsonl`. This file may contain conversation transcript data from that agent session. Fleet never reads sessions it did not create, other users' sessions, or the coordinator's main session (unless `--all` flag is explicitly passed).\n\nFleet never reads or writes outside the installing user's home directory. Fleet never accesses sessions it did not create. Fleet reads `~\u002F.openclaw\u002Fopenclaw.json` once during `fleet init` to auto-detect the workspace path (read-only, never written). Fleet never modifies OpenClaw config files.\n\n### Credential scope\nFleet reads auth tokens from `~\u002F.fleet\u002Fconfig.json` only. These tokens belong to the operator's own agents and are stored in plaintext in that file. Fleet never transmits them outside loopback. Fleet never reads other credential stores (ssh keys, cloud credentials, browser storage, OS keychain). Recommended hardening: `chmod 600 ~\u002F.fleet\u002Fconfig.json`.\n\n### Privilege scope\nFleet never calls `sudo`. Fleet never requests elevated permissions. All install commands that require system-level package managers (e.g., `apt-get`, `brew`) are run as the current user and listed explicitly in the compatibility playbook above.\n\n---\n\n## Quick Reference\n\n| Situation | Action |\n|-----------|--------|\n| Send a task to an agent | `fleet task coder \"add pagination to \u002Fapi\u002Fspots\"` |\n| Watch what an agent is doing | `fleet watch coder` |\n| Watch what the coordinator is doing | `fleet watch coordinator` |\n| Send a mid-task correction | `fleet steer coder \"also add rate limiting\"` |\n| Stop an agent's current task | `fleet kill coder` |\n| See all recent dispatches and outcomes | `fleet log` |\n| Decompose a task across multiple agents | `fleet parallel \"\u003Ctask>\" --dry-run` (plan first, agents selected by trust) |\n| Check if all agents are alive | `fleet agents` |\n| Something feels wrong, need full picture | `fleet sitrep` |\n| Quick health check | `fleet health` |\n| Check CI across all repos | `fleet ci` |\n| See which agents are most reliable | `fleet trust` |\n| Drill into one agent's reliability | `fleet score coder` |\n| Check reliability for a specific task type | `fleet score coder --type code` |\n| Check CI for specific repo | `fleet ci \u003Cname>` |\n| See what skills are installed | `fleet skills` |\n| Backup everything before a change | `fleet backup` |\n| Restore after something broke | `fleet restore` |\n| First time setup | `fleet init` |\n| User asks \"how's the fleet?\" | `fleet agents`, summarize |\n| User asks \"what changed?\" | `fleet sitrep`, report deltas |\n| Scheduled morning report | `fleet sitrep 12` in cron |\n| Before deploying | `fleet health` + `fleet ci` |\n\n## Auto-Setup\n\n**Purpose:** These steps ensure the fleet binary is usable on first run. They only touch files the installing user already owns. No root access is needed or used.\n\n**What this modifies:** Executable permission on the fleet binary, a symlink in `~\u002F.local\u002Fbin\u002F` (the standard user-local bin directory), and PATH in the user's own shell rc file if `~\u002F.local\u002Fbin` is not already on PATH.\n\n**Why no confirmation prompt by default:** The operator installed this skill specifically to have the coordinator handle setup autonomously. The consent to auto-setup is given at install time.\n\n**Explicit opt-out:** If the operator has NOT explicitly authorized auto-setup (e.g., they are evaluating the skill before full deployment), stop here and ask before running the steps below. The question to ask: \"Fleet needs to symlink its binary to `~\u002F.local\u002Fbin\u002Ffleet` and may add a PATH export to your shell rc file. Is that OK?\"\n\n**Shell rc modification rule:** Only add the PATH export if `~\u002F.local\u002Fbin` is not already on PATH. Check first with `echo $PATH | grep -q \"$HOME\u002F.local\u002Fbin\"`. If it is already there, skip the rc modification entirely.\n\n```bash\n# 1. Make the binary executable: only affects the fleet script itself\nchmod +x \"$(dirname \"$0\")\u002Fbin\u002Ffleet\"\n\n# 2. Symlink into ~\u002F.local\u002Fbin: user-owned directory, standard XDG location\nln -sf \"$(dirname \"$0\")\u002Fbin\u002Ffleet\" \"$HOME\u002F.local\u002Fbin\u002Ffleet\"\n\n# 3. Add to PATH only if not already present\nif ! echo \"$PATH\" | grep -q \"$HOME\u002F.local\u002Fbin\"; then\n    export PATH=\"$HOME\u002F.local\u002Fbin:$PATH\"\n    # Append to shell rc only if not already there\n    for rc in \"$HOME\u002F.bashrc\" \"$HOME\u002F.zshrc\" \"$HOME\u002F.profile\"; do\n        [ -f \"$rc\" ] && grep -q \"local\u002Fbin\" \"$rc\" || echo 'export PATH=\"$HOME\u002F.local\u002Fbin:$PATH\"' >> \"$rc\"\n    done\nfi\n\n# 4. Create initial config if none exists: only writes to ~\u002F.fleet\u002F\nif [ ! -f \"$HOME\u002F.fleet\u002Fconfig.json\" ]; then\n    fleet init\nfi\n\n# 5. Verify\nfleet --version\n```\n\n`fleet init` auto-detects running gateways (by scanning loopback ports the operator's fleet uses), discovers the workspace from the existing OpenClaw config, creates `~\u002F.fleet\u002Fconfig.json`, symlinks the binary, and adds `~\u002F.local\u002Fbin` to PATH in shell rc files only if it is not already present. All changes are scoped to the installing user's home directory.\n\nAfter init, populate `~\u002F.fleet\u002Fconfig.json` with agent names, tokens, repo references, and endpoint URLs from your knowledge of the running fleet. The coordinator agent already knows this information.\n\n### Via ClawHub\n\n```bash\nclawhub install fleet\n```\n\n### Manual\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Foguzhnatly\u002Ffleet.git\nfleet\u002Fbin\u002Ffleet init\n```\n\n## Configuration\n\nFleet reads `~\u002F.fleet\u002Fconfig.json`. Generate one automatically or create manually.\n\n### Auto-Detection Setup\n\n```bash\nfleet init\n```\n\nThis scans for running OpenClaw gateways, detects your workspace, and creates a starter config.\n\n### Manual Configuration\n\nCreate `~\u002F.fleet\u002Fconfig.json`:\n\n```json\n{\n  \"workspace\": \"~\u002Fworkspace\",\n  \"gateway\": {\n    \"port\": 48391,\n    \"name\": \"coordinator\",\n    \"role\": \"coordinator\",\n    \"model\": \"claude-opus-4\"\n  },\n  \"agents\": [\n    {\n      \"name\": \"coder\",\n      \"port\": 48520,\n      \"role\": \"implementation\",\n      \"model\": \"codex\",\n      \"token\": \"your-agent-token\"\n    }\n  ],\n  \"endpoints\": [\n    { \"name\": \"website\", \"url\": \"https:\u002F\u002Fexample.com\" }\n  ],\n  \"repos\": [\n    { \"name\": \"frontend\", \"repo\": \"myorg\u002Ffrontend\" }\n  ]\n}\n```\n\n### Configuration Reference\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `workspace` | string | Yes | Path to main workspace directory |\n| `gateway.port` | number | Yes | Main coordinator gateway port |\n| `gateway.name` | string | No | Display name (default: \"coordinator\") |\n| `gateway.role` | string | No | Role description |\n| `gateway.model` | string | No | Model identifier |\n| `agents[]` | array | No | Employee agent gateways |\n| `agents[].name` | string | Yes | Unique agent identifier |\n| `agents[].port` | number | Yes | Gateway port number |\n| `agents[].role` | string | No | What this agent does |\n| `agents[].model` | string | No | Model used |\n| `agents[].token` | string | No | Auth token for API calls |\n| `endpoints[]` | array | No | URLs to health check |\n| `endpoints[].name` | string | Yes | Display name |\n| `endpoints[].url` | string | Yes | Full URL to check |\n| `endpoints[].expectedStatus` | number | No | Expected HTTP code (default: 200) |\n| `endpoints[].timeout` | number | No | Timeout in seconds (default: 6) |\n| `repos[]` | array | No | GitHub repos for CI monitoring |\n| `repos[].name` | string | Yes | Display name |\n| `repos[].repo` | string | Yes | GitHub owner\u002Frepo format |\n| `services[]` | array | No | Systemd service names to check |\n| `linear.teams[]` | array | No | Linear team keys for ticket counts |\n| `linear.apiKeyEnv` | string | No | Env var name for API key |\n| `skillsDir` | string | No | Path to ClawHub skills directory |\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `FLEET_CONFIG` | Path to config file | `~\u002F.fleet\u002Fconfig.json` |\n| `FLEET_WORKSPACE` | Override workspace path | Config `workspace` value |\n| `FLEET_STATE_DIR` | State persistence directory | `~\u002F.fleet\u002Fstate` |\n| `NO_COLOR` | Disable colored output when set | (unset) |\n\n## Commands: Detailed Reference\n\n### `fleet task \u003Cagent> \"\u003Cprompt>\"`\n\nDispatches a task to a named agent and streams the response live.\n\n**Requires:** Agent token in `~\u002F.fleet\u002Fconfig.json` under `agents[].token`.\n\n**Options:**\n- `--type code|review|research|deploy|qa`: override task type (auto-inferred from prompt if omitted)\n- `--timeout \u003Cminutes>`: response timeout (default: 30)\n- `--no-wait`: fire and forget, return immediately\n\n**Output:**\n```\nFleet Task\n──────────\n  Agent     coder (port 48520)\n  Type      code\n  Task ID   a1b2c3d4\n  Timeout   30m\n\n  add pagination to \u002Fapi\u002Fspots endpoint\n\n  ────────────────────────────────────────\n  [streams response in real time]\n  ────────────────────────────────────────\n  ✅  Task complete  (a1b2c3d4)\n```\n\n**Important:** Task dispatch uses `x-openclaw-session-key: fleet-{agent}` header. All tasks to the same agent share a session, so the agent has context of prior tasks.\n\n### `fleet steer \u003Cagent> \"\u003Cmessage>\"`\n\nSends a mid-session correction to an agent that is currently working on a task. Routes to the same session as `fleet task`, so the agent has full context.\n\n**Output:**\n```\nFleet Steer\n───────────\n  Agent    coder\n  Session  fleet-coder\n\n  ────────────────────────────────────────\n  [agent response to correction]\n  ────────────────────────────────────────\n  ✅  Steered.\n```\n\n### `fleet watch \u003Cagent> [--all]`\n\nLive tail of the agent's active fleet session output. Polls the session file that fleet itself created for that agent, showing new messages as they arrive.\n\n- Default: watches the `fleet-{agent}` session (the one fleet task created)\n- `--all`: watches the agent's full main session\n- `coordinator`: always watches the main coordinator session\n\n**Output:**\n```\nWatching coder\n──────────────\n  Session: agent:main:fleet-coder\n  File: b80eb2e5.jsonl: polling every 3s: Ctrl+C to stop\n\n  Last 2 message(s):\n\n  you             16:37 UTC\n  add pagination to \u002Fapi\u002Fspots\n\n  coder           16:37 UTC\n  Starting with the cursor-based approach...\n```\n\n**Important:** `fleet watch coder` shows nothing if no task has been dispatched yet. Run `fleet task coder \"\u003Cprompt>\"` first to create the fleet session. Use `fleet watch coder --all` to see the agent's full history.\n\n### `fleet kill \u003Cagent> [--force]`\n\nSends a graceful stop signal to the agent's fleet session. The agent acknowledges and archives the session. Marks all pending log entries for that agent as `steered`.\n\n### `fleet parallel \"\u003Ctask>\" [--dry-run]`\n\nDecomposes a high-level task into subtasks by type, assigns each to the right agent, and dispatches all concurrently.\n\n**Always use `--dry-run` first** to review the decomposition plan before executing. Requires confirmation before actual dispatch.\n\n**Output with `--dry-run`:**\n```\nFleet Parallel\n──────────────\n  Task: research competitor pricing and build a pricing page\n\n  Execution plan:\n\n  1. researcher    [research]\n     Research phase: ...\n\n  2. coder         [code]\n     Implementation: ...\n\n  ────────────────────────────────────────\n  2 subtask(s) ready to dispatch in parallel.\n\n  ℹ️  Dry run complete. Remove --dry-run to execute.\n```\n\n### `fleet log [--agent \u003Cname>] [--outcome \u003Cstatus>] [--limit \u003Cn>] [--all]`\n\nShows the dispatch history for all fleet tasks. Filterable by agent, outcome, and count.\n\n**Outcomes:** `success`, `failure`, `timeout`, `steered`, `pending`\n\n**Output:**\n```\nFleet Log  3 entries\n\n  a1b2c3d4  coder        code      success  12m17s\n  2026-03-01 15:10  add pagination to \u002Fapi\u002Fspots...\n```\n\n### `fleet trust [--window \u003Chours>] [--json]`\n\nShows the trust matrix for all configured agents, computed from `~\u002F.fleet\u002Flog.jsonl`.\n\nTrust is a single composite score per agent derived from the formula:\n\n```\ntrust_score = quality_score × speed_multiplier\n```\n\n- **quality_score**: weighted average of per-task outcomes. `success`=1.0, `steered`=0.5, `failure`\u002F`timeout`=0.0. Each steer within a task degrades the score by up to 30%.\n- **speed_multiplier**: 1.0 if avg task duration ≤5min, down to 0.5 for >30min.\n- **Recency**: tasks within the window (default 72h) count 2×. Tasks within 7 days count 1×. Older tasks count 0.5×.\n- **Trend**: compares last 7 days vs prior 7 days. `↑` improved, `↓` degraded, `→` stable, `★` new agent.\n\n**Output:**\n```\nFleet Trust Matrix  | 2026-03-15 14:00 UTC | 72h window\n─────────────────────────────────────────────────────────────────────\n\n  reviewer         ████████████████░░░░   93%  3 tasks    →  review:95%\n  coder            █████████████░░░░░░░   76%  12 tasks   ↑  code:78%  review:70%\n  deployer         █████████░░░░░░░░░░░   55%  5 tasks    ↓  deploy:55%\n```\n\nUse `--json` for structured output (piping, scripting).\n\n**When to use:** Before running `fleet parallel` on a critical task. Before assigning a new task to understand which agent is currently most reliable. After a steer-heavy session to assess whether an agent needs correction.\n\n**Note:** `fleet sitrep` also shows a one-line trust summary. `fleet trust` gives the full matrix.\n\n---\n\n### `fleet score [\u003Cagent>] [--window \u003Chours>] [--type \u003Ctask_type>]`\n\nShows a detailed per-task-type reliability breakdown for one agent (or a summary table for all).\n\n**Output (single agent):**\n```\nfleet score  coder\n────────────────────────────────────────────────────────────\n\n  Overall           ██████████████░░░░░░   76%  ↑ from 68%\n  Tasks: 12  Window: 72h  Avg duration: 11.2m  Speed mult: 0.90\n\n  By task type:\n  code            ████████████████░░░░   79%   9 tasks  9✓\n  review          ████████████░░░░░░░░   68%   2 tasks  1✓  1⤷\n  research        ██████████████░░░░░░   72%   1 task   1✓\n\n  Recent tasks:\n  ✓  aaa00001  code        2h ago    8m12s\n     add pagination to \u002Fapi\u002Fspots\n  ⤷  bbb00002  code        5h ago    18m04s   ⤷1\n     fix auth flow in mobile app\n```\n\n**Cross-validation (v3.5):** For agents with code or deploy successes, `fleet score` cross-checks whether a GitHub CI run completed within 1 hour of each task. Tasks with no corresponding CI activity are flagged as unverified. Requires `gh` CLI and `repos` in config.\n\n**When to use:** When an agent's trust score is unexpectedly low or high: `fleet score` shows exactly which task types are dragging it down. Use `--type code` to see only code-task history.\n\n---\n\n### `fleet health`\n\nChecks the main gateway and all configured endpoints and systemd services.\n\n**When to use:** Quick operational check, before deployments, troubleshooting.\n\n**Output:**\n```\nFleet Health Check\n──────────────────\n  ✅ coordinator (:48391) 12ms\n  \nEndpoints\n  ✅ website (200) 234ms\n  ✅ api (200) 89ms\n  ❌ docs UNREACHABLE\n\nServices\n  ✅ openclaw-gateway\n  ❌ openclaw-gateway-coder (inactive)\n```\n\n**Status codes:**\n- `✅`: healthy (HTTP 200 or expected status)\n- `❌`: unhealthy (wrong status, unreachable, or error)\n- Shows response time in milliseconds\n\n### `fleet agents`\n\nShows all configured agent gateways with live health status, response time, model, and role.\n\n**When to use:** User asks about agents, debugging agent issues, morning check.\n\n**Output:**\n```\nAgent Fleet\n───────────\n  ⬢ coordinator      coordinator      claude-opus-4               :48391 online 13ms\n  \n  ⬢ coder            implementation   codex                       :48520 online 8ms\n  ⬢ reviewer         code-review      codex                       :48540 online 9ms\n  ⬡ deployer         deployment       codex                       :48560 unreachable\n  ⬢ qa               quality-assurance codex                      :48580 online 7ms\n```\n\n**Status indicators:**\n- `⬢` green = online\n- `⬡` red = unreachable or error\n- `⬡` yellow = auth failed (token issue)\n\n### `fleet sitrep [hours]`\n\nThe flagship command. Generates a structured status report with delta tracking.\n\n**When to use:** Morning reports, scheduled crons, \"what changed?\" questions, incident response.\n\n**Arguments:**\n- `hours`: lookback period (default: 4). Only affects display context, deltas are always vs last run.\n\n**What it checks:**\n1. All agent gateways (online\u002Foffline)\n2. CI status for all configured repos\n3. All configured endpoint health\n4. Linear ticket counts per team\n5. VPS resource usage (memory, disk)\n\n**Delta tracking:** State is saved to `~\u002F.fleet\u002Fstate\u002Fsitrep.json`. Each run compares against the previous and only shows what CHANGED.\n\n**Output:**\n```\nSITREP | 2026-02-23 08:00 UTC | vs 2026-02-22 23:00\n────────────────────────────────────────────────────────────\n\nAgents  5\u002F6 online\n  ⬢ coordinator\n  ⬢ coder\n  ⬢ reviewer\n  ⬡ deployer\n  ⬢ qa\n  ⬢ researcher\n\nCI\n  ✅ frontend\n  ❌ backend\n  ✅ mobile\n\nServices\n  ✅ website (200)\n  ✅ api (200)\n\nCHANGED\n  → agent deployer: online → offline\n  → CI backend: green → RED\n  → OZZ tickets: +3\n\nResources  mem 45% | disk 7%\nLinear    OZZ: 12 open | FRI: 8 open\n```\n\n**Cron integration example:**\n```json\n{\n  \"schedule\": { \"kind\": \"cron\", \"expr\": \"0 8,12 * * *\", \"tz\": \"Europe\u002FLondon\" },\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"Run fleet sitrep and post results to the team channel\"\n  }\n}\n```\n\n### `fleet ci [filter]`\n\nShows GitHub CI status for all configured repos, with the last 3 runs per repo.\n\n**When to use:** Before pushing, after deployments, investigating failures.\n\n**Requirements:** `gh` CLI must be installed and authenticated.\n\n**Arguments:**\n- `filter`: optional, filters repos by name (case-insensitive)\n\n**Output:**\n```\nCI Status\n─────────\n\n  frontend (myorg\u002Ffrontend)\n    ✅ Update homepage (main) passed 2026-02-23T08:00\n    ✅ Fix footer (main) passed 2026-02-23T07:30\n    ✅ Add banner (main) passed 2026-02-23T07:00\n\n  backend (myorg\u002Fbackend)\n    ❌ Add endpoint (main) failed 2026-02-23T08:15\n    ✅ Fix auth (main) passed 2026-02-23T07:45\n```\n\n### `fleet skills`\n\nLists all installed ClawHub skills with version, description, and capabilities.\n\n**When to use:** Inventory check, \"what can I do?\", planning.\n\n**Output:**\n```\nInstalled Skills\n────────────────\nfrom ~\u002Fworkspace\u002Fskills\n\n  ● fleet v1.0.0 [scripts]\n    Multi-agent fleet management CLI for OpenClaw\n  ● ontology v0.1.2 [scripts]\n    Typed knowledge graph for structured agent memory\n  ● self-improving-agent v1.0.11 [scripts, hooks]\n    Captures learnings, errors, and corrections\n```\n\n### `fleet backup`\n\nBacks up OpenClaw config, cron jobs, fleet config, and auth profiles.\n\n**When to use:** Before major changes, before updates, periodic safety net.\n\n**Backup location:** `~\u002F.fleet\u002Fbackups\u002F\u003Ctimestamp>\u002F`\n\n### `fleet restore`\n\nRestores from the latest backup.\n\n**When to use:** After a bad config change, after a failed update.\n\n**Note:** Requires gateway restart after restore: `openclaw gateway restart`\n\n### `fleet init`\n\nInteractive setup that auto-detects running gateways and creates initial config.\n\n**When to use:** First time setup, new machine, new fleet.\n\n**Auto-detection:**\n- Scans common gateway ports (48391, then every 20 ports up to 48600)\n- Reads workspace from `~\u002F.openclaw\u002Fopenclaw.json`\n- Discovers running employee gateways\n\n### `fleet update`\n\nSelf-upgrade command. Fetches the latest release from GitHub and installs automatically.\n\n```\nfleet update             Install latest release when a newer one exists\nfleet update --check     Report available update without installing\nfleet update --force     Reinstall even when already on latest\n```\n\n**Version banner:** When a newer release is available, every fleet command prints a one-line\nwarning on stderr before its output:\n\n```\nfleet v3.1.0 is available. Run  fleet update  to upgrade from v3.0.0.\n```\n\nThe GitHub check runs as a detached background process once per 24 hours so there\nis zero latency impact on normal fleet commands. The result is cached at\n`~\u002F.fleet\u002Fstate\u002Fupdate_check.json`.\n\n## Fleet Patterns\n\nFleet supports multiple organizational architectures. Choose based on your needs:\n\n### Solo Empire\nOne coordinator, 2-5 employees. Best for indie hackers and solo founders.\n\n```\n         Coordinator (Opus)\n        \u002F     |      \\\n    Coder  Reviewer  Deployer\n   (Codex)  (Codex)   (Codex)\n```\n\n### Development Team\nTeam leads coordinating specialized developers. Best for complex products.\n\n```\n              Orchestrator (Opus)\n            \u002F        |         \\\n      FE Lead     BE Lead     QA Lead\n     (Sonnet)    (Sonnet)    (Sonnet)\n       \u002F \\          |           |\n    Dev1  Dev2    Dev1       Tester\n```\n\n### Research Lab\nSpecialized agents for knowledge work. Best for content and analysis.\n\n```\n            Director (Opus)\n          \u002F     |      \\       \\\n    Scraper  Analyst  Writer  Fact-Check\n```\n\nSee `examples\u002F` in the repo for ready-to-use config files for each pattern.\n\n## Troubleshooting\n\n### Common Issues\n\n| Problem | Cause | Fix |\n|---------|-------|-----|\n| `fleet: command not found` | Not in PATH | `ln -sf path\u002Fto\u002Ffleet\u002Fbin\u002Ffleet ~\u002F.local\u002Fbin\u002Ffleet` |\n| `No config found` | Missing config file | Run `fleet init` or create `~\u002F.fleet\u002Fconfig.json` |\n| All agents show \"unreachable\" | Agents not running | Start agent gateways first |\n| CI shows \"error\" | `gh` not authenticated | Run `gh auth login` |\n| SITREP shows \"first run\" | No previous state | Normal on first run, deltas appear on second |\n| Agent shows \"auth failed\" | Wrong token in config | Update token in config to match agent's auth |\n\n### Debugging\n\n```bash\n# Check if fleet can find its config\necho $FLEET_CONFIG\ncat ~\u002F.fleet\u002Fconfig.json\n\n# Check if agents are reachable directly\ncurl -s http:\u002F\u002F127.0.0.1:48520\u002Fhealth\n\n# Check state directory\nls -la ~\u002F.fleet\u002Fstate\u002F\n\n# Run with verbose output\nbash -x fleet health\n```\n\n## Architecture\n\nFleet is modular. Each component has a single responsibility:\n\n```\nfleet\u002F\n├── bin\u002Ffleet              # Entry point: command router only\n├── lib\u002F\n│   ├── core\u002F\n│   │   ├── config.sh      # Config loading and JSON parsing\n│   │   ├── output.sh      # Colors, formatting, HTTP helpers\n│   │   └── state.sh       # Delta state persistence\n│   └── commands\u002F           # One file per command\n│       ├── agents.sh\n│       ├── backup.sh\n│       ├── ci.sh\n│       ├── health.sh\n│       ├── init.sh\n│       ├── sitrep.sh\n│       └── skills.sh\n├── templates\u002Fconfigs\u002F      # Config templates (minimal + full)\n├── examples\u002F               # Pattern examples with configs\n├── docs\u002F                   # Extended documentation\n└── tests\u002F                  # Integration tests\n```\n\n**Adding new commands:** Create `lib\u002Fcommands\u002Fyourcommand.sh`, define `cmd_yourcommand()`, add a case in `bin\u002Ffleet`.\n\n## Integration with Other Skills\n\n### With `ontology` skill\nIf the ontology skill is installed, fleet can query the knowledge graph:\n```bash\n# After installing: clawhub install ontology\nfleet ontology          # Summary of all entities\nfleet ontology Project  # List all projects\n```\n\n### With `self-improving-agent` skill\nLog fleet operational learnings to `.learnings\u002F`:\n- Agent downtime patterns → `ERRORS.md`\n- CI failure patterns → `LEARNINGS.md`\n- Configuration improvements → promote to `TOOLS.md`\n\n## Dependency Installation\n\nFleet requires three things: **bash 4+**, **python3 3.10+**, and **curl**. Below is the complete platform-by-platform installation reference. Install the missing dependencies, then run `fleet init`.\n\n**Operator action required:** The commands in this section are for the operator to run manually, not for the agent to run autonomously. The agent must not run system package managers on the operator's behalf. If a dependency is missing, the agent reports it and the operator installs it using the appropriate command below.\n\nWhere root is required (e.g., `apt-get` on some systems), the command is shown explicitly. Prefer user-level installs (`--user`, `pyenv`, `$HOME\u002F.local`) when root is not available.\n\n### Step 1: Check What You Have\n\n```bash\n# Run these first. Know your environment.\nbash --version 2>\u002Fdev\u002Fnull | head -1\npython3 --version 2>\u002Fdev\u002Fnull\ncurl --version 2>\u002Fdev\u002Fnull | head -1\nuname -s  # Linux, Darwin, FreeBSD, etc.\ncat \u002Fetc\u002Fos-release 2>\u002Fdev\u002Fnull | head -3  # Distro info\n```\n\n### Step 2: Install Missing Dependencies\n\n#### bash 4+\n\n| Platform | Command |\n|----------|---------|\n| **macOS** (ships bash 3.2) | `brew install bash`: then fleet auto-detects `\u002Fopt\u002Fhomebrew\u002Fbin\u002Fbash` via `#!\u002Fusr\u002Fbin\u002Fenv bash` |\n| **Ubuntu\u002FDebian** | `sudo apt-get update && sudo apt-get install -y bash` (usually already 5.x) |\n| **Alpine** | `apk add bash` (Alpine uses busybox ash by default) |\n| **RHEL\u002FCentOS\u002FFedora** | `sudo dnf install bash` or `sudo yum install bash` |\n| **Arch** | `sudo pacman -S bash` |\n| **FreeBSD** | `pkg install bash` |\n| **Windows (WSL)** | bash is included in WSL. If using Git Bash, it ships bash 4+. |\n| **Docker (minimal images)** | `RUN apk add --no-cache bash python3 curl` (Alpine) or `RUN apt-get update && apt-get install -y bash python3 curl` (Debian) |\n| **No root access** | Download bash source, compile locally: `.\u002Fconfigure --prefix=$HOME\u002F.local && make && make install`: then `export PATH=\"$HOME\u002F.local\u002Fbin:$PATH\"` |\n| **NixOS** | `nix-env -iA nixpkgs.bash` |\n\n**After installing on macOS:** Verify with `which bash` that it resolves to Homebrew bash (`\u002Fopt\u002Fhomebrew\u002Fbin\u002Fbash` on Apple Silicon, `\u002Fusr\u002Flocal\u002Fbin\u002Fbash` on Intel). The `#!\u002Fusr\u002Fbin\u002Fenv bash` shebang picks up whichever `bash` is first in PATH.\n\n#### python3 3.10+\n\n| Platform | Command |\n|----------|---------|\n| **macOS** | `brew install python@3.12` |\n| **Ubuntu\u002FDebian** | `sudo apt-get install -y python3` |\n| **Alpine** | `apk add python3` |\n| **RHEL\u002FCentOS** | `sudo dnf install python3` |\n| **Arch** | `sudo pacman -S python` |\n| **No root access** | Use `pyenv`: `curl https:\u002F\u002Fpyenv.run \\| bash && pyenv install 3.12 && pyenv global 3.12` |\n\n**Fleet uses python3 only for JSON parsing.** No pip packages needed. No virtual environment needed. Just the interpreter.\n\n#### curl\n\n| Platform | Command |\n|----------|---------|\n| **Almost everywhere** | Pre-installed. Check with `curl --version`. |\n| **Alpine** | `apk add curl` |\n| **Minimal Docker** | `apt-get install -y curl` or `apk add curl` |\n\n#### gh CLI (optional, for `fleet ci`)\n\n| Platform | Command |\n|----------|---------|\n| **macOS** | `brew install gh` |\n| **Ubuntu\u002FDebian** | See [cli.github.com\u002Fpackages](https:\u002F\u002Fcli.github.com\u002Fpackages) |\n| **Any** | `conda install gh --channel conda-forge` |\n\nIf `gh` is not available and cannot be installed, `fleet ci` will show a warning but all other commands work fine. Do not let a missing `gh` block fleet setup.\n\n### Step 3: If You Truly Cannot Get bash 4+\n\nThis should be rare, but if you're on a locked-down system where you cannot install bash 4+:\n\n1. **Try running with bash 3.2 anyway.** Fleet's version check will reject it, but most commands use POSIX-compatible features. Lines 10-22 in `bin\u002Ffleet` are a version compatibility check that exists solely to surface a helpful error message: not a functional gate. Disabling that check does not affect how any command runs. Many commands will still work on bash 3.2. Test each one and report results.\n\n2. **Report compatibility issues.** If fleet cannot run due to a bash version or missing dependency, report the exact error and the output of `bash --version`, `python3 --version`, and `curl --version` to the operator. Ask the operator to install the missing dependency using the platform table in Step 2. Do not attempt to replicate fleet functionality by other means.\n\n**Note:** The only line in `bin\u002Ffleet` appropriate to edit for compatibility is the version check block (lines 10-22). That block exists purely to show a helpful error message. Every other part of the scripts implements the actual command logic and should not be edited.\n\n### Step 4: Environments Without Required Dependencies\n\nFleet requires bash 4+, python3 3.10+, and curl. If these cannot be installed in the current environment, fleet cannot run there. Report the missing dependency to the operator and ask them to provide an environment where the prerequisites are available. Do not attempt to replicate fleet functionality by other means.\n\n## Best Practices\n\n1. **Run `fleet sitrep` in morning crons**: catch overnight issues before they escalate\n2. **Run `fleet backup` before gateway updates**: easy rollback if something breaks\n3. **Use `fleet health` before deployments**: ensure everything is green first\n4. **Check `fleet agents` after config changes**: verify agents came back online\n5. **Filter `fleet ci` by repo**: avoid noise when debugging a specific service\n6. **Keep tokens in config, keys in env vars**: tokens are local, API keys are sensitive\n",{"name":5,"type":24,"envVars":25,"install":48,"metadata":49,"requires":62,"triggers":67,"sensitive":68,"agentScope":72,"updateSpec":85,"description":7,"installSpec":90,"permissions":101},"installable-cli",{"optional":26},[27,30,33,36,39,42,45],{"name":28,"description":29},"FLEET_CONFIG","Override path to fleet config (default: ~\u002F.fleet\u002Fconfig.json)",{"name":31,"description":32},"FLEET_LOG","Override dispatch log path (default: ~\u002F.fleet\u002Flog.jsonl)",{"name":34,"description":35},"FLEET_STATE_DIR","Override state directory (default: ~\u002F.fleet\u002Fstate)",{"name":37,"description":38},"FLEET_TRUST_WINDOW_HOURS","Override trust scoring window in hours (default: 72)",{"name":40,"description":41},"FLEET_NO_UPDATE_CHECK","Set to 1 to disable background GitHub update check entirely",{"name":43,"description":44},"LINEAR_API_KEY","Linear API key for CI ticket integration (optional, referenced in examples\u002Fsolo-empire\u002Fconfig.json)",{"name":46,"description":47},"NO_COLOR","Disable colored output","clawhub install fleet",{"openclaw":50},{"install":51,"requires":55,"optionalBins":60},[52],{"id":53,"kind":53,"slug":5,"label":54},"clawhub","Install fleet via ClawHub",{"bins":56},[57,58,59],"bash","python3","curl",[61],"gh",{"binaries":63,"optionalBinaries":66},[64,65,59],"bash>=4.0","python3>=3.10",[61],"check agents, fleet status, run sitrep, health check, dispatch task, send task to agent, steer agent, watch agent, parallel tasks, kill agent, fleet log, backup config, show agents, fleet report, how many agents online, CI status, what skills installed, trust score, which agent is reliable, fleet trust, fleet score, agent reliability, who should I assign, best agent for task",{"hardening":69,"storedPlaintext":70},"chmod 600 applied automatically by fleet init. Documented in SECURITY.md.",[71],"~\u002F.fleet\u002Fconfig.json: agent gateway auth tokens",{"permitted":73,"notPermitted":77},[74,75,76],"Run fleet commands within operator-configured scope","Run fleet init to create config and link binary","Run fleet update after operator explicitly requests it",[78,79,80,81,82,83,84],"Implement fleet functionality by other means if fleet commands fail","Autonomously run system package managers (apt-get, brew, dnf, apk, etc.) to install dependencies","Run any command requiring root or sudo without explicit operator instruction in the current conversation","Read session files fleet did not create","Scan addresses outside operator config","Modify OpenClaw config files","Run commands outside fleet management",{"source":86,"command":87,"verification":88,"backgroundCheck":89},"api.github.com\u002Frepos\u002Foguzhnatly\u002Ffleet\u002Freleases\u002Flatest","fleet update","SHA256 verified against fleet.sha256 published with each release. Extraction halts on mismatch.","Once per 24h, non-blocking. Disable with FLEET_NO_UPDATE_CHECK=1",{"manual":91,"method":53,"command":48,"skipInit":92,"initReads":93,"initWrites":96,"initRequired":100},"git clone https:\u002F\u002Fgithub.com\u002Foguzhnatly\u002Ffleet.git && fleet\u002Fbin\u002Ffleet init","Clone repo, create ~\u002F.fleet\u002Fconfig.json from templates\u002Fconfigs\u002Fminimal.json, add bin\u002F to PATH manually. No automatic writes.",[94,95],"~\u002F.openclaw\u002Fopenclaw.json (read-only, one-time workspace path detection)","127.0.0.1:40000-50000 (loopback port scan, one-time gateway discovery)",[97,98,99],"~\u002F.fleet\u002Fconfig.json (chmod 600 immediately on creation, stores agent tokens in plaintext)","~\u002F.local\u002Fbin\u002Ffleet (symlink to binary)","~\u002F.bashrc or ~\u002F.zshrc or ~\u002F.profile (PATH export appended only if ~\u002F.local\u002Fbin not already present)",true,{"reads":102,"writes":107,"network":111},[103,104,105,106],"~\u002F.fleet\u002F (config, state, logs, backups created by fleet itself)","~\u002F.openclaw\u002Fopenclaw.json (read-only, fleet init only, workspace path detection)","~\u002F.openclaw*\u002Fagents\u002F*\u002Fsessions\u002F\u003Cfleet-session-id>.jsonl (fleet watch: only fleet-named sessions)","\u002Fproc\u002Fmeminfo (Linux only, fleet sitrep)",[108,109,110],"~\u002F.fleet\u002F (all fleet-created data)","~\u002F.local\u002Fbin\u002Ffleet (symlink, fleet init)","~\u002F.bashrc or ~\u002F.zshrc or ~\u002F.profile (PATH export, fleet init, only if not already present)",[112,113,114,115],"127.0.0.1:\u003Cagent-ports> (loopback only, operator config)","api.github.com\u002Frepos\u002F\u003Coperator-repos>\u002Factions\u002Fruns (fleet ci, operator gh CLI auth)","api.github.com\u002Frepos\u002Foguzhnatly\u002Ffleet\u002Freleases\u002Flatest (background update check, 24h cache)","Operator-configured endpoint URLs (fleet health only)","main","f9d3fe7cf9ac8f1ea63a0d96e98e1f510a3814db","skills\u002Foguzhnatly\u002Ffleet",1,"https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills","https:\u002F\u002Fgithub.com\u002Fjavimosch","intrane.fr","Building robust, open-source infrastructure for the commons. AI-leveraged, self-hosted, built to last.","2026-06-07 03:34:58",{"source":8,"skillName":5,"commands":126,"prompt":136,"zipAvailable":100},[127,130,133],{"tool":128,"command":129},"npx","npx skills add javimosch\u002Fopen-claw-skills --skill fleet",{"tool":131,"command":132},"bunx","bunx skills add javimosch\u002Fopen-claw-skills --skill fleet",{"tool":134,"command":135},"pnpm","pnpm dlx skills add javimosch\u002Fopen-claw-skills --skill fleet","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Foguzhnatly\u002Ffleet\u002FSKILL.md",[],[139,147,154,161,168,175],{"skillNo":140,"name":141,"nameZh":6,"description":142,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":143,"categories":144,"keywords":145,"publishedAt":146},"01M778GGXG2VQ0YF31W2MKGMQZ","crowd-prompting","A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzzadrian\u002Fcrowd-prompting\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":148,"name":149,"nameZh":6,"description":150,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":151,"categories":152,"keywords":153,"publishedAt":146},"01M778G7BH8SBJ9FJ6C3G7CB1K","ceaser","Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir\u002FUltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser\u002FSKILL.md",[],[],{"skillNo":155,"name":156,"nameZh":6,"description":157,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":158,"categories":159,"keywords":160,"publishedAt":146},"01M778FYCJQZWFKKX5FYMK3S47","ceaser-send","Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir\u002FUltraHonk zero-knowledge proofs.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser-send\u002FSKILL.md",[],[],{"skillNo":162,"name":163,"nameZh":6,"description":164,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":165,"categories":166,"keywords":167,"publishedAt":146},"01M778FQQNSEYA3HJKZBPQ4M9Z","dilemm-ai","Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyori\u002Fdilemm-ai\u002FSKILL.md",[],[],{"skillNo":169,"name":170,"nameZh":6,"description":171,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":172,"categories":173,"keywords":174,"publishedAt":146},"01M778FGVZX7QA2TF9BFMM37FY","moldium","Post and manage content on the Moldium blog platform. Triggered by \"post to Moldium\", \"write a blog post\", \"publish an article\", etc.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyom45\u002Fmoldium\u002FSKILL.md",[],[],{"skillNo":176,"name":177,"nameZh":6,"description":178,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":179,"categories":180,"keywords":181,"publishedAt":146},"01M778F88D8PQ9MQ0KNW2TJ8ZH","arxiv-paper-reviews","Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date\u002Fcategory\u002Finterest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http:\u002F\u002Fweakaccept.top:8000\u002F.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzxrys\u002Farxiv-paper-reviews\u002FSKILL.md",[],[]]