← Back to Skills Marketplace
165
Downloads
1
Stars
0
Active Installs
8
Versions
Install in OpenClaw
/install volcengine-tts-feishu
Description
火山引擎豆包语音合成模型2.0 TTS。支持多种音色、情感参数、SSML标记,生成高质量中文语音,支持一键发送飞书语音气泡。使用HTTP单向流式API,稳定可靠。
Usage Guidance
This skill's code implements Volcengine TTS and sending to Feishu and appears to be functional, but there are important inconsistencies you should address before installing or running it:
- Credentials: The script requires your Volcengine AppID and Access Token (per-skill config ~/.openclaw/workspace/skills/volcengine-tts-feishu/config.json) and will automatically read ~/.openclaw/openclaw.json to obtain Feishu appId/appSecret. Those credentials are sensitive — confirm you trust the skill source before providing them. The registry metadata did not declare these requirements, so the omission is a red flag.
- Config scope: Because the script reads ~/.openclaw/openclaw.json, it has access to whatever is stored there; inspect that file first and remove or rotate any secrets you do not want the skill to access. Prefer creating a per-skill config with only the needed values.
- Dependencies: requirements.txt is incorrect (it lists websockets but the script uses requests). Before running, create and activate a virtualenv and pip-install requests and any other dependencies (pip install requests). Ensure ffmpeg and curl are available if you plan to use --send-to.
- Run safely: Run the script in an isolated environment (container or VM) or with non-privileged test accounts to confirm behavior. Review the code yourself — it posts audio to Volcengine and Feishu endpoints and uses subprocesses; while that matches the stated function, it's best to audit and optionally modify the script to avoid automatic reading of ~/.openclaw/openclaw.json (or to prompt before using it).
- Source provenance: The skill has unknown source and no homepage. If you need stronger assurance, request the author/publisher to declare the required config paths/env vars in the registry metadata and to fix the requirements.txt mismatch.
Capability Analysis
Type: OpenClaw Skill
Name: volcengine-tts-feishu
Version: 1.0.7
The skill performs Text-to-Speech synthesis and sends audio to Feishu, but exhibits several high-risk behaviors and vulnerabilities. Specifically, scripts/http_tts.py reads sensitive credentials from the global ~/.openclaw/openclaw.json file and uses subprocess.run to execute curl and ffmpeg, which are high-risk capabilities. The script is also vulnerable to path traversal as it writes to a user-provided --output path without sanitization. Furthermore, there is a discrepancy in requirements.txt, which lists 'websockets' (unused) while omitting the 'requests' library required by the script, and the use of both urllib and requests for API calls to Volcengine and Feishu is inconsistent.
Capability Assessment
Purpose & Capability
The code and SKILL.md implement Volcengine TTS and optional Feishu sending, matching the name/description. However the registry metadata declares 'no required config paths / env vars', while the script and SKILL.md expect a per-skill config (~/.openclaw/workspace/skills/volcengine-tts-feishu/config.json) and also read ~/.openclaw/openclaw.json to obtain Feishu appId/appSecret. That credential access is reasonable for the stated purpose but is not declared in metadata — an inconsistency users should notice. Also requirements.txt lists websockets but the script uses requests (requests is not listed).
Instruction Scope
SKILL.md and scripts instruct the agent/user to create and read ~/.openclaw/workspace/skills/volcengine-tts-feishu/config.json (Volcengine creds) and to automatically read ~/.openclaw/openclaw.json for Feishu credentials. The script reads those files without asking for explicit env vars, and it invokes external network endpoints (Volcengine and Feishu) and subprocesses (ffmpeg and curl). Reading the global ~/.openclaw/openclaw.json means the skill will access whatever is stored there (potentially other tokens); the instructions say it will use only the Feishu channel, but automatic reading of a central config is broader than a per-skill-only config and should be noted.
Install Mechanism
No install spec (instruction-only) which reduces installer risk. The files included are plain Python and a requirements.txt. However requirements.txt lists 'websockets>=12.0' while the script imports and uses 'requests' (not listed), so dependency instructions are incorrect and will confuse users installing dependencies.
Credentials
The skill needs Volcengine credentials (AppID and Access Token) and Feishu appId/appSecret to operate. Those are proportionate to the stated function (TTS + sending in Feishu) but the registry metadata declared no required env vars/configs. The script accesses ~/.openclaw/openclaw.json (which may contain other channel credentials) — the code uses only channels.feishu but reading that central file gives the skill access to other stored configuration if present. Users should be aware sensitive secrets are read from disk.
Persistence & Privilege
The skill is not always-enabled and does not request any special platform privilege. It does not modify other skills or system-wide settings. It does read the user's OpenClaw config file(s) and writes temporary files during operation, which is expected for this functionality.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install volcengine-tts-feishu - After installation, invoke the skill by name or use
/volcengine-tts-feishu - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.7
- 更新断句与停顿最佳实践说明,明确“…”仅用于大喘气/换气,完整语义不拆分
- 优化断句总结,强调逗号“,”用于句内短停顿,过度拆分会导致语音不自然
- 精简和强化断句用法示例,去除冗余,突出最终推荐规则
- 其余功能和用法未更动,依然支持多音色、情感、SSML,飞书气泡一键发送
v1.0.6
volcengine-tts-feishu 1.0.6
- 更新和细化了断句、停顿的规则说明,强调需自然连贯,仅在大喘气时使用省略号,补充错误/正确语句示例
- 新增 `--emotion-scale` 参数说明,支持自定义情感强度(范围1~5,默认4)
- 优化“使用经验”与最佳实践部分描述,提高普通用户易读性和实操指导
- 其他文档表述更规范,参数使用细节更清晰
v1.0.5
- 增强文档关于文本断句和停顿的最佳实践,明确省略号和换行使用方式,提升语音自然度。
- 补充错误断句示例,对比展示合理的气口控制和连贯自然朗读。
- 不涉及功能/代码变更,仅优化和细化了使用说明部分。
v1.0.4
- A typo has been fixed: an extra "zhich" appears below the sentiment parameter table.
v1.0.3
volcengine-tts-feishu 1.0.3
- 修改文档默认情感参数为 excited,并将其高亮为默认项
- 精简和明确情感参数表,调整使用建议(省略号断句建议优化,删除"vocal-fry自动降速"等细节说明)
- 保留所有功能与使用方式不变,仅优化和修正文档内容
- 无代码更改
v1.0.2
- Updated usage instructions: When sending Feishu audio, the MP3 file is now handled in the system temporary directory and auto-cleaned after sending—no leftover files in the skill directory.
- Clarified: The --output parameter is only needed for file export, not for Feishu sending (auto-managed).
- Usage tips now emphasize using ellipses "..." for pausing, with dynamic pause lengths based on the number of dots.
- Documentation revisions improve clarity around parameter requirements and file management for both main usage modes.
v1.0.1
Version 1.0.1 of volcengine-tts-feishu
- Fix: Auto configuration loading issue.
- No breaking changes.
v1.0.0
volcengine-tts-feishu 1.0.0 – Initial release
- Provides CLI access to 火山引擎豆包语音合成 (TTS) 2.0 with emotion, timbre control, and SSML support.
- Seamlessly integrates with Feishu; synthesized speech can be sent as voice messages with one command.
- Requires configuration of 火山引擎 credentials; Feishu credentials are read automatically if already set up in OpenClaw.
- Supports MP3 output and Feishu voice message workflows (MP3 ➔ Opus ➔ upload ➔ send).
- Includes detailed setup, usage, and parameter documentation for users.
Metadata
Frequently Asked Questions
What is volcengine-tts-feishu?
火山引擎豆包语音合成模型2.0 TTS。支持多种音色、情感参数、SSML标记,生成高质量中文语音,支持一键发送飞书语音气泡。使用HTTP单向流式API,稳定可靠。 It is an AI Agent Skill for Claude Code / OpenClaw, with 165 downloads so far.
How do I install volcengine-tts-feishu?
Run "/install volcengine-tts-feishu" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is volcengine-tts-feishu free?
Yes, volcengine-tts-feishu is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does volcengine-tts-feishu support?
volcengine-tts-feishu is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created volcengine-tts-feishu?
It is built and maintained by xRay (@raydoomed); the current version is v1.0.7.
More Skills