安装 Moltbot
使用安装脚本。除非有特殊原因——否则下面还有 npm、Docker、Nix 等方式可选。
快速安装
Mac / Linux：
curl -fsSL https://molt.bot/install.sh | bashWindows (PowerShell)：
iwr -useb https://molt.bot/install.ps1 | iex脚本会安装 CLI 并启动引导。若现在跳过引导，之后可执行：
moltbot onboard --install-daemon所需环境
- Node.js 22+ — 唯一硬性要求。安装脚本可代为安装（macOS 用 Homebrew，Linux 用 NodeSource）。
- macOS、Linux 或 Windows (WSL2) — 原生 Windows 未测试；推荐 WSL2。
- pnpm — 仅从源码构建时需要。
安装方式
1) 安装脚本（推荐）
一条命令完成全局 npm 安装与可选引导：
curl -fsSL https://molt.bot/install.sh | bash查看所有参数：
curl -fsSL https://molt.bot/install.sh | bash -s -- --help跳过向导（CI / 脚本化安装）：
curl -fsSL https://molt.bot/install.sh | bash -s -- --no-onboard详情：安装脚本说明。
2) 全局安装（手动）
已有 Node 22+？
npm install -g moltbot@latest若 sharp 报错（例如系统有 Homebrew 的 libvips），可强制使用预编译二进制：
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g moltbot@latest或使用 pnpm：
pnpm add -g moltbot@latest然后自行运行引导：
moltbot onboard --install-daemon3) 从源码（贡献者 / 开发）
git clone https://github.com/moltbot/moltbot.git
cd moltbot
pnpm install
pnpm ui:build
pnpm build
moltbot onboard --install-daemon未做全局安装？可在仓库内用 pnpm moltbot ...。
4) 其他方式
安装后
- 引导：
moltbot onboard --install-daemon - 自检：
moltbot doctor - 网关健康：
moltbot status与moltbot gateway probe - 控制台：
moltbot dashboard→http://127.0.0.1:18789/
安装方式：npm 与 git（安装脚本）
安装脚本支持两种方式：
- npm（默认）—
npm install -g moltbot@latest - git — 克隆仓库、构建并从检出运行（若你已在仓库内很方便）
参数：
--install-method npm|git--git-dir <path>（默认：~/moltbot）--no-git-update— 使用已有检出时不拉取--no-prompt— 无交互提示（用于 CI）--dry-run— 仅打印将要执行的操作，不修改--no-onboard— 跳过引导
环境变量对应：CLAWDBOT_INSTALL_METHOD、CLAWDBOT_GIT_DIR、CLAWDBOT_NO_PROMPT、CLAWDBOT_DRY_RUN、CLAWDBOT_NO_ONBOARD、SHARP_IGNORE_GLOBAL_LIBVIPS。
故障排查：找不到 moltbot（PATH）
当前 shell 看不到全局 npm 的 bin。快速检查：
node -v
npm -v
npm prefix -g
echo "$PATH"若 $(npm prefix -g)/bin（macOS/Linux）不在 PATH 中，请加入。zsh/bash 示例：
export PATH="$(npm prefix -g)/bin:$PATH"写入 ~/.zshrc 或 ~/.bashrc，然后新开终端（或执行 rehash / hash -r）。Windows 下将 npm prefix -g 的输出（及其 \bin）加入 PATH。
更新 / 卸载
最后更新于: