openclaw - 💡(How to fix) Fix sessions_spawn tool not available - multi-agent dispatch blocked [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#72823Fetched 2026-04-28 06:31:56
View on GitHub
Comments
1
Participants
2
Timeline
3
Reactions
0
Timeline (top)
closed ×1commented ×1cross-referenced ×1

Fix Action

Workaround

Use exec + file passing instead of native sessions_spawn dispatch.

RAW_BUFFERClick to expand / collapse

Issue

sessions_spawn is documented in SOUL.md but the tool is not actually available in the agent tool list. This blocks native multi-agent dispatch.

Environment

  • OpenClaw: 2026.4.22+
  • Channel: Feishu
  • Model: minimax/MiniMax-M2.7

Expected Behavior

sessions_spawn should be available as a native tool for dispatching sub-agents.

Actual Behavior

  • SOUL.md documents sessions_spawn usage
  • Tool list does NOT include sessions_spawn
  • Attempting to use it returns no result (tool not available)

Workaround

Use exec + file passing instead of native sessions_spawn dispatch.

Impact

  • Native multi-agent parallel dispatch is blocked
  • Must use workaround (exec + file) which is less reliable
  • sessions_spawn completion event push also broken (see issue #72638)

Tags

#missing-feature #sessions-spawn #multi-agent

extent analysis

TL;DR

The sessions_spawn tool is not available in the agent tool list, so using the exec command with file passing is a potential workaround.

Guidance

  • Verify that the OpenClaw version is indeed 2026.4.22 or later, as the issue might be version-specific.
  • Check the SOUL.md documentation for any hints on why sessions_spawn is documented but not available.
  • Test the suggested workaround using exec and file passing to dispatch sub-agents, and evaluate its reliability compared to the native sessions_spawn tool.
  • Review issue #72638 for potential insights into the broken sessions_spawn completion event push.

Notes

The root cause of the missing sessions_spawn tool is unclear, and it's uncertain whether this is a documentation error or a genuine missing feature.

Recommendation

Apply the workaround using exec and file passing, as it seems to be the only available solution until the sessions_spawn tool is made available.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

openclaw - 💡(How to fix) Fix sessions_spawn tool not available - multi-agent dispatch blocked [1 comments, 2 participants]