Node.js + npm（PATH 状态检查）
适用范围
使用本页面当：
- 您安装了 Moltbot 但
moltbot是"command not found" - 您正在新机器上设置 Node.js/npm
npm install -g ...因权限或 PATH 问题而失败
Moltbot 的运行时基准是 Node 22+。
如果您可以运行 npm install -g moltbot@latest 但后来看到 moltbot: command not found，几乎总是 PATH 问题：npm 放置全局二进制文件的目录不在您 shell 的 PATH 上。
快速诊断
运行：
node -v
npm -v
npm prefix -g
echo "$PATH"如果 $(npm prefix -g)/bin（macOS/Linux）或 $(npm prefix -g)（Windows）不在 echo "$PATH" 中，您的 shell 无法找到全局 npm 二进制文件（包括 moltbot）。
修复：将 npm 的全局 bin 目录放入 PATH
- 找到您的全局 npm 前缀：
npm prefix -g- 将全局 npm bin 目录添加到您的 shell 启动文件：
- zsh:
~/.zshrc - bash:
~/.bashrc
示例（将路径替换为您的 npm prefix -g 输出）：
# macOS / Linux
export PATH="/path/from/npm/prefix/bin:$PATH"然后打开一个新终端（或在 zsh 中运行 rehash / 在 bash 中运行 hash -r）。
在 Windows 上，将 npm prefix -g 的输出添加到您的 PATH。
修复：避免 sudo npm install -g / 权限错误（Linux）
如果 npm install -g ... 因 EACCES 失败，将 npm 的全局前缀切换到用户可写目录：
mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"将 export PATH=... 行持久化到您的 shell 启动文件中。
推荐的 Node 安装选项
如果 Node/npm 以以下方式安装，您将最少遇到惊喜：
- 保持 Node 更新（22+）
- 使全局 npm bin 目录稳定并在新 shell 中处于 PATH 上
常见选择：
- macOS: Homebrew (
brew install node) 或版本管理器 - Linux: 您首选的版本管理器，或提供 Node 22+ 的发行版支持的安装
- Windows: 官方 Node 安装程序、
winget或 Windows Node 版本管理器
如果您使用版本管理器（nvm/fnm/asdf/等），确保它在您日常使用的 shell（zsh vs bash）中初始化，以便它设置的 PATH 在您运行安装程序时存在。