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

0 阅读7分钟

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

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


先花 30 秒搞懂原理

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

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

系统要求:Python 3.10+、Git。

下面一步一步来。


第 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解说大师商务咨询,获取你的专属 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-stylesnarrator-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 换成你实际安装的版本号)。


相关链接