通过 CLI
通过 CLI,AI 工具(如 TRAE Work、AI IDE、命令行助手等)可以读取官方 Skill、创建示例项目、引导配置和启动本地 Demo、获取 RTC 官方文档,并在接入或运行失败时执行诊断和错误排查。
安装 CLI
npm install -g @volcengine/rtc-cli
- 执行 vertc version 后,如果输出版本信息,说明安装成功。
注意
若提示 zsh: command not found: vertc,通常不是安装失败,而是 vertc 所在目录未加入当前终端的 PATH。可尝试重新打开终端后再执行;如仍失败,请检查 Node.js / npm 全局安装目录是否已加入 PATH。
通过 CLI 同步 Skill
从 GitHub 仓库安装 Skill
手动加载 Skill
npx 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 命令
使用示例
以下示例以 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