首页 / 技能 / HeyGen

📦 HeyGen

v0.1.1

官方 HeyGen 插件 for OpenClaw——将 HeyGen 作为内置 video_generate 工具的一流提供商。身份优先的 avatar 视频：挑选一个 avatar…

0· 16·0 当前·0 累计
eve-builds 头像by @eve-builds (Eve)·MIT.
开发工具视频处理系统工具设计工具操作系统
下载技能包
License
MIT.
最后更新
2026/4/26
0
安全扫描
VirusTotal
无害
查看报告
OpenClaw
安全
high confidence
插件的代码、说明以及所请求的环境变量（HEYGEN_API_KEY）均与其声明的“将 HeyGen Video Agent 集成到 OpenClaw”的目标一致；整个包中未发现索取无关凭据或隐藏端点的内容。
评估建议
This plugin appears to be what it claims: a HeyGen video provider that needs only your HEYGEN_API_KEY. Before installing: (1) verify the repository origin/commit on the listed homepage (https://github.com/heygen-com/openclaw-plugin-heygen) to ensure the package-lock.json was not tampered with; (2) prefer providing HEYGEN_API_KEY with least privilege and rotate keys if possible; (3) be cautious with callback_url values you pass (they cause HeyGen/OpenClaw to POST to your URL); (4) if you run npm ...
详细分析 ▾
✓ 用途与能力
Name/description, SKILL.md, openclaw.plugin.json, and the TypeScript provider implementation consistently implement a HeyGen video provider. The only required environment variable is HEYGEN_API_KEY and the code makes requests to api.heygen.com and related HeyGen file URLs — all expected for this provider.
✓ 指令范围
SKILL.md and README instruct the agent to call OpenClaw's video_generate API with HeyGen-specific providerOptions (avatar_id, voice_id, etc.) and to set HEYGEN_API_KEY. The runtime instructions do not ask the agent to read unrelated files or environment variables, nor do they instruct exfiltration to unexpected endpoints. Note: the plugin supports passing callback_url (webhook) which will cause HeyGen/OpenClaw to call an external URL supplied by the caller — callers should only use trusted webhook endpoints.
ℹ 安装机制
This is primarily an instruction-only plugin with TypeScript source included and no explicit install spec. That is low risk. One small anomaly: the included package-lock.json contains a large dependency tree (many AWS/@smithy and other packages) not referenced in package.json dependencies. While this doesn't change runtime behavior of the provider code shown, users should confirm the provenance of the lockfile and that your install process will not unexpectedly fetch or install unrelated packages.
✓ 凭证需求
Only HEYGEN_API_KEY is required and declared as primary credential; the code uses it for X-Api-Key to call HeyGen APIs. No other SECRET/TOKEN/PASSWORD env vars are requested or accessed in the SKILL.md or the visible code.
✓ 持久化与权限
The skill does not request 'always: true' and does not attempt to modify other skills or system-wide settings. It registers itself as a video provider in the normal plugin fashion. Autonomous invocation is allowed but this is the platform default and appropriate for a provider plugin.
安全有层次，运行前请审查代码。

License

MIT.

请查看许可证条款了解详情。

运行时依赖

无特殊依赖

版本

latestv0.1.12026/4/26

- 将 HeyGen 添加为 OpenClaw 的一流视频生成提供商。 - 使用 HeyGen Video Agent v3 支持身份保留的虚拟形象/演示者视频。 - 与标准 OpenClaw video_generate 工具接口完全集成。 - 提供清晰的错误处理和详细的视频生成工作流选项。 - 包含 19 个单元测试，并已完成端到端冒烟测试。

● 无害

安装命令

点击复制
官方npx clawhub@latest install openclaw-plugin-heygen
镜像加速npx clawhub@latest install openclaw-plugin-heygen --registry https://cn.longxiaskill.com

技能文档

----|------|-------| | avatar_id | string | HeyGen avatar id；留空则取 models.providers.heygen.defaultAvatarId。 | | voice_id | string | HeyGen voice id；留空则取 models.providers.heygen.defaultVoiceId。 | | style_id | string | 可选风格模板。 | | orientation | "landscape" \| "portrait" | 由比例映射，拒绝 1:1。 | | mode | "generate" \| "chat" | 默认 generate，chat 保留完整轮询预算用于交互流。 | | callback_url | string | 异步 webhook 完成通知。 | | callback_id | string | 调用方关联 id，用于 webhook 回传。 | | incognito_mode | boolean | 支持时在 HeyGen 端跳过留存。 |

错误清晰提示

  • 401 → HeyGen API key 缺失或无效
  • 402 / 配额 → HeyGen 额度已用完
  • Generate 模式连续 8 次 thinking 轮询 → 快速失败，并提示检查 avatar_id / voice_id。
  • failed 状态直接透出 HeyGen 的 failure_message，而非通用错误。

轮询策略

三级退避：5s × 6 → 15s × 12 → 30s，直到 MAX_POLL_ATTEMPTS。 长渲染（20–45 分钟）保持在 HeyGen 单 key 速率限制内。

源码与测试

  • 仓库：
  • 19 个单元测试，已针对 api.heygen.com 做端到端冒烟验证。
  • 提取自 openclaw/openclaw#69578（已关闭，改为外部/ClawHub 发布，见 VISION.md）。

许可证

MIT，详见 LICENSE。

数据来源：ClawHub ↗ · 中文优化：龙虾技能库