Files
openclaw/docs/plugins/reference/talk-voice.md
Peter Steinberger f44c5e2e5e fix(plugins): surface manifest-only bundled capabilities (#121354)
Use a manifest-first inventory with independent coverage for manifest-only bundled capabilities.

Retire the undocumented thread-ownership plugin while Doctor removes stale references.

Document Talk voice and persist only provider-scoped voice selection.

Closes #121353
2026-08-09 19:43:49 -07:00

36 lines
1.5 KiB
Markdown

---
summary: "Manage Talk voice selection (list/set)."
read_when:
- You are installing, configuring, or auditing the talk-voice plugin
title: "Talk Voice plugin"
---
# Talk Voice plugin
Manage Talk voice selection (list/set).
## Distribution
- Package: `openclaw`
- Install route: included in OpenClaw
## Surface
commands: `/voice`
<!-- openclaw-plugin-reference:manual-start -->
## Configure a Talk voice from chat
Set `talk.provider` and configure the matching `talk.providers.<provider>` entry before using the command. The active provider must support voice listing.
- `/voice status` shows the active provider and selected provider-scoped voice ID. The API-key field is only a masked or unset config value; it does not prove that usable credentials are available.
- `/voice list [limit]` lists voices from the active provider. The default limit is 12 and the maximum is 50.
- `/voice set <voiceId|name>` resolves a voice by exact ID, exact name, or partial name, then saves it to `talk.providers.<activeProvider>.voiceId`.
Discord registers the native command as `/talkvoice`; its subcommands and arguments are the same. Status and list are read-only. Setting a voice requires an owner on a message channel or the `operator.admin` scope for a Gateway client.
Failures are returned visibly in chat. Missing Talk configuration identifies the required keys; provider lookup errors include the provider error; unknown voices suggest listing available voices; and unauthorized writes state the required permission.
<!-- openclaw-plugin-reference:manual-end -->