前言¶
运营或技术同学日常要在保利威后台查频道、取推流地址、整理回放、导出观看数据。页面点选适合单次操作，批量巡检、脚本化交付或让助手代劳时，往往要在控制台和开放 API 之间来回切换。保利威直播 Skill 把官方 npm 包 polyv-live-cli 封装成 Agent 可调用的能力，在对话或命令行里完成同一套直播管理动作。
这是什么¶
保利威直播是保利威官方维护的 Agent Skill，底层通过 npm 发布的 polyv-live-cli 对接保利威云直播服务。Skill 侧负责引导 AI 按发布版 CLI 的 --help 执行命令；业务侧覆盖频道与推流、商品与优惠券、回放与文档、场次与互动（聊天、签到、问答、问卷、抽奖、打赏等）、观众与观看条件、白名单、平台与播放器设置、卡片推送、推广渠道、转播频道、AI 数字人、监控面板、场景初始化与直播统计等能力（与 SkillHub 条目描述一致）。
在 SkillHub 上该 Skill 归类为 business-ops，下载约 409 次，评分约 99557（平台展示数据，以页面为准）。
核心功能¶
以下能力与保利威帮助中心《保利威直播 Skill 使用说明》及 GitHub 仓库 polyv/polyv-live-cli 文档一致，按模块归纳。
账号与认证¶
- 添加、列出、切换多账号，设置默认账号。
- 执行前可校验账号状态；
AppID、AppSecret来自云直播后台「设置 > 开发者信息」。
频道与推流¶
- 频道：创建、列表、详情、更新、删除及批量删除。
- 推流：推流地址与密钥、开播/停播、直播状态、推视频文件、质量校验与实时监控。
回放、文档与播放器¶
- 回放：列表、详情、删除、合并、录制规则、转存。
- 文档：查询、上传、删除、转换状态。
- 播放器与观看页相关配置（仓库文档中的
player、web等命令族）。
营销与互动¶
- 商品、优惠券、聊天与禁言踢人、签到、问答、问卷、抽奖、打赏、卡片推送等。
观众、观看条件与运营配置¶
- 观众查询、观看鉴权、白名单；平台设置、推广渠道、转播频道、AI 数字人、监控面板、场景初始化（如电商场景
setup，可先--dry-run）及统计导出。
CLI 设计强调 Agent-First：结构化输出（含 JSON）、较完整的命令帮助与错误提示，便于程序化处理。
安装与启用¶
环境需已开通保利威云直播，并具备后台管理权限；本地需 Node.js 与 npm，以便通过 npx 调用 CLI。
OpenClaw¶
保利威帮助中心给出的安装方式为：
openclaw skills install polyv-live-cli
适用于支持 OpenClaw Skill 的 AI 工具（帮助文档中的表述）。
兼容 Skill 协议的 Agent（如 Claude Code）¶
GitHub 官方仓库给出的 Skill 安装方式为：
npx skills add polyv/polyv-live-cli
说明中写明支持 Claude Code、OpenClaw 等兼容 Skill 协议的 Agent。
SkillHub¶
SkillHub 技能页（polyv-live）提示可让 AI 按 SkillHub 安装说明 安装技能名 polyv-live。官方条目地址：https://api.skillhub.cn/u_4f4f94ce/polyv-live。
账号配置（通用）¶
无论通过哪种方式启用 Skill，首次使用建议先配置 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 <账号名称>
GitHub 快速开始中 --user-id 为可选参数示例；以当前 npm latest 的 account add --help 为准。
验证认证是否生效：
npx polyv-live-cli@latest channel list
典型用法¶
下面示例来自保利威帮助中心与 GitHub 仓库，命令前缀统一为 npx polyv-live-cli@latest（或 npx --yes polyv-live-cli@latest）。
创建频道并准备开播：
npx polyv-live-cli@latest channel create -n "新品发布会"
npx polyv-live-cli@latest stream get-key -c <channelId>
npx polyv-live-cli@latest stream status -c <channelId>
查看区间观看统计：
npx polyv-live-cli@latest statistics view -c <channelId> --start-day 2026-06-01 --end-day 2026-06-20
安装 Skill 后，也可直接用自然语言描述目标（如创建电商频道、添加优惠券、导出昨日数据），由 Agent 展开为上述 CLI 调用；写入类操作前，Skill 侧通常要求先查帮助与账号，并对删除、禁言等变更做确认。
入口校验习惯（360 技能中心文档与仓库一致）：不确定子命令语法时，先执行：
npx --yes polyv-live-cli@latest --help
npx --yes polyv-live-cli@latest <子命令> --help
以 npm 发布版 help 为准，避免沿用旧示例。
适用场景与注意¶
适合谁： 需要频繁管理频道、查推流与状态、整理回放、配置互动或导出统计的运营与技术团队；多账号、批量维护场景收益更明显。
使用前： 准备 AppID、AppSecret；AppSecret 勿写入公开仓库、截图或不可信聊天环境。
操作中： 删除、清空、禁言、踢人、开播停播前先确认频道 ID、资源 ID 与当前默认账号；多账号场景建议账号命名清晰，执行前 account list 核对。
排错： 无法查频道时，检查认证与默认账号；可重新 set-default 后再 channel list。推流状态变更可能影响正在进行的直播，正式环境操作前先看 stream status。
结尾¶
保利威直播 Skill 把云直播控制台里的高频操作收敛到 polyv-live-cli 与 Agent 对话两条路径，适合把「查—改—统计」做成可复现流程。安装与能力说明以保利威帮助中心与 GitHub 仓库为准；Skill 条目见 https://api.skillhub.cn/u_4f4f94ce/polyv-live。
