vultr/openclaw
1
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-05-06 13:00:44 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs(tools): clarify sessions_spawn profile gating

Browse Source
This commit is contained in:
Peter Steinberger
2026-04-27 14:31:50 +01:00
parent 23d047dff5
commit c00ef238be
2 changed files with 29 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
docs/concepts/session-tool.md
View File

@@ -22,6 +22,27 @@ orchestrate sub-agents.
| `subagents` | List, steer, or kill spawned sub-agents for this session |
| `session_status` | Show a `/status`-style card and optionally set a per-session model override |
These tools are still subject to the active tool profile and allow/deny
policy. `tools.profile: "coding"` includes the full session orchestration
set, including `sessions_spawn`, `sessions_yield`, and `subagents`.
`tools.profile: "messaging"` includes cross-session messaging tools
(`sessions_list`, `sessions_history`, `sessions_send`, `session_status`) but
does not include sub-agent spawning. To keep a messaging profile and still
allow native delegation, add:
```json5
{
tools: {
profile: "messaging",
alsoAllow: ["sessions_spawn", "sessions_yield", "subagents"],
},
}
```
Group, provider, sandbox, and per-agent policies can still remove those tools
after the profile stage. Use `/tools` from the affected session to inspect the
effective tool list.
## Listing and reading sessions
`sessions_list` returns sessions with their key, agentId, kind, channel, model,