前言¶
要在對話式 Agent 裏出一段短視頻，常見做法是單獨開腳本、自己對接雲廠商 API、再輪詢異步任務狀態。步驟多、和日常「讓 AI 直接幹活」的流程也不一致。下面介紹 SkillHub 上的 視頻生成（座標 @user_cb5e2841/openclaw-v3）：把火山引擎 SD1.5pro 的視頻能力封裝成 Skill，由 Agent 按說明調用，支持文本到視頻、圖生視頻，並以異步任務方式處理。
這是什麼¶
視頻生成 是社區來源（community）的 Agent Skill，當前版本 1.0.0，發佈者爲 user_cb5e2841，在 SkillHub 中歸類爲 design-media。Skill 頁說明：使用 火山引擎 SD1.5pro API 生成視頻，支持 文本到視頻 與 圖生視頻，任務爲 異步處理。標籤 requires_api_key=true 表示使用前需準備火山引擎相關 API 密鑰，具體變量名與請求字段以安裝後的 Skill 文檔爲準，本文不臆造配置項。
官方入口：
- SkillHub 頁面：https://www.skillhub.cn/skills/user_cb5e2841/openclaw-v3
- API 地址（資料中的官方鏈接）：https://api.skillhub.cn/user_cb5e2841/openclaw-v3
核心功能¶
依據 SkillHub 已公開說明，可覈實的能力如下：
- 文本到視頻：根據自然語言描述發起視頻生成。
- 圖生視頻：以圖像爲輸入，配合提示或參數生成動態視頻（細節以 Skill 內說明爲準）。
- 異步任務：生成走異步流程，適合耗時較長的雲端渲染，Agent 側需按 Skill 指引查詢或等待任務結果。
底層統一對接 火山引擎 SD1.5pro 視頻 API，無需在對話外單獨維護一套自寫 HTTP 客戶端，前提是已具備合法 API Key 與對應產品權限。
安裝與啓用¶
安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 CLI：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 官方安裝文檔執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安裝本 Skill¶
安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認會裝到 ./skills/，Agent 可能無法識別。
skillhub install user_cb5e2841/openclaw-v3 --dir <skills 目錄>
也可將下面提示詞發給支持 Skill 的 AI，由其按官方安裝說明操作：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_cb5e2841/openclaw-v3`。
各客戶端 skills 目錄（節選）¶
SkillHub 文檔中給出的常見路徑如下，請按實際環境選擇：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
安裝完成後，按所用客戶端要求重啓或重新加載 Agent，並在 Skill 要求的位置配置 火山引擎 API Key（requires_api_key=true）。
典型用法¶
公開資料未給出逐步命令行示例；可復現的用法模式如下：
- 完成安裝與 API Key 配置後，在對話中說明需求，例如「根據這段文案生成一段短視頻」或「用這張參考圖做圖生視頻」。
- Agent 加載 視頻生成 Skill 後，會按 Skill 內流程調用火山引擎 SD1.5pro：創建異步任務、必要時輪詢或等待完成，並返回結果鏈接或文件信息（以 Skill 實際輸出爲準）。
- 圖生視頻場景需準備好可被 Skill 接受的圖像輸入方式（本地路徑、URL 等，以 Skill 文檔爲準）。
若需確認參數與錯誤碼，應在安裝後閱讀該 Skill 包內的說明文件，或查閱火山引擎 SD1.5pro 官方 API 文檔。
適用場景與注意¶
適合誰
- 已在用 Cursor、Claude Code、Codex 等支持 Skill 的環境，希望把「出片」留在同一對話裏完成。
- 已有或可申請火山引擎視頻生成 API，能接受異步任務與按量計費。
限制與注意
- 依賴 API Key：無密鑰或權限不足時 Skill 無法正常工作。
- 異步時延：視頻渲染非即時返回，需預留等待或輪詢時間。
- 社區 Skill：來源爲 community，行爲與維護節奏以發佈者與 SkillHub 頁面爲準；升級可用
skillhub install覆蓋安裝到同一--dir。 - 數據口徑：SkillHub 頁面統計（抓取時）：評分 100000，下載 67484，安裝 1041；與第三方摘要中的數字可能不一致，以 SkillHub 爲準。
結尾¶
視頻生成 把火山引擎 SD1.5pro 的文生視頻、圖生視頻和異步任務封裝進 Agent Skill，減少自建對接成本。安裝座標爲 @user_cb5e2841/openclaw-v3，說明與安裝入口見 SkillHub：https://www.skillhub.cn/skills/user_cb5e2841/openclaw-v3 。
