保利威直播 Skill 使用說明
保利威直播 Skill 用於在支援 OpenClaw Skill 的 AI 工具中呼叫保利威直播 CLI 能力，輔助完成直播頻道、推流、回放、文件、互動、統計等直播管理操作。適用於需要透過命令列或 AI 助手批次處理直播設定、查詢直播資料、管理直播資源的場景。
一、功能概覽
| 功能資訊 | 說明 |
|---|---|
| 功能名稱 | 保利威直播 Skill |
| 適用對象 | 需要使用 AI 助手或命令列管理保利威直播資源的營運人員、技術人員 |
| 主要能力 | 支援帳號認證、頻道管理、推流管理、回放管理、直播文件、商品與優惠券、互動玩法、觀看條件、統計匯出等操作 |
| 使用場景 | 批次建立或查詢頻道、取得推流資訊、檢查直播狀態、管理回放檔案、匯出直播統計資料、設定互動與觀看條件 |
二、使用前準備
使用前需準備以下資訊：
- 已開通保利威雲直播服務的帳號。
- 可存取直播後台的管理權限。
- 帳號對應的
AppID和AppSecret。 - 本地或 AI 工具執行環境已支援 OpenClaw Skill。
可在雲直播後台的 设置 > 开发者信息 中查看開發者認證資訊。
AppSecret 屬於敏感憑據，請勿在公開頁面、前端程式碼、聊天截圖或不可信環境中明文儲存。
三、安裝 Skill
在支援 OpenClaw CLI 的環境中執行以下指令安裝：
openclaw skills install polyv-live-cli
安裝完成後，可透過保利威直播 CLI 設定帳號認證，並將常用帳號設定為預設帳號。
四、設定帳號認證
首次使用前，建議先檢查目前是否已設定帳號：
npx polyv-live-cli@latest account list
如未設定帳號，可新增帳號憑據並設定預設帳號：
npx polyv-live-cli@latest account add <账号名称> --app-id <AppID> --app-secret <AppSecret>
npx polyv-live-cli@latest account set-default <账号名称>
設定完成後，可透過查詢頻道列表驗證認證是否生效：
npx polyv-live-cli@latest channel list
五、常用能力
1. 頻道管理
支援建立頻道、查詢頻道列表、查看頻道詳情、修改頻道資訊、刪除頻道和批次刪除頻道。適用於活動初始化、頻道巡檢和批次維護等場景。
2. 推流管理
支援取得推流地址與推流金鑰、開始直播、結束直播、查看直播狀態、推送影片檔案、直播品質驗證和即時監控。適用於開播前檢查、開播中監控和異常排查。
3. 回放與錄製管理
支援查詢回放列表、查看回放詳情、刪除回放、合併回放檔案、查看和設定錄製規則、轉存錄製檔案。適用於直播結束後的回放整理和影片歸檔。
4. 文件與播放器設定
支援查詢直播文件、上傳文件、刪除文件、查看文件轉換狀態，以及查詢和更新播放器設定。適用於三分屏直播、課件直播和觀看頁播放體驗設定。
5. 行銷與互動管理
支援商品、優惠券、聊天訊息、禁言踢人、簽到、問答、問卷、抽獎、打賞、卡片推送等互動能力。適用於電商直播、培訓直播、活動營運等場景。
6. 數據統計
支援查詢觀看統計、歷史並發、最高並發、觀眾裝置與地區分佈，並可匯出統計資料。適用於直播復盤、營運分析和數據交付。
六、使用建議
- 執行新增、刪除、更新類操作前，先確認目標頻道 ID、資源 ID 和帳號環境。
- 涉及刪除、清空、禁言、踢人等操作時，建議先查詢目前設定或列表，再執行變更。
- 多帳號使用時，建議為每個帳號設定清晰的帳號名稱，避免誤操作。
- 需要交付資料時，可優先使用統計匯出能力，減少手工整理成本。
- 涉及 AppSecret 的指令和日誌，不建議截圖外發或提交到程式碼倉庫。
七、常見問題
1. Skill 安裝後無法查詢頻道怎麼辦？
先確認帳號認證是否已設定，並檢查 AppID、AppSecret 是否正確。如帳號已設定，建議重新設定預設帳號後再查詢頻道列表。
2. 能否同時管理多個直播帳號？
可以。可新增多個帳號，並在執行指令時切換目前帳號或指定帳號。多帳號場景下，建議先確認目前預設帳號，避免操作到錯誤帳號。
3. 是否可以用它直接開播或結束直播？
可以透過推流相關指令管理直播狀態。正式操作前，建議先確認頻道 ID、推流設定和直播狀態，避免影響正在進行的直播。
4. 適合哪些團隊使用？
適合需要頻繁管理直播頻道、查詢資料、設定互動能力或批次處理直播資源的營運團隊和技術團隊。
