castle-x/baidu-speech-to-text
skills/baidu-speech-to-text/SKILL.md
百度语音识别 - 将语音消息转换为文本。支持中文普通话、英语、粤语、四川话。专为国内服务器环境优化，自动绕过代理访问百度 API。
$ install --global
skillsauthnpx skillsauth add castle-x/skills-x baidu-speech-to-textInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 22, 2026, 9:39 PM54.3s6 files scanned
SKILL.md
- name:
- baidu-speech-to-text
- description:
- 百度语音识别 - 将语音消息转换为文本。支持中文普通话、英语、粤语、四川话。专为国内服务器环境优化，自动绕过代理访问百度 API。
- description_en:
- Baidu Speech Recognition - Convert voice messages to text. Supports Mandarin, English, Cantonese, and Sichuan dialect. Optimized for China mainland servers with automatic proxy bypass for Baidu API.
- license:
- MIT
- author:
- x
- version:
- 1.0
百度语音识别 - 音频转文本
概述
本 skill 用于将用户发送的语音消息（ogg/opus 格式）转换为文本。使用百度语音识别 API，专为国内服务器 + 代理环境优化。
环境背景
问题场景
- 国内服务器通过
proxychains4代理访问海外服务（Discord、WhatsApp 等） - 但百度 API 是国内服务，通过代理访问反而会失败（SSL 错误）
- 需要在代理环境下选择性绕过百度 API
解决方案
- 使用 wrapper 脚本，通过
unset LD_PRELOAD绕过 proxychains 注入 - 脚本内部清除代理环境变量，确保直连百度 API
脚本文件
| 脚本 | 路径 | 用途 |
|------|------|------|
| ogg_to_text.sh | /root/.openclaw/workspace/scripts/ogg_to_text.sh | 推荐 - 简单易用 |
| speech_to_text.sh | /root/.openclaw/workspace/scripts/speech_to_text.sh | 完整功能版 |
| baidu_speech_to_text.py | /root/.openclaw/workspace/scripts/baidu_speech_to_text.py | Python 主脚本 |
使用方法
基本用法（中文普通话）
/root/.openclaw/workspace/scripts/ogg_to_text.sh <音频文件路径>
示例
# 转换用户语音消息
/root/.openclaw/workspace/scripts/ogg_to_text.sh /root/.openclaw/media/inbound/xxxxx.ogg
支持的语言
| 参数 | 语言 |
|------|------|
| --lang zh | 中文普通话（默认）|
| --lang en | 英语 |
| --lang cantonese | 粤语 |
| --lang sichuan | 四川话 |
使用极速版（更快，仅中文）
/root/.openclaw/workspace/scripts/speech_to_text.sh <音频文件> --pro
音频文件位置
用户通过 WhatsApp/Discord 发送的语音消息保存在：
/root/.openclaw/media/inbound/
文件格式通常为 .ogg（Opus 编码），脚本会自动转换为 PCM 格式。
工作流程
当用户发送语音消息并请求转文本时：
- 确定语音文件路径（
/root/.openclaw/media/inbound/*.ogg） - 执行转换：
/root/.openclaw/workspace/scripts/ogg_to_text.sh /root/.openclaw/media/inbound/<文件名>.ogg - 返回识别结果给用户
性能参考
| 阶段 | 耗时 | 说明 | |------|------|------| | 获取 token | ~100ms | 可缓存优化 | | ogg 转 pcm | ~150-220ms | ffmpeg 转换 | | API 调用 | ~400-600ms | 主要耗时 | | 总计 | ~700-1000ms | |
API 配置
使用环境变量提供百度 API 账号信息（请勿写入仓库）：
export BAIDU_APP_ID="your_app_id"
export BAIDU_API_KEY="your_api_key"
export BAIDU_SECRET_KEY="your_secret_key"
端点：
- http://vop.baidu.com/server_api (标准版)
- https://vop.baidu.com/pro_api (极速版)
错误处理
| 错误 | 原因 | 解决方案 | |------|------|---------| | SSL 错误 | 代理影响 | 确保使用 wrapper 脚本（.sh），不要直接调用 Python | | 识别结果为空 | 静音或无语音 | 告知用户音频可能没有语音内容 | | 3301 错误 | 音频质量差 | 请用户重新录制 | | 3303 错误 | 语音过长 | 需要分段处理 |
注意事项
- 必须使用 shell wrapper 脚本，不要直接调用 Python 脚本
- 脚本已内置代理绕过逻辑，在 proxychains 环境下可正常工作
- 短语音识别限制约 60 秒，超长音频需分段
Related Skills
castle-x/tui-design
tools
VerifiedTrustedCommunity
Design specification for CLI TUI (Terminal User Interface). This skill provides comprehensive guidelines for implementing interactive terminal UI components, including page layout structure, color schemes, keyboard navigation, and multi-level navigation principles.
18SKILL.mdUpdated Apr 22, 2026
castle-x/skills-x
documentation
VerifiedTrustedCommunity
Guide for contributing new skills to the skills-x collection. This skill should be used when users want to add new open-source skills from external sources (like agentskills.io or anthropics/skills) to the skills-x repository. It covers the complete workflow from discovery to publishing.
18SKILL.mdUpdated Apr 22, 2026
castle-x/minimal-ui-design
tools
VerifiedTrustedCommunity
Use when designing or refining UIs that must be visually minimal, low-noise, and icon-forward while staying understandable for new users, especially when reducing text, consolidating controls, or streamlining dialogs, toolbars, search panels, or list results.
18SKILL.mdUpdated Apr 22, 2026
castle-x/go-pocketbase-integration
development
VerifiedTrustedCommunity
Integrate PocketBase as a Go library using the github.com/castle-x/goutils/pocketbase (gopb) package to build single-binary full-stack applications. Use when building Go applications that need user authentication, embedding PocketBase into Go binary, registering custom API routes, managing default users, serving embedded SPA frontend, or deploying single-binary applications. NOT for using PocketBase as a standalone separate process.
18SKILL.mdUpdated Apr 22, 2026