用小龙虾(OpenClaw)做电影解说,零基础保姆级教程

AI解说大师 CLI & Skill 安装指南

一句话让AI帮你做电影解说视频，从此告别手动剪辑。本文适用 Windows 和 macOS，全程约 15 分钟。

先花 30 秒搞懂原理

AI解说大师的自动化视频生产分两个部分：CLI 是"手"，把选素材、选模板、生成视频这些操作封装成了一条条终端命令；Skill 是"脑"，是一份技能说明书，让 AI 助手（小龙虾 OpenClaw、WorkBuddy、Windsurf 等）读懂后知道怎么调用这些命令。

两个都装好，你就可以对着 AI 说"帮我做一个大话西游的电影解说视频"，它就会自动搜索电影 → 匹配解说风格 → 生成文案 → 合成视频 → 返回下载链接，全程不需要你手动操作。

系统要求：Python 3.10+、Git。以下为简易版教程：

简易版安装教程

第一步：直接把⬇️下方

GitHub代码仓库链接丢给龙虾，让它自己安装。

AI解说大师 | 开源地址（需挂梯子打开）

🔗Skill 安装地址：

https://github.com/jieshuo-ai/narrator-ai-cli-skill/blob/main/README_CN.md

🔗CLI 安装地址：

https://github.com/jieshuo-ai/narrator-ai-cli/blob/main/README_CN.md

第二步：接入AI解说大师AppKey

开通APPkey请联系👉gezimufeng

第三步：直接对龙虾下指令，坐等出片

保姆级教程：详细到每一个步骤

下面是详细版教程，可以跟着一步一步来。

第 1 步：安装 Python

打开 Python 官方下载页，点击黄色大按钮 "Download Python 3.x.x" 下载安装。

Windows 用户请特别注意：安装界面最下方有一个复选框 "Add python.exe to PATH"，默认是未勾选的——你必须手动勾上它。不勾的话后面所有步骤都会报错"不是内部或外部命令"。勾好之后再点 "Install Now"。macOS 用户下载 .pkg 文件后双击安装，一路点"继续"即可。

安装完成后关闭终端/命令提示符窗口，重新打开一个新的（这一步很重要，不关的话系统读不到新装的 Python），然后输入验证命令：

# Windows 用户python --version# macOS 用户python3 --version

看到 Python 3.10 或更高版本号，说明安装成功。

第 2 步：安装 Git

Windows：打开 Git 官方下载页，页面会自动开始下载。下载完成后双击安装，所有设置页面全部点 "Next"，最后点 "Install" → "Finish" 即可。

macOS：在终端输入以下命令，系统会弹出白色安装对话框，点"安装"等待完成：

xcode-select--install

💡 如果提示磁盘空间不足（Xcode 命令行工具需要约 17GB），可以改用 brew install git（需要先安装 Homebrew），只需要几百 MB。

安装完成后，同样关闭终端重新打开，输入验证命令：

git --version

看到 git version 2.x.x 就说明成功了。

第 3 步：安装 CLI 工具

Python 和 Git 都就绪后，开始安装 AI解说大师的命令行工具。根据你的系统复制对应的一键安装命令，粘贴到终端里按回车执行：

Windows（命令提示符或 PowerShell）：

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 秒没有任何反应，说明网络访问 GitHub 受限（国内常见问题）。按 Ctrl+C（macOS 是 Control+C）终止，改用手动安装：

# 第 1 条：用镜像加速下载代码git clone https://ghfast.top/https://github.com/jieshuo-ai/narrator-ai-cli.git# 第 2 条：进入项目目录cd narrator-ai-cli# 第 3 条：安装 CLI（macOS 用 pip3）pip install -e .

如果 ghfast.top 也打不开，把地址换成 https://mirror.ghproxy.com/https://github.com/jieshuo-ai/narrator-ai-cli.git 再试。

安装完成后，关闭终端重新打开，输入验证命令：

narrator-ai-cli --version

看到版本号输出（比如 0.1.0），说明 CLI 安装成功。macOS 如果提示 command not found，先执行 source ~/.zshrc 再试。

第 4 步：配置 API Key

CLI 装好了，接下来让它连上 AI解说大师的服务器。你需要一个 API Key（相当于账户钥匙）。

获取方式：联系 AI解说大师商务咨询，发送邮件至 merlinyang@gridltd.com 获取你的专属 API Key。

拿到 Key 后，在终端输入以下命令（把"你的API_Key"替换成你实际拿到的那串字符）：

narrator-ai-cli config set app_key 你的API_Key

然后验证连接是否成功：

narrator-ai-cli user balance

能看到你的账户余额（积分数），说明 CLI 已经完全就绪。

第 5 步：加载 Skill 到 AI助手（小龙虾）

前四步搞定了"手"（CLI 工具），这一步给 AI 装上"脑"（Skill 技能文件），让它学会怎么用 CLI 帮你做视频。

根据你使用的 AI 助手平台，选择对应方式：

WorkBuddy / QClaw（腾讯系）：在技能管理界面直接上传 SKILL.md 文件。

小龙虾 OpenClaw：原生 Skill 加载，在终端执行：

mkdir -p ~/.openclaw/skills/narrator-ai-cli# 先把 SKILL.md 下载到本地，然后复制进去cp SKILL.md ~/.openclaw/skills/narrator-ai-cli/SKILL.md

Windsurf：复制 SKILL.md 到项目的 .skills/narrator-ai-cli/ 目录。Windsurf 只需要 CLI 仓库地址就能自动理解，体验最流畅。

其他支持 Markdown Skill 的 Agent（有道龙虾、元气AI、Cursor、Claude Code 等）：指向 SKILL.md 文件即可。

通用备选方案——在对话中让 AI 自己学习：如果找不到上传入口，直接在 AI 助手的对话框里分两步操作。先发送第一条消息：

请帮我安装这个 CLI 命令行工具：https://github.com/jieshuo-ai/narrator-ai-cli

等 AI 回复完成后，再发送第二条：

请学习这个技能文件：https://github.com/jieshuo-ai/narrator-ai-cli-skill/blob/main/SKILL.md

💡 为什么要分两步？国内 AI 助手一次只处理一个仓库时理解能力更稳定，分两步成功率更高。海外的 Windsurf 只需要给一个 CLI 地址就行。

AI 提示输入 API Key 时，把你第 4 步配置的那个 Key 发给它。看到"已准备就绪"或显示出账户余额，说明全部配置成功。

安装完成！试试看

在 AI 助手的对话框里输入：

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

AI 会自动执行完整流程：搜索电影信息 → 选择解说风格 → 选 BGM → 选配音角色 → 生成解说文案 → 合成视频 → 返回下载链接。全程你只需要在 AI 询问时回复"确认"就行。

AI解说大师内置了 93 部电影素材、146 首 BGM、63 个配音角色（支持 11 种语言）和 90+ 种解说风格模板，全部开箱即用，无需上传任何素材。

常见问题

Q1：安装过程中网络一直卡住，怎么办？

A：国内访问 GitHub 经常受限。把命令中的 https://github.com 替换为 https://ghfast.top/https://github.com。如果仍然不行，再试 https://mirror.ghproxy.com/https://github.com。两个镜像都不行的话，联系 AI解说大师商务咨询直接要安装包。

Q2：输入命令后提示"不是内部或外部命令"（Windows）或"command not found"（macOS），怎么办？

A：最常见的原因是安装完成后没有关闭终端重新打开。关掉当前窗口，重新打开一个新的终端再输入命令。Windows 用户还要确认安装 Python 时勾选了"Add python.exe to PATH"，没勾的话需要重新安装 Python。macOS 用户可以先执行 source ~/.zshrc 刷新环境变量后再试。

Q3：API Key 从哪里获取？

A：文末扫码联系 AI解说大师商务咨询，即可获取你的专属 API Key。拿到后在终端执行 narrator-ai-cli config set app_key 你的API_Key 完成配置。

Q4：AI小龙虾自动选了我不想要的解说风格或配音，怎么控制？

A：指令越具体，AI 执行越精确。比如说"帮我做飞驰人生的解说，解说风格用爆笑喜剧，配音用男声热血风，BGM 用轻快节奏"，效果远好于只说"帮我做个解说"。AI解说大师内置 90+ 种解说风格模板和 63 个配音角色，你可以提前用 narrator-ai-cli task narration-styles 和 narrator-ai-cli dubbing list 查看所有可选项。

Q5：提示云盘空间不足，怎么处理？

A：上传自定义素材会占用账户的 3GB 云盘空间。对 AI 助手说"帮我查看云盘空间"可以查看用量，说"帮我删除之前的文件"可以清理。注意先把已生成的视频下载到本地再删除云盘文件。

Q6：macOS 终端前面显示 (base)，Python 版本不对怎么办？

A：终端提示符前出现 (base) 说明你之前装过 Anaconda，它会"劫持" python3 命令指向自带的旧版本。先输入 python3 --version 看一下版本，如果是 3.10 以上就可以直接用。如果低于 3.10，需要从官网另装新版 Python，然后用完整路径执行命令，比如 /Library/Frameworks/Python.framework/Versions/3.14/bin/python3（把 3.14 换成你实际安装的版本号）。