Official Verified

subagent-spawn-command-builder

Build sessions_spawn command payloads from JSON profiles. Use when you want reusable subagent profiles (model/thinking/timeout/cleanup/agentId/label) and command-ready JSON without executing spawn.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/nextaltair/subagent-spawn-command-builder

Download Source Code (.zip)

subagent-spawn-command-builder

Generate sessions_spawn payload JSON from profile config. This skill does not execute sessions_spawn; it only builds payload/command JSON.

Files

Profile template: state/spawn-profiles.template.json
Active profile config: state/spawn-profiles.json
Builder script: scripts/build_spawn_payload.mjs
Builder log: state/build-log.jsonl

Supported sessions_spawn parameters

task (required)
label (optional)
agentId (optional)
model (optional)
thinking (optional)
runTimeoutSeconds (optional)
cleanup (keep|delete, optional)

Setup

cp skills/subagent-spawn-command-builder/state/spawn-profiles.template.json \
   skills/subagent-spawn-command-builder/state/spawn-profiles.json

Then edit spawn-profiles.json.

Generate payload

skills/subagent-spawn-command-builder/scripts/build_spawn_payload.mjs \
  --profile heartbeat \
  --task "Analyze recent context and return a compact summary" \
  --label heartbeat-test

The script prints JSON directly usable for sessions_spawn.

Merge/priority rule

Value resolution order is:

CLI option (--model, --thinking, etc.)
Profile value (profiles.<name>.*)
Defaults value (defaults.*)

task always comes from CLI --task.

CLI options

Note: this builder is Node.js (.mjs) based. If generated tasks include Python execution steps, write commands with python3 (not python).

--profile (required)
--task (required)
--label
--agent-id
--model
--thinking
--run-timeout-seconds
--cleanup keep|delete

Read Full Documentation on GitHub

Metadata

Author@nextaltair

Stars1335

Updated2026-02-23

View Author Profile

AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill

Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-nextaltair-subagent-spawn-command-builder": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

diy-pc-ingest

Ingest pasted PC parts purchase/config text (Discord message receipts, bullet lists) into Notion DIY_PC tables (PCConfig, ストレージ, エンクロージャー, PCInput). Use when the user pastes raw purchase logs/spec notes and wants the AI to classify, enrich via web search, ask follow-up questions for unknowns, and then upsert rows into the correct Notion data sources using the 2025-09-03 data_sources API.

nextaltair 1335

calibre-catalog-read

Read Calibre catalog data via calibredb over a Content server, and run one-book analysis workflow that writes HTML analysis block back to comments while caching analysis state in SQLite. Use for list/search/id lookups and AI reading pipeline for a selected book.

nextaltair 1335

soul-in-sapphire

Generic long-term memory (LTM) operations for OpenClaw using Notion (2025-09-03 data_sources). Use for durable memory writes/search, emotion-state ticks, journal writes, and model-controlled subagent spawn planning via local JSON presets.

nextaltair 1335

calibre-metadata-apply

Apply metadata updates to existing Calibre books via calibredb over a Content server. Use for controlled metadata edits after target IDs are confirmed by a read-only lookup.

nextaltair 1335

diy-pc-ingest

nextaltair 1335