文档
安装

安装

适用范围

本页面帮助您选择 moltbot CLI 的安装路径并启动一个可用的、始终运行的网关。

快速安装（推荐）

macOS / Linux：

curl -fsSL https://clawd.bot/install.sh | bash

Windows (PowerShell)：

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

下一步（如果您跳过了入门引导）：

moltbot onboard --install-daemon

系统要求

  • Node.js 22+
  • macOS、Linux 或通过 WSL2 的 Windows
  • pnpm 仅当您从源码构建时需要

选择安装方法

  1. 安装程序脚本（推荐）：设置 CLI 并运行入门引导。 详情：/zh-cn/docs/install/installer/

  2. 全局安装（手动）：如果您已经自己管理 Node/npm。 详情：/zh-cn/docs/install/node/

  3. 从源码（贡献者/开发人员）：克隆、构建、从副本运行。 详情：/zh-cn/docs/install/development-channels/

  4. 其他选项：Docker / Nix / Ansible / Bun（仅 CLI）。 从这里开始：/zh-cn/docs/install/docker/

安装后（验证） 

moltbot status
moltbot health
moltbot dashboard

常见故障排除

moltbot: command not found

检查全局 npm 安装的位置：

node -v
npm -v
npm prefix -g
echo "$PATH"

如果全局 npm bin 目录不在 PATH 中，添加它（macOS/Linux）：

export PATH="$(npm prefix -g)/bin:$PATH"

sharp 安装失败

如果您有系统 libvips（在 macOS 上常见）并且 sharp 构建失败，强制使用预构建二进制文件通常有帮助：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g moltbot@latest

更新 / 卸载

  • 更新：/zh-cn/docs/install/updating/
  • 卸载：/zh-cn/docs/install/uninstall/

延伸阅读

  • 源路径：install/index.md