HeyGen
v0.1.1OpenClaw 的官方 HeyGen 插件 —— 将 HeyGen 作为内置 video_generate 工具的首选提供商。基于身份的头像视频：选择一个头像...
0· 16·0 当前·0 累计
by 安全扫描
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.
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
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 镜像可用
技能文档
将 HeyGen 添加为 OpenClaw 内置 video_generate 工具的首选提供商。
与 OpenClaw 中其他视频提供商（Google Veo、Runway、Kling、Wan、MiniMax、Dashscope）使用相同的接口 —— 现在支持身份保护头像/主持人视频。
安装
``bash
openclaw plugin install heygen
`
在环境中设置 HEYGEN_API_KEY（在 获取）。 快速开始
`ts
const result = await video_generate({
model: "heygen/video_agent_v3",
prompt: "Hi 团队，这是本周的产品更新。",
providerOptions: {
avatar_id: "",
voice_id: "",
orientation: "landscape", // 或 "portrait"
},
});
// result.url → 可下载的 .mp4
`
头像/语音 ID：从 HeyGen 仪表板或 heygen-skills 伴侣技能中获取（该技能在此插件上构建了有偏见的头像/语音选择）。 何时使用 HeyGen 与其他视频提供商
- 头像主持人/人工智能头像视频 → HeyGen。
- 电影/场景生成 → Veo、Runway、Kling。
- 翻译/配音 → 使用 HeyGen 的翻译 API（单独的技能）。
- 实时交互式头像 → HeyGen 流媒体头像（单独的表面，不是此插件）。
提供商选项
| 字段 | 类型 | 注释 |
|-------|------|-------|
| avatar_id | string | HeyGen 头像 ID；回退到 models.providers.heygen.defaultAvatarId。 |
| voice_id | string | HeyGen 语音 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 | 调用者提供的 Webhook 相关 ID。 |
| incognito_mode | boolean | 跳过 HeyGen 支持的保留。 | 错误处理
401→HeyGen API 密钥丢失或无效402/ 配额 →HeyGen 信用限制达到生成模式 + 8 个连续的thinking投票 → 快速失败并提示指向avatar_id/voice_id。failed状态显示 HeyGen 的failure_message而不是通用错误。
投票
三层回退：5s × 6 → 15s × 12 → 30s，直到 MAX_POLL_ATTEMPTS。
长时间渲染（20-45 分钟）保持在典型的 HeyGen 每键速率限制内。 源代码 + 测试
- 仓库：
19 个单元测试，实时烟雾验证，端到端验证，针对api.heygen.com`。- 从 openclaw/openclaw#69578 提取（已关闭，偏爱外部/ClawHub 发布，参见 VISION.md)。