在 Windows 系统上部署 Moltbot (原名 Clawdbot)主要有两种方式:一种是使用官方提供的 PowerShell 一键安装脚本 (推荐,适合大多数用户),另一种是通过 WSL2(Windows Subsystem for Linux) 进行深度部署(适合开发者或需要更稳定环境的用户)。
以下是基于最新搜索结果整理的详细部署指南:
一、 系统要求与依赖项
在开始之前,请确保你的系统满足以下基本要求:
- 操作系统:Windows 10 (版本 2004 及以上) 或 Windows 11。
- 硬件建议:至少 8GB RAM(建议 16GB),预留 5GB 以上磁盘空间。
- 核心依赖软件 :
- Node.js :建议版本为 v22.x 或更高(LTS版本)。
- Git:用于克隆仓库和版本管理。
- Python(可选):部分插件可能需要 Python 3.10+ 环境。
- WSL2(推荐):若选择 Linux 环境部署,需提前安装 Ubuntu 分发版。
二、 详细配置流程(一键安装法)
这是最快捷的部署方式,直接在 Windows PowerShell 中运行。
1. 修改执行策略
为了允许运行安装脚本,需以管理员身份打开 PowerShell,执行以下命令:
powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
2. 运行安装脚本
输入以下命令开始自动下载和安装:
powershell
iwr -useb molt.bot/install.ps1 | iex
该脚本会自动检测环境、安装必要的组件并配置 Moltbot 路径。
3. 初始化与配置
安装完成后,根据提示进入配置环节:
- API Key 配置:你需要准备好大模型(如 OpenAI, Claude, Qwen, DeepSeek 等)的 API Key。
- 平台集成:选择你想要接入的平台(如飞书、微信、Telegram 等)。
三、 进阶部署:通过 WSL2 运行(更稳定)
如果你需要调用复杂的本地工具或进行二次开发,建议使用 WSL2:
-
安装 WSL2 :在 PowerShell 执行
wsl --install,重启电脑。 -
安装 Ubuntu:从 Microsoft Store 下载并启动 Ubuntu。
-
安装 Node.js 22 :
bashcurl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs -
部署 Moltbot :
bashcurl -fsSL https://molt.bot/install.sh | bash
四、 常见问题及解决方案
在部署过程中,你可能会遇到以下错误:
| 错误现象 | 可能原因 | 解决方案 |
|---|---|---|
| 脚本执行被拒绝 | PowerShell 权限限制 | 执行 Set-ExecutionPolicy Bypass -Scope Process。 |
| Node.js 版本过低 | 预装版本不符合要求 | 访问 Node.js 官网 下载并安装最新的 v22 LTS 版本。 |
| 网络连接超时 | GitHub 或 API 域名被墙 | 使用代理工具,或在终端配置 https_proxy 环境变量。 |
| npx 命令未找到 | Node.js 路径未加入环境变量 | 重新安装 Node.js 并勾选 "Add to PATH",或手动添加。 |
| 模型响应报错 401/403 | API Key 无效或余额不足 | 检查 .env 配置文件中的 Key 是否正确,确认模型权限。 |
五、 参考资源
- 官方 Windows 安装教程 :Moltbot Setup Windows
- 阿里云开发者社区保姆级教程 :Windows系统Moltbot部署指南
- 知乎详细配置与排错 :Clawdbot (Moltbot) Windows 安装教程
- 综合教程合集 :Moltbot/Clawdbot 安装教程合集
提示 :部署完成后,建议通过 molt --help 命令查看所有可用指令,确保系统已正确识别程序。