AI解说大师接入教程：三步配置 narrator-ai-cli，让 AI自动生成电影解说视频

1. 为什么我会盯上 narrator-ai-cli 这套本地接入方案

如果你正在找一条能跑通「电影解说视频自动生成」的本地链路，narrator-ai-cli 值得花半小时试一次。它本质是一个命令行工具加一份 Markdown Skill 文件：CLI 负责真正干活（搜素材、配风格、选 BGM、合成视频），Skill 负责让 AI 助手理解「做解说视频」这件事该怎么拆步骤。你只要在对话框里说一句「帮我做一个《飞驰人生》的电影解说视频」，剩下的流程它会自己往下走。

这套东西适合谁？适合已经装了 Python、用过 Git、手里有 Cursor / Claude Code / Windsurf / 小龙虾 OpenClaw 这类支持 Markdown Skill 的 Agent 的开发者。它不适合完全没碰过终端的人，因为中间几步（PATH、pip、镜像加速）出问题时需要你自己判断。

我这次重点不是复述官方安装文档，而是把「三步配置」拆成可复制的动作：Skill 文件怎么放、CLI 怎么装、APP Key 怎么配，以及怎么用 TaoToken 把调用凭证统一管起来。后面会给一份 config.toml 骨架、一段验证请求，还有我自己踩过的几个报错。全程命令都能直接抄。

2. 前置准备：Python、Git 和 TaoToken 的 Key 通道

2.1 环境三件套先确认

narrator-ai-cli 的硬性前置只有两个：Python 3.10+ 和 Git。Windows 装 Python 时那个「Add python.exe to PATH」复选框一定要勾，不勾后面所有命令都会报「不是内部或外部命令」。装完关掉终端重开，再验证：

# Windows python --version # macOS python3 --version

看到 3.10 或更高就行。Git 同理，Windows 一路 Next，macOS 用xcode-select --install，验证git --version出git version 2.x.x即可。

2.2 为什么这里要提 TaoToken

narrator-ai-cli 自己需要一个 APP Key 才能调云端能力。但如果你同时还在用 Claude Code、Cursor 里的其他模型，Key 会越攒越多，散落在各个配置文件里，换机器就得重新找一遍。我的做法是把模型调用统一走 TaoToken 的 API 通道，官网在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 入口是 https://taotoken.net/api 。这样凭证只在一个地方管理，narrator-ai-cli 的 APP Key 和模型 Key 分开记，但都从同一个控制台拿。

先去控制台建 Key：https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=console_api_keys&utm_campaign=rewrite 。建完先别关页面，后面 config.toml 要用。

注意：APP Key 属于敏感凭证，不要写进会提交到 Git 的公开仓库。本地配置文件记得加进.gitignore。

3. 三步配置：Skill、CLI、APP Key 全流程

3.1 第一步：把 Skill 文件交给 AI 助手

Skill 文件是「解说大脑」，它告诉 Agent 做解说视频的完整流程。最省事的方式是直接把仓库地址丢给你的 AI 助手，分两条消息发，国内助手一次处理一个仓库时理解更稳：

第一条消息： 请安装这个 Skill：https://github.com/GridLtd-ProductDev/narrator-ai-cli-skill 第二条消息： 请读取这个 CLI 安装教程并帮我在电脑中下载安装： https://github.com/GridLtd-ProductDev/narrator-ai-cli

如果你用的是小龙虾 OpenClaw，也可以手动放：

mkdir -p ~/.openclaw/skills/narrator-ai-cli cp SKILL.md ~/.openclaw/skills/narrator-ai-cli/SKILL.md

Windsurf 更简单，把 SKILL.md 复制到项目的.skills/narrator-ai-cli/目录，它只要 CLI 仓库地址就能自动理解。

3.2 第二步：安装 narrator-ai-cli 命令行工具

Python 和 Git 就绪后装 CLI。Windows 用：

python -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/jieshuo-ai/narrator-ai-cli/main/install.py').read())"

macOS 用：

curl -fsSL https://raw.githubusercontent.com/jieshuo-ai/narrator-ai-cli/main/install.py | python3

正常 1 到 3 分钟刷完。如果超过 30 秒没反应，按 Ctrl+C 终止，改用镜像：

git clone https://ghfast.top/https://github.com/jieshuo-ai/narrator-ai-cli.git cd narrator-ai-cli pip install -e .

ghfast.top打不开就换https://mirror.ghproxy.com/https://github.com/...。装完关终端重开，验证：

narrator-ai-cli --version

macOS 如果提示command not found，先执行source ~/.zshrc再试。

3.3 第三步：配置 APP Key 与 config.toml 骨架

CLI 装好后配 APP Key：

narrator-ai-cli config set app_key 你的APP_Key

如果你想把模型调用也统一到 TaoToken，可以手写一份 config.toml。下面是我实测能用的骨架，字段按需替换：

# ~/.narrator-ai-cli/config.toml [app] app_key = "你的解说大师APP_Key" [llm] # 统一走 TaoToken 的 API 通道 base_url = "https://taotoken.net/api" api_key = "你的TaoToken_Key" model = "claude-sonnet-4-5" [output] dir = "./output" format = "mp4"

base_url用 https://taotoken.net/api 这个入口，不要带 UTM 参数，配置文件里保持干净。api_key从刚才那个控制台页面拿。改完保存，再验证一次连接：

narrator-ai-cli user balance

看到积分数显示，说明 CLI 和 Key 都通了。

4. 验证请求：一句话触发电影解说全流程

配置完成后，在 AI 助手对话框里输入：

帮我做一个《飞驰人生》的电影解说视频

AI 会自动执行：搜索素材 → 匹配解说风格 → 选 BGM → 选配音角色 → 生成文案 → 合成视频 → 返回下载链接。想要更精确，指令写具体点：

帮我做《飞驰人生》的解说，解说风格用爆笑喜剧， 配音用男声热血风，BGM 用轻快节奏

内置资源挺全：93 部电影素材、146 首 BGM、63 个配音角色（支持 11 种语言）、90+ 种解说风格模板，开箱即用，不用自己传素材。想看有哪些可选：

# 查看解说风格列表 narrator-ai-cli task narration-styles # 查看配音角色列表 narrator-ai-cli dubbing list

成功的结果是终端返回一个视频下载链接，点开能播放，画面、配音、BGM 都在。如果只返回文案没合成视频，多半是云盘空间或 Key 余额的问题，看下一节。

5. 本篇常见报错排查

5.1 安装卡住或超时

把命令里的https://github.com换成https://ghfast.top/https://github.com，还不行换https://mirror.ghproxy.com/https://github.com。两个镜像都不行，直接找 AI解说大师要离线安装包。

5.2 提示「不是内部或外部命令」或「command not found」

最常见原因是装完没关终端重开。关掉当前窗口，重开一个新终端。Windows 还要确认装 Python 时勾了「Add python.exe to PATH」，没勾得重装。macOS 先source ~/.zshrc。

5.3 macOS 终端前面显示 (base)，Python 版本不对

出现(base)说明装过 Anaconda，它会覆盖python3。先python3 --version确认版本，低于 3.10 就从官网另装新版，然后用完整路径执行，例如：

/Library/Frameworks/Python.framework/Versions/3.14/bin/python3 -m pip install -e .

5.4 AI 自动选了不想要的风格或配音

指令越具体越准。说「解说风格用爆笑喜剧，配音用男声热血风」，远好于只说「帮我做个解说」。

5.5 提示云盘空间不足

对 AI 助手说「帮我查看云盘空间」看用量，说「帮我删除之前的文件」清理。注意先把已生成的视频下载到本地再删云盘文件。

5.6 TaoToken 通道报 401 或鉴权失败

先确认 config.toml 里base_url是 https://taotoken.net/api ，没有多余斜杠或参数；再确认api_key是从控制台新建的、没被删。如果 narrator-ai-cli 的 APP Key 和 TaoToken Key 混填了，也会报鉴权错，两个字段分开核对。

6. 凭证统一管理后的下一步

把 narrator-ai-cli 的 APP Key 和模型调用分开管之后，换机器只要拷一份 config.toml，不用满世界找 Key。如果你后面要长期跑编码类任务或搭 Agent，可以看下 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 。只想先验证模型对话效果，用模型对话页更快：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models_chat&utm_campaign=rewrite 。接入细节和字段说明都在文档里：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。Key 管理还是回控制台：https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=console_api_keys&utm_campaign=rewrite 。

我自己的习惯是：narrator-ai-cli 的 APP Key 只配一次，模型通道走 TaoToken，这样以后换 Agent 或加新工具，只改一处 base_url 就行。你先按第 3 节的 config.toml 跑通一次user balance，再发那句「帮我做一个《飞驰人生》的电影解说视频」，看到下载链接就算整条链路通了。