← 返回 Skills 市场
165
总下载
1
收藏
0
当前安装
8
版本数
在 OpenClaw 中安装
/install volcengine-tts-feishu
功能描述
火山引擎豆包语音合成模型2.0 TTS。支持多种音色、情感参数、SSML标记,生成高质量中文语音,支持一键发送飞书语音气泡。使用HTTP单向流式API,稳定可靠。
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install volcengine-tts-feishu - 安装完成后,直接呼叫该 Skill 的名称或使用
/volcengine-tts-feishu触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
常见问题
volcengine-tts-feishu 是什么?
火山引擎豆包语音合成模型2.0 TTS。支持多种音色、情感参数、SSML标记,生成高质量中文语音,支持一键发送飞书语音气泡。使用HTTP单向流式API,稳定可靠。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 165 次。
如何安装 volcengine-tts-feishu?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install volcengine-tts-feishu」即可一键安装,无需额外配置。
volcengine-tts-feishu 是免费的吗?
是的,volcengine-tts-feishu 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
volcengine-tts-feishu 支持哪些平台?
volcengine-tts-feishu 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 volcengine-tts-feishu?
由 xRay(@raydoomed)开发并维护,当前版本 v1.0.7。
推荐 Skills