vrr/openclaw
2
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-10-03 17:53:39 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 31

docs(tts): explain that restricted tool profiles exclude the tts tool (#155950)

Browse source 
The tts catalog entry belongs to no built-in profile, so minimal, coding,
and messaging all remove it with no documented way back. Document the
tools.alsoAllow grant on the agent-tool page and the profile table, and
note that automatic TTS is unaffected by tool profiles.

Refs #126688
This commit is contained in:
Fede Kamelhar 2026-09-30 19:52:23 -04:00 • committed by GitHub
parent 02cf3f0d1d
commit c4e32ccfe1
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 26 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

5
docs/gateway/config-tools/tool-policy.md
View file

@ -41,6 +41,11 @@ workspace and identity checks or the meeting transcript caller checks.
`coding` and `messaging` also include the [theme tool](/tools/theme) and implicitly
allow `bundle-mcp` (configured MCP servers).
The [`tts` tool](/tools/tts/api#tool-profiles) is not part of any restricted
profile. To let an agent on `minimal`, `coding`, or `messaging` call it, add
`tts` to `tools.alsoAllow`. [Automatic TTS](/tools/tts/output#auto-tts-behavior)
is not a tool, so profiles do not affect it.
An unset profile also leaves core tools unfiltered, but does not itself opt into
optional plugin tools. Explicit `full` contributes a wildcard to plugin tool
selection, including optional tools from enabled plugins. Plugin configuration,

21
docs/tools/tts/api.md
View file

@ -23,6 +23,27 @@ per-call provider request timeout in milliseconds. Per-call values override
`tts.timeoutMs`; configured TTS timeouts override any plugin-authored
provider default.
### Tool profiles
`tts` is not part of the `minimal`, `coding`, or `messaging`
[tool profiles](/gateway/config-tools/tool-policy#tool-profiles). Agents on
those profiles cannot call it until you grant it explicitly:
```json5
{
tools: {
profile: "messaging",
alsoAllow: ["tts"],
},
}
```
The `full` profile and an unset profile include `tts` without extra
configuration. Other allow/deny layers can still remove it.
Tool profiles do not affect [automatic TTS](/tools/tts/output#auto-tts-behavior):
`tts.auto` still speaks replies when the agent cannot call the `tts` tool.
## Gateway RPC
| Method | Purpose |