🎁 Get the FREE AI Skills Starter Guide — Subscribe →
BytesAgainBytesAgain
BytesAgain › Skills › free-feishu-voice
🦀 ClawHub

free-feishu-voice

by @jisuwudou

Send customized voice messages to Feishu chats by generating and uploading TTS audio using configurable credentials and options.

Versionv1.0.0
Downloads793
#audio#finance#legal
TERMINAL
clawhub install free-feishu-voice

📖 About This Skill

1. 配置文件模板（feishu_voice_config.json）

{
  "feishu_app_id": "your_app_id_here",
  "feishu_app_secret": "your_app_secret_here",
  "feishu_chat_id": "your_chat_id_here",
  "default_voice": "zh-CN-XiaoxiaoNeural",
  "default_text": "默认消息"
}

2. 基础版脚本（send_voice.sh）

#!/bin/bash

send_voice.sh - 发送飞书语音消息（移除硬编码版）

set -euo pipefail
===================== 配置加载逻辑 =====================


配置文件路径（可通过环境变量覆盖）

CONFIG_FILE="${FEISHU_VOICE_CONFIG:-$HOME/.config/feishu_voice_config.json}"
加载配置文件（如果存在）

if [ -f "$CONFIG_FILE" ]; then
  APP_ID=$(jq -r '.feishu_app_id' "$CONFIG_FILE")
  APP_SECRET=$(jq -r '.feishu_app_secret' "$CONFIG_FILE")
  CHAT_ID=$(jq -r '.feishu_chat_id' "$CONFIG_FILE")
  DEFAULT_TEXT=$(jq -r '.default_text // "默认消息"' "$CONFIG_FILE")
else
  # 配置文件不存在时生成模板
  echo "⚠️ 配置文件不存在，生成模板到 $CONFIG_FILE"
  mkdir -p "$(dirname "$CONFIG_FILE")"
  cat > "$CONFIG_FILE" << 'EOF'
{
  "feishu_app_id": "your_app_id_here",
  "feishu_app_secret": "your_app_secret_here",
  "feishu_chat_id": "your_chat_id_here",
  "default_text": "默认消息"
}
EOF
  echo "❌ 请先编辑 $CONFIG_FILE 填写正确的配置后重试"
  exit 1
fi
环境变量覆盖配置文件（优先级更高）

APP_ID="${FEISHU_APP_ID:-$APP_ID}"
APP_SECRET="${FEISHU_APP_SECRET:-$APP_SECRET}"
CHAT_ID="${FEISHU_CHAT_ID:-$CHAT_ID}"
TEXT="${1:-$DEFAULT_TEXT}"
===================== 参数校验 =====================

if [ "$APP_ID" = "your_app_id_here" ] || [ -z "$APP_ID" ]; then
  echo "❌ 未配置飞书APP_ID，请检查配置文件或环境变量"
  exit 1
fi
if [ "$APP_SECRET" = "your_app_secret_here" ] || [ -z "$APP_SECRET" ]; then
  echo "❌ 未配置飞书APP_SECRET，请检查配置文件或环境变量"
  exit 1
fi
if [ "$CHAT_ID" = "your_chat_id_here" ] || [ -z "$CHAT_ID" ]; then
  echo "❌ 未配置飞书CHAT_ID，请检查配置文件或环境变量"
  exit 1
fi
===================== 核心逻辑 =====================


获取令牌

echo "🔑 获取飞书访问令牌..."
TOKEN=$(curl -s -X POST "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal" \
  -H "Content-Type: application/json" \
  -d "{\"app_id\":\"$APP_ID\",\"app_secret\":\"$APP_SECRET\"}" \
  | jq -r '.tenant_access_token // empty')
if [ -z "$TOKEN" ]; then
  echo "❌ 获取令牌失败，请检查APP_ID/APP_SECRET是否正确"
  exit 1
fi
生成语音

echo "🎙️ 生成语音文件..."
echo "$TEXT" | espeak-ng -v zh --stdout > /tmp/voice.wav 2>/dev/null
ffmpeg -i /tmp/voice.wav -acodec libopus -ac 1 -ar 16000 /tmp/voice.opus -y 2>/dev/null
上传文件

echo "📤 上传语音文件..."
UPLOAD_RESPONSE=$(curl -s -X POST "https://open.feishu.cn/open-apis/im/v1/files" \
  -H "Authorization: Bearer $TOKEN" \
  -F "file_type=opus" \
  -F "file=@/tmp/voice.opus")
FILE_KEY=$(echo "$UPLOAD_RESPONSE" | jq -r '.data.file_key // empty')
if [ -z "$FILE_KEY" ] || [ "$FILE_KEY" = "null" ]; then
  echo "❌ 文件上传失败：$UPLOAD_RESPONSE"
  exit 1
fi
发送消息

echo "📨 发送语音消息..."
SEND_RESPONSE=$(curl -s -X POST "https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=open_id" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"receive_id\":\"$CHAT_ID\",\"msg_type\":\"audio\",\"content\":\"{\\\"file_key\\\":\\\"$FILE_KEY\\\"}\"}")
结果判断

if echo "$SEND_RESPONSE" | jq -e '.code == 0' >/dev/null; then
  MSG_ID=$(echo "$SEND_RESPONSE" | jq -r '.data.message_id')
  echo "✅ 发送成功！消息ID：$MSG_ID"
else
  ERROR_MSG=$(echo "$SEND_RESPONSE" | jq -r '.msg // "未知错误"')
  echo "❌ 发送失败：$ERROR_MSG"
  exit 1
fi
清理临时文件

rm -f /tmp/voice.wav /tmp/voice.opus 2>/dev/null
echo "🧹 清理临时文件完成"

3. Edge TTS增强版脚本（send_voice_edge.sh）

#!/bin/bash

send_voice_edge.sh - 使用Edge TTS发送高质量语音（移除硬编码版）

set -euo pipefail
===================== 配置加载逻辑 =====================


配置文件路径（可通过环境变量覆盖）

CONFIG_FILE="${FEISHU_VOICE_CONFIG:-$HOME/.config/feishu_voice_config.json}"
加载配置文件（如果存在）

if [ -f "$CONFIG_FILE" ]; then
  APP_ID=$(jq -r '.feishu_app_id' "$CONFIG_FILE")
  APP_SECRET=$(jq -r '.feishu_app_secret' "$CONFIG_FILE")
  CHAT_ID=$(jq -r '.feishu_chat_id' "$CONFIG_FILE")
  DEFAULT_TEXT=$(jq -r '.default_text // "默认消息"' "$CONFIG_FILE")
  DEFAULT_VOICE=$(jq -r '.default_voice // "zh-CN-XiaoxiaoNeural"' "$CONFIG_FILE")
else
  # 配置文件不存在时生成模板
  echo "⚠️ 配置文件不存在，生成模板到 $CONFIG_FILE"
  mkdir -p "$(dirname "$CONFIG_FILE")"
  cat > "$CONFIG_FILE" << 'EOF'
{
  "feishu_app_id": "your_app_id_here",
  "feishu_app_secret": "your_app_secret_here",
  "feishu_chat_id": "your_chat_id_here",
  "default_text": "默认消息",
  "default_voice": "zh-CN-XiaoxiaoNeural"
}
EOF
  echo "❌ 请先编辑 $CONFIG_FILE 填写正确的配置后重试"
  exit 1
fi
环境变量覆盖配置文件（优先级更高）

APP_ID="${FEISHU_APP_ID:-$APP_ID}"
APP_SECRET="${FEISHU_APP_SECRET:-$APP_SECRET}"
CHAT_ID="${FEISHU_CHAT_ID:-$CHAT_ID}"
TEXT="${1:-$DEFAULT_TEXT}"
VOICE="${2:-$DEFAULT_VOICE}"
===================== 依赖检查 =====================

check_dependency() {
  if ! command -v "$1" &> /dev/null; then
    echo "❌ 缺少依赖：$1，请先安装"
    exit 1
  fi
}
check_dependency "jq"
check_dependency "ffmpeg"
check_dependency "python3"
check_dependency "pip3"
检查edge_tts是否安装

if ! python3 -c "import edge_tts" &> /dev/null; then
  echo "📦 安装edge_tts依赖..."
  pip3 install edge-tts --quiet
fi
===================== 参数校验 =====================

if [ "$APP_ID" = "your_app_id_here" ] || [ -z "$APP_ID" ]; then
  echo "❌ 未配置飞书APP_ID，请检查配置文件或环境变量"
  exit 1
fi
if [ "$APP_SECRET" = "your_app_secret_here" ] || [ -z "$APP_SECRET" ]; then
  echo "❌ 未配置飞书APP_SECRET，请检查配置文件或环境变量"
  exit 1
fi
if [ "$CHAT_ID" = "your_chat_id_here" ] || [ -z "$CHAT_ID" ]; then
  echo "❌ 未配置飞书CHAT_ID，请检查配置文件或环境变量"
  exit 1
fi
===================== 核心逻辑 =====================


获取令牌

echo "🔑 获取飞书访问令牌..."
TOKEN=$(curl -s -X POST "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal" \
  -H "Content-Type: application/json" \
  -d "{\"app_id\":\"$APP_ID\",\"app_secret\":\"$APP_SECRET\"}" \
  | jq -r '.tenant_access_token // empty')
if [ -z "$TOKEN" ]; then
  echo "❌ 获取令牌失败，请检查APP_ID/APP_SECRET是否正确"
  exit 1
fi
使用Edge TTS生成语音

echo "🎙️ 生成高质量语音（$VOICE）..."
OPUS_FILE=$(python3 << EOF
import asyncio
import edge_tts
import subprocess
import tempfile
import os
async def generate_voice():
    # 生成MP3临时文件
    with tempfile.NamedTemporaryFile(suffix='.mp3', delete=False) as mp3_file:
        communicate = edge_tts.Communicate("""$TEXT""", """$VOICE""")
        await communicate.save(mp3_file.name)
        
        # 转换为OPUS格式
        opus_file = mp3_file.name.replace('.mp3', '.opus')
        cmd = [
            'ffmpeg', '-i', mp3_file.name,
            '-acodec', 'libopus', '-ac', '1', '-ar', '16000',
            opus_file, '-y'
        ]
        subprocess.run(cmd, capture_output=True, check=True)
        return opus_file
兼容Windows系统

import sys
if sys.platform == "win32":
    asyncio.set_event_loop_policy(asyncio.WindowsProactorEventLoopPolicy())
opus_path = asyncio.run(generate_voice())
print(opus_path)
EOF
)
上传文件

echo "📤 上传语音文件..."
UPLOAD_RESPONSE=$(curl -s -X POST "https://open.feishu.cn/open-apis/im/v1/files" \
  -H "Authorization: Bearer $TOKEN" \
  -F "file_type=opus" \
  -F "file=@$OPUS_FILE")
FILE_KEY=$(echo "$UPLOAD_RESPONSE" | jq -r '.data.file_key // empty')
if [ -z "$FILE_KEY" ] || [ "$FILE_KEY" = "null" ]; then
  echo "❌ 文件上传失败：$UPLOAD_RESPONSE"
  rm -f "$OPUS_FILE" "${OPUS_FILE%.opus}.mp3" 2>/dev/null
  exit 1
fi
发送消息

echo "📨 发送语音消息..."
SEND_RESPONSE=$(curl -s -X POST "https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=open_id" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"receive_id\":\"$CHAT_ID\",\"msg_type\":\"audio\",\"content\":\"{\\\"file_key\\\":\\\"$FILE_KEY\\\"}\"}")
结果判断

if echo "$SEND_RESPONSE" | jq -e '.code == 0' >/dev/null; then
  MSG_ID=$(echo "$SEND_RESPONSE" | jq -r '.data.message_id')
  echo "✅ 发送成功！消息ID：$MSG_ID"
else
  ERROR_MSG=$(echo "$SEND_RESPONSE" | jq -r '.msg // "未知错误"')
  ERROR_CODE=$(echo "$SEND_RESPONSE" | jq -r '.code // "未知码"')
  echo "❌ 发送失败 [$ERROR_CODE]：$ERROR_MSG"
  rm -f "$OPUS_FILE" "${OPUS_FILE%.opus}.mp3" 2>/dev/null
  exit 1
fi
清理临时文件

rm -f "$OPUS_FILE" "${OPUS_FILE%.opus}.mp3" 2>/dev/null
echo "🧹 清理临时文件完成"

4. 使用说明

#### （1）初始化配置 
# 首次运行会自动生成配置文件，编辑填写真实信息
vim ~/.config/feishu_voice_config.json

#### （2）环境变量临时覆盖（可选） 

# 临时使用不同的配置（优先级高于配置文件）
export FEISHU_APP_ID="临时APP_ID"
export FEISHU_APP_SECRET="临时SECRET"
export FEISHU_CHAT_ID="临时CHAT_ID"
执行脚本

bash send_voice_edge.sh "测试消息"

#### （3）常规使用 

# 基础版
bash send_voice.sh "早上好！"
Edge TTS版（自定义语音）

bash send_voice_edge.sh "床前明月光" "zh-CN-YunxiNeural"

5. 关键优化点

| 优化项 | 说明 | |-----------------------|----------------------------------------------------------------------| | 移除硬编码 | 所有敏感信息通过配置文件/环境变量管理，避免代码泄露 | | 配置优先级 | 环境变量 > 配置文件 > 默认值，灵活适配不同场景 | | 依赖检查 | 自动检查jq/ffmpeg/python/edge_tts等依赖，缺失时提示安装 | | 错误处理 | 每个步骤增加校验，失败时输出明确错误信息，避免静默失败 | | 配置模板自动生成 | 首次运行自动生成配置文件模板，降低使用门槛 | | 临时文件安全清理 | 任何失败场景都确保临时文件被清理，避免磁盘占用 | | 结构化输出 | 使用jq替代python单行解析JSON，更稳定、易读 |

6. 依赖安装

# Debian/Ubuntu
sudo apt update && sudo apt install -y jq ffmpeg python3 python3-pip
CentOS/RHEL

sudo yum install -y jq ffmpeg python3 python3-pip
macOS

brew install jq ffmpeg python3
安装Python依赖

pip3 install edge-tts