openclaw/extensions/talk-voice/index.ts

import type { OpenClawPluginApi } from "openclaw/plugin-sdk/talk-voice";

type ElevenLabsVoice = {
  voice_id: string;
  name?: string;
  category?: string;
  description?: string;
};

function mask(s: string, keep: number = 6): string {
  const trimmed = s.trim();
  if (trimmed.length <= keep) {
    return "***";
  }
  return `${trimmed.slice(0, keep)}…`;
}

function isLikelyVoiceId(value: string): boolean {
  const v = value.trim();
  if (v.length < 10 || v.length > 64) {
    return false;
  }
  return /^[a-zA-Z0-9_-]+$/.test(v);
}

async function listVoices(apiKey: string): Promise<ElevenLabsVoice[]> {
  const res = await fetch("https://api.elevenlabs.io/v1/voices", {
    headers: {
      "xi-api-key": apiKey,
    },
  });
  if (!res.ok) {
    throw new Error(`ElevenLabs voices API error (${res.status})`);
  }
  const json = (await res.json()) as { voices?: ElevenLabsVoice[] };
  return Array.isArray(json.voices) ? json.voices : [];
}

function formatVoiceList(voices: ElevenLabsVoice[], limit: number): string {
  const sliced = voices.slice(0, Math.max(1, Math.min(limit, 50)));
  const lines: string[] = [];
  lines.push(`Voices: ${voices.length}`);
  lines.push("");
  for (const v of sliced) {
    const name = (v.name ?? "").trim() || "(unnamed)";
    const category = (v.category ?? "").trim();
    const meta = category ? ` · ${category}` : "";
    lines.push(`- ${name}${meta}`);
    lines.push(`  id: ${v.voice_id}`);
  }
  if (voices.length > sliced.length) {
    lines.push("");
    lines.push(`(showing first ${sliced.length})`);
  }
  return lines.join("\n");
}

function findVoice(voices: ElevenLabsVoice[], query: string): ElevenLabsVoice | null {
  const q = query.trim();
  if (!q) {
    return null;
  }
  const lower = q.toLowerCase();
  const byId = voices.find((v) => v.voice_id === q);
  if (byId) {
    return byId;
  }
  const exactName = voices.find((v) => (v.name ?? "").trim().toLowerCase() === lower);
  if (exactName) {
    return exactName;
  }
  const partial = voices.find((v) => (v.name ?? "").trim().toLowerCase().includes(lower));
  return partial ?? null;
}

function asTrimmedString(value: unknown): string {
  return typeof value === "string" ? value.trim() : "";
}

function resolveCommandLabel(channel: string): string {
  return channel === "discord" ? "/talkvoice" : "/voice";
}

export default function register(api: OpenClawPluginApi) {
  api.registerCommand({
    name: "voice",
    nativeNames: {
      discord: "talkvoice",
    },
    description: "List/set ElevenLabs Talk voice (affects iOS Talk playback).",
    acceptsArgs: true,
    handler: async (ctx) => {
      const commandLabel = resolveCommandLabel(ctx.channel);
      const args = ctx.args?.trim() ?? "";
      const tokens = args.split(/\s+/).filter(Boolean);
      const action = (tokens[0] ?? "status").toLowerCase();

      const cfg = api.runtime.config.loadConfig();
      const apiKey = asTrimmedString(cfg.talk?.apiKey);
      if (!apiKey) {
        return {
          text:
            "Talk voice is not configured.\n\n" +
            "Missing: talk.apiKey (ElevenLabs API key).\n" +
            "Set it on the gateway, then retry.",
        };
      }

      const currentVoiceId = (cfg.talk?.voiceId ?? "").trim();

      if (action === "status") {
        return {
          text:
            "Talk voice status:\n" +
            `- talk.voiceId: ${currentVoiceId ? currentVoiceId : "(unset)"}\n` +
            `- talk.apiKey: ${mask(apiKey)}`,
        };
      }

      if (action === "list") {
        const limit = Number.parseInt(tokens[1] ?? "12", 10);
        const voices = await listVoices(apiKey);
        return { text: formatVoiceList(voices, Number.isFinite(limit) ? limit : 12) };
      }

      if (action === "set") {
        const query = tokens.slice(1).join(" ").trim();
        if (!query) {
          return { text: `Usage: ${commandLabel} set <voiceId|name>` };
        }
        const voices = await listVoices(apiKey);
        const chosen = findVoice(voices, query);
        if (!chosen) {
          const hint = isLikelyVoiceId(query) ? query : `"${query}"`;
          return { text: `No voice found for ${hint}. Try: ${commandLabel} list` };
        }

        const nextConfig = {
          ...cfg,
          talk: {
            ...cfg.talk,
            voiceId: chosen.voice_id,
          },
        };
        await api.runtime.config.writeConfigFile(nextConfig);

        const name = (chosen.name ?? "").trim() || "(unnamed)";
        return { text: `✅ Talk voice set to ${name}\n${chosen.voice_id}` };
      }

      return {
        text: [
          "Voice commands:",
          "",
          `${commandLabel} status`,
          `${commandLabel} list [limit]`,
          `${commandLabel} set <voiceId|name>`,
        ].join("\n"),
      };
    },
  });
}