openclaw/docs/plugins/reference/talk-voice.md

Multi-channel AI gateway with extensible messaging integrations

---
summary: "Manage Talk voice selection (list/set)."
read_when:
  - You are installing, configuring, or auditing the talk-voice plugin
title: "Talk Voice plugin reference"
---

<!-- Generated file. Do not edit by hand.
Run `pnpm plugins:inventory:gen` to rebuild it. Hand-written text survives only
between the openclaw-plugin-reference:manual-start and
openclaw-plugin-reference:manual-end comment markers. -->

Manage Talk voice selection (list/set).

## Distribution

- Package: `openclaw`
- Install route: included in OpenClaw

## Surface

- Slash commands: `/voice`
- Contracts: `tools`

<!-- 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 -->