Feishu Voice Loop

---

name: feishu-voice-loop description: A reusable Feishu voice loop: accept text or voice input, generate natural OpenAI speech, and deliver it to chat or web playback. Use when building or sharing a reusable Feishu voice workflow with text-or-voice in and audio out, including browser playback and Feishu voice replies.

---

Feishu Voice Loop

Provide a reusable three-step voice loop for OpenClaw: 1. accept text or voice input 2. generate speech with OpenAI TTS 3. return the audio to Feishu or a web player

When the input is voice, transcribe it to text first, then continue through the same output pipeline.

Quick start

Prerequisites:

OPENAI_API_KEY is set for TTS

Feishu app credentials exist in ~/.openclaw/openclaw.json under channels.feishu.appId/appSecret, or are passed explicitly

ffmpeg and ffprobe are installed and available

local audio transcription is configured in ~/.openclaw/openclaw.json under tools.media.audio.models

Main scripts:

scripts/openai_tts_feishu.py

scripts/transcribe_audio.py

Tasks

1. Transcribe voice input

Use this when you have a local .ogg, .opus, .wav, or similar file and want text.

python3 scripts/transcribe_audio.py /path/to/input.ogg

This script reuses the existing Whisper CLI configuration from ~/.openclaw/openclaw.json.

2. Generate and send voice output

Use this when you already have text and want to send a Feishu voice message.

python3 scripts/openai_tts_feishu.py \
  --to  \
  --text "这条是语音测试。" \
  --voice alloy \
  --model gpt-4o-mini-tts

The script will: 1. call OpenAI audio/speech 2. save WAV audio temporarily 3. convert to Feishu-friendly Opus via ffmpeg 4. upload the file to Feishu 5. send an audio message to the target open_id

3. Run the full voice loop

Use this skill when the goal is a reusable voice interaction pipeline: 1. transcribe input audio to text 2. decide or generate the reply text 3. synthesize reply audio with OpenAI TTS 4. send the reply back to Feishu

Read references/input-output-workflow.md when building or explaining the end-to-end loop.

Default output style

Default preset is stored in references/presets.md.

Unless the user asks otherwise, use:

model: gpt-4o-mini-tts

voice: alloy

default style: 年轻日系男声感、温柔里带一点撩、贴耳边私聊感、自然、不播音腔

When the user asks for a different flavor, either:

pass a custom --instructions

or adapt one of the presets in references/presets.md

Handle failures

Common failure cases:

Missing OPENAI_API_KEY → ask for API key / env setup

HTTP 429 from OpenAI → billing or quota issue

missing Feishu app credentials → configure channels.feishu.appId/appSecret

missing ffmpeg or ffprobe → install locally before retrying

missing transcription model config → configure tools.media.audio.models

When OpenAI billing is not enabled, say so directly instead of pretending the voice was generated.

Packaging and sharing

Package with:

python3 /Users/zoepeng/.openclaw/lib/node_modules/openclaw/skills/skill-creator/scripts/package_skill.py \
  /Users/zoepeng/.openclaw/workspace/skills/openai-feishu-voice

The resulting .skill file can be shared or uploaded wherever the user distributes skills.

Resources

scripts/openai_tts_feishu.py

Use for deterministic TTS generation and Feishu delivery.

scripts/transcribe_audio.py

Use for deterministic local audio transcription via the configured Whisper CLI.

references/presets.md

Read when the user asks for a different voice direction or wants named presets.

references/input-output-workflow.md

Read when packaging or explaining the complete voice-in / voice-out solution.

Prerequisites:

OPENAI_API_KEY is set for TTS

Feishu app credentials exist in ~/.openclaw/openclaw.json under channels.feishu.appId/appSecret, or are passed explicitly

ffmpeg and ffprobe are installed and available

local audio transcription is configured in ~/.openclaw/openclaw.json under tools.media.audio.models

Main scripts:

scripts/openai_tts_feishu.py

scripts/transcribe_audio.py