Openclaw Feishu Optimizer

提供语音识别、多语言支持及消息格式化，优化 OpenClaw 在飞书平台上的语音与文本消息处理和智能回复体验。

Security Scan

The skill's code, instructions, and dependencies are consistent with its stated purpose (speech-to-text and message formatting for Feishu); it does not request extra credentials or hidden installs, but it does send audio to Google's speech recognition service and requires installing third‑party Python packages.

Purpose & Capability

Name/description (voice recognition, multi-language, message formatting) match the provided files and instructions. Declared dependencies (SpeechRecognition, pydub) and Python usage are appropriate and proportionate for the stated functionality. No unrelated credentials, binaries, or config paths are requested.

Instruction Scope

SKILL.md instructs installing SpeechRecognition and pydub and running the included Python scripts (absolute workspace paths). The runtime code only reads the audio file or message data supplied as the script argument and formats the recognized text. Important privacy note: the code uses speech_recognition.recognize_google(), which transmits audio data to Google's web API (the SKILL.md mentions network access for Google SR in troubleshooting but does not explicitly describe external transmission or retention).

Install Mechanism

There is no registry install spec; SKILL.md recommends pip3 install of well-known packages from PyPI (SpeechRecognition, pydub). This is a common, expected approach (moderate risk typical of pip installs); no downloads from unknown URLs or archive extraction are present.

Credentials

The skill declares no required environment variables, no credentials, and no config paths. That is proportionate. The only external dependency is the Google Speech Recognition web service (no API key used), so the main non-local exposure is network transmission of audio to Google.

Persistence & Privilege

The skill does not request always:true, does not modify other skills or system settings, and is instruction-only with two local Python modules. It runs only when invoked and does not request elevated or persistent privileges.

Assessment

This skill appears to do what it says: convert audio to text and format replies. Before installing: (1) be aware audio is sent to Google's speech recognition service (network transmission of content — avoid sending sensitive audio), (2) install the Python packages in an isolated virtualenv rather than system-wide, (3) review the two Python files (they are short and readable) and avoid running the scripts on untrusted audio paths, (4) if you need an offline-only option for privacy, consider replacing the recognizer with an offline engine (e.g., VOSK) or request a version that supports local models, and (5) pin package versions and run in a sandboxed environment if you have elevated security concerns.

OpenClaw 飞书体验优化者

专为 OpenClaw 在飞书平台上优化体验的技能包，提供语音识别、消息格式化、智能回复等增强功能。

功能特性

1. 语音识别处理

• 自动语音识别：收到语音消息时自动识别为文字
• 多语言支持：支持中文、英文等多种语言识别
• 格式自动转换：自动处理各种音频格式（MP3、WAV、FLAC、OGG等）

2. 消息优化

• 智能回复格式化：优化回复内容的排版
• 表情识别：理解并回应表情符号
• 上下文感知：根据对话上下文提供更合适的回复

3. 飞书平台优化

• 消息类型支持：处理文字、语音、图片、文件等各种消息类型
• 响应时间优化：提升消息处理和回复速度
• 错误处理：优雅处理各种异常情况

依赖安装

pip3 install SpeechRecognition pydub

使用方法

识别语音消息

# 识别中文语音
python3 /root/.openclaw/workspace/skills/openclaw-feishu-optimizer/voice-recognize.py <音频文件路径> --language zh-CN

# 识别英文语音
python3 /root/.openclaw/workspace/skills/openclaw-feishu-optimizer/voice-recognize.py <音频文件路径> --language en-US

自动处理飞书消息

# 处理飞书消息的完整流程
python3 /root/.openclaw/workspace/skills/openclaw-feishu-optimizer/process-message.py <消息数据>

配置文件

技能配置

{
  "name": "openclaw-feishu-optimizer",
  "version": "1.0.0",
  "description": "OpenClaw 飞书体验优化者",
  "author": "黄绍帅（黄白）",
  "language": "zh-CN",
  "auto_recognize_voice": true,
  "auto_format_response": true,
  "voice_recognition": {
    "provider": "google",
    "default_language": "zh-CN"
  },
  "message_formatting": {
    "enable_emoji": true,
    "enable_markdown": true,
    "enable_mention": true
  }
}

工作流程

处理语音消息

1. 检测到语音消息
2. 自动调用语音识别服务
3. 将识别结果转换为文字
4. 格式化回复内容
5. 发送优化后的回复

处理文字消息

1. 解析消息内容
2. 识别关键词和需求
3. 格式化回复
4. 添加表情和优化排版
5. 发送智能回复

故障排除

语音识别失败

1. 检查网络连接（Google Speech Recognition 需要联网）
2. 检查音频文件是否损坏
3. 尝试指定语言参数 --language zh-CN
4. 检查音频质量（确保音量适中、无明显噪音）

依赖安装失败

# 检查 pip 是否正常工作
pip3 --version

# 尝试使用国内源安装
pip3 install SpeechRecognition pydub -i https://pypi.tuna.tsinghua.edu.cn/simple

贡献与改进

欢迎提出改进意见和功能建议！你可以：

1. 报告问题和 bug
2. 建议新功能
3. 提交代码改进
4. 完善文档

许可证

本技能包遵循 OpenClaw 技能协议，仅供学习和个人使用。