零门槛部署本地 AI 助手：Clawdbot/Meltbot 部署深度保姆级教程-平芜编程栈

前言：为什么选择 Clawdbot (Moltbot)？
第一阶段：基建工程（环境准备）
- 1.1 解决 Node.js 安装与版本问题
- - 1.1.1全新安装Node.js（电脑未安装过Node.js时）
  - 1.1.2卸载旧版Node.js 安装新版（电脑安装过Node.js但是版本不够新时）
- 1.2 解锁脚本执行权限
第二阶段：正式安装与初始化
- 2.1 执行一键安装
- 2.2 运行向导 (Onboarding)
- 2.3 成功界面
第三阶段：破解“命令找不到”与“网关未授权”
- 3.1 解决 moltbot 命令失效
- 3.2 提取身份令牌 (Token) 登录网页
第四阶段：配置各种API
- 总结：你的 AI 现在能干什么？

前言：为什么选择 Clawdbot (Moltbot)？

Clawdbot 不仅仅是一个聊天框。它是一个智能体（Agent），意味着它有“手”和“脚”：

如果你的电脑上从来没装过Node.js，无需执行卸载、删残留的步骤，直接按以下流程全新安装即可，步骤适配Windows系统，新手友好、全程默认下一步即可。

1. 下载适配的Node.js安装包

打开Node.js 官方官网，官网页面会自动识别你的系统（Windows）；
点击下载Windows Installer (64-bit)格式的安装包（.msi后缀，64位是目前Windows电脑的主流，无需选32位）；
小贴士：下载时建议保存到桌面/下载文件夹，方便找到安装包。

2. 安装Node.js（全程新手友好，默认下一步即可）

双击刚下载的.msi安装包，弹出安装向导，点击Next；
勾选同意协议（I accept the terms in the License Agreement），点击Next；
关键点1：确认安装路径（默认是C:\Program Files\nodejs\，新手不要修改，避免后续环境变量出问题），直接Next；
关键点2：进入「Custom Setup」自定义安装页，所有选项默认勾选即可（重点确认Add Node.js to PATH已勾选，这一步会自动把Node.js加入系统环境变量，不用手动配置，是最关键的一步），直接Next；
后续页面无需修改任何高级选项，一直点击Next，最后点击Install开始安装，等待10-30秒（安装速度看电脑配置）；
安装完成后，点击Finish关闭向导即可。

3. 版本验证
必须重启终端（关闭所有已打开的PowerShell/CMD，重新打开），否则系统识别不到新安装的Node.js！

按下Win+R，输入PowerShell，打开普通权限的PowerShell即可；
输入验证命令：
```
node-v
```
回车后，若显示v22.x.x或v24.x.x（比如v22.10.0、v24.4.0），说明安装成功且版本符合要求；
可选验证：输入npm -v，会显示配套的npm版本（Node.js安装包会自动附带npm，无需单独安装），能正常输出版本即代表环境变量配置无误。

如果版本不够新，执行安装命令的时候程序会尝试安装新版的Node.js，但是大概率会失败，还是手动比较好，失败的话会显示以下界面：

操作：
1.可以直接通过新的安装包对上一个版本的Node.js进行remove

版本验证（和卸载旧版后的验证步骤一致）
必须重启终端（关闭所有已打开的PowerShell/CMD，重新打开），否则系统识别不到新安装的Node.js！
按下Win+R，输入PowerShell，打开普通权限的PowerShell即可；
输入验证命令：
```
node-v
```
回车后，若显示v22.x.x或v24.x.x（比如v22.10.0、v24.4.0），说明安装成功且版本符合要求；
可选验证：输入npm -v，会显示配套的npm版本（Node.js安装包会自动附带npm，无需单独安装），能正常输出版本即代表环境变量配置无误。

操作：以管理员身份运行 PowerShell，执行：

Set-ExecutionPolicy-ExecutionPolicy RemoteSigned-Scope CurrentUser

完成以上步骤后，你的Node.js环境就完全满足Clawdbot的要求了，可以直接进入后续的项目安装环节。

操作：在 PowerShell 输入：

iwr-useb https://clawd.bot/install.ps1|iex

作用：这行代码会自动下载主程序并配置环境变量。

这个会持续一会才有进展，不要担心，如果太久可以按按回车看看是不是powershell刷新的问题

这个会持续一段时间才有进展，不要担心，

操作：输入moltbot onboard。
详细选项说明：
1. Mode：选QuickStart。
2. Provider (大脑)：建议选Qwen。
  - 注意：此时会跳出网页让你授权，登录或者注册Qwen的账号既可。这步是为了先让机器人有个“临时大脑”跑起来。
    
    选择OpenAI Chat，拿到Key之后输入到界面中给Clawdbot。
    
    选择这个直接按回车即可。
3. Channels (远程控制)：选Skip for now。我们先在本地跑通，以后再连 Telegram。
4. Skills (技能)：选Yes。
  这些是最基本的Skill选择，选择Yes就好
5. Skill install：选npm。

Skill Dependencies：选Skip for now。

这些是扩展的，目前配置比较麻烦，可以后续再配置
6. 一些其他配置

选择No，尽量都留到后面再配置

、

现象：访问http://localhost:18789显示“未授权：网关令牌缺失”。
操作：
1. 打开文件夹C:\Users\你的用户名\.clawdbot。
2. 右键点击clawdbot.json，用记事本打开。
3. 找到"token": "xxxxxxx"这一行，复制那串长代码。
4. 回到浏览器，点击右上角红色状态，把 Token 贴进去。一旦变绿，恭喜你，你的助理正式上线了！