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 <feishu_open_id> 
  --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.