实时音视频
实时音视频
文档指南
请输入
实时音视频
快速入门
场景方案
开发指南
Token 鉴权
音频管理
视频管理
屏幕共享
SDK 升级指南
客户端 API 参考
服务端 API 参考
房间管理
转推直播
输入在线媒体流
WTN 流（原公共流）
实时数据监控
历史数据查询
业务标识管理
实时消息通信
历史版本（文档停止维护）
2023-08-01
2023-06-01
转推直播
2022-06-01
2020-12-01
转推直播
输入在线媒体流
获取数据指标
常见问题
集成相关
质量相关
AI 音视频互动方案
开发指南
配置 ASR/LLM/TTS 服务
API 参考
硬件对话智能体
用户指南
服务端 API
智能体
实时信令
互动白板
客户端 API 参考
服务端 API 参考
- 文档首页
实时音视频通过 AI 使用通过 CLI
复制全文
下载 pdf通过 CLI
文档反馈
问问助手通过 CLI，AI 工具（如 TRAE Work、AI IDE、命令行助手等）可以读取官方 Skill、创建示例项目、引导配置和启动本地 Demo、获取 RTC 官方文档，并在接入或运行失败时执行诊断和错误排查。
安装 CLI
- 安装 CLI：
- npm install -g @volcengine/rtc-clivertc version
- 执行 vertc version 后，如果输出版本信息，说明安装成功。
注意
若提示 zsh: command not found: vertc，通常不是安装失败，而是 vertc 所在目录未加入当前终端的 PATH。可尝试重新打开终端后再执行；如仍失败，请检查 Node.js / npm 全局安装目录是否已加入 PATH。
- 安装或加载 Skill：
- 通过 CLI 同步 Skill从 GitHub 仓库安装 Skill手动加载 Skillvertc skills syncnpx skills add volcengine/VolcEngineRTC_CLI -g -y
- 先下载源码：
- git clone https://github.com/volcengine/VolcEngineRTC_CLI.git ~/vertc-skills
- 再让 AI IDE 加载仓库中的 skills/byted-interactai-guide/ 目录，或直接加载其中的 SKILL.md。
常用 CLI 命令
命令 | 用途 |
命令 | 用途 |
vertc init [dir] --scene <scene> --platform <platform> | 基于官方模板创建项目 |
vertc auth <login|status|logout> | 管理登录状态 |
vertc dev [--web-port N] [--server-port N] | 配置 RTC 资源并启动项目；添加 --reconfigure 可重新选择 App/Bot |
vertc doctor [cli|project] | 检查 CLI 或项目是否就绪，不做修改 |
vertc explain-error <code> | 离线查询 SDK 与对话式 AI 错误码 |
vertc docs <search|fetch|list> | 搜索、读取或浏览 RTC 文档 |
vertc skills <list|read|sync> | 查看、读取或同步官方 Skill |
vertc update [--check|--force] | 检查或更新 npm 管理的安装 |
使用示例
以下示例以 AI 音视频互动方案为主。使用 CLI 时，AI 可以同时调用文档查询、官方 Skill 和本地项目命令，因此更适合用于接入执行、项目诊断和产品能力排查。
示例一：查询和读取文档
请使用 vertc docs 搜索“接入端到端实时语音大模型”，并总结接入步骤。
示例二：查看官方 Skill
请使用 vertc skills 查看 AI 音视频互动相关 Skill，并根据 Skill 说明判断接入 VoiceChat Web Demo 应该按哪些阶段推进。
示例三：创建并启动示例项目
请使用 vertc init --scene voice-agent --platform web 创建 AI 音视频互动 Web Demo，并说明后续需要如何登录、选择 App/Bot、启动项目。
示例四：诊断本地项目
当前 AI 音视频互动 Demo 启动失败，请先运行 vertc doctor 定位问题，再给出具体修复建议。
示例五：错误或异常查询
调用 StartVoiceChat 接口报错 “NoPermissionForApp”？
最近更新时间：2026.09.21 16:24:33
这个页面对您有帮助吗？
有用
有用
无用
无用