全网爆火的 OpenClaw 图文保姆级教程

OpenClaw(原名 Clawdbot/Moltbot)是一个非常强大的开源 AI Agent 平台,我们经常把它称为“小龙虾”,它允许你在本地运行 AI 助手,并通过飞书、Telegram、微信等频道指挥它完成文件管理、网页浏览甚至执行代码等复杂任务。

Image

环境检查与准备

OpenClaw 核心基于 Node.js,对版本有严格要求。

  • 系统要求:macOS、Linux 或 Windows(Windows 强烈建议在 WSL2 / Ubuntu 环境下运行)。
  • 依赖要求Node.js 22 或更高版本

对于 macOS / 🐧 Linux 用户: 在终端中运行以下一键脚本:

Bash

curl -fsSL https://openclaw.ai/install.sh | bash

(如果你更喜欢手动管理包,也可以直接使用 npm install -g openclaw@latest)

🪟 对于 Windows 用户 (PowerShell):按下键盘上的 Win + X 键, 以管理员身份运行 PowerShell,然后输入:

Image

PowerShell

iwr -useb https://openclaw.ai/install.ps1 | iex

我们不要把它安装到C盘,安装到其它盘,首页需要设置一下路径。

设置 NPM 的全局安装路径到 J 盘

我们需要告诉 npm,以后所有的全局工具(包括 OpenClaw)都装在 J 盘。

  1. 1. 在 J 盘创建一个专门存放工具的文件夹(例如 J:\OpenClaw)。
  2. 2. 打开 PowerShell(管理员身份),依次运行以下两条命令:
  3. 3. powershell
# 设置全局包安装路径
npm config set prefix "J:\OpenClaw"

# 设置缓存路径(可选,建议也放 J 盘)
npm config set cache "J:\OpenClaw_cache"
Image

验证路径是否生效

在当前的 PowerShell 窗口输入以下命令:

PowerShell

npm config get prefix

如果返回的结果是 J:\OpenClaw,说明设置已生效。

Image

现在到了最关键的安装环节。请直接在当前的 PowerShell 窗口中按顺序执行以下步骤:

执行全局安装

复制并运行这条命令,它会将 OpenClaw 的程序文件下载到你的 J 盘:

PowerShell

npm install -g openclaw@latest

(运行后你会看到一个进度条。如果安装完成后最后几行没有明显的红色 ERROR 字样,就说明安装成功了。)

Image

如 Node.js安装不了,根据OpenClaw官方文档,Windows上强烈建议在WSL2。

一键开启 WSL2

  1. 1. 右键开始菜单,选择 Windows PowerShell (管理员) / 终端 (管理员)
  2. 2. 执行微软官方一键开启命令,自动启用 WSL2、虚拟机平台功能,默认安装 Ubuntu LTS 发行版:

powershell

wsl --install
  1. 3. 命令执行完成后,按提示重启电脑,系统会自动完成剩余配置。
Image

这个默认是安装到C盘中。

如果不想安装到C盘 ,我们可以安装到移动盘,安装步骤如下:

由于 WSL2 本质上是一个运行在 Windows 里的 Linux 虚拟机,它默认的根目录在 C 盘。要让它读写移动盘并把 OpenClaw 装在那儿,我们需要通过 Linux 挂载点 来实现。

先下载 Ubuntu 22.04文件,地址 : https://cloud-images.ubuntu.com/wsl/jammy/current/ubuntu-jammy-wsl-amd64-ubuntu22.04lts.rootfs.tar.gz

🛠️ 第一步:在 PowerShell 中执行“定居”命令

请打开管理员模式的 PowerShell,一次性粘贴并运行以下这两行:

PowerShell

# 1. 创建 Linux 系统的根目录文件夹
mkdir J:\WSL_Linux_Root

# 2. 将下载的包导入到 J 盘(请确保文件名与你下载的完全一致)
wsl --import OpenClaw-Linux J:\WSL_Linux_Root\ "J:\WSL_Download\ubuntu-jammy-wsl-amd64-ubuntu22.04lts.rootfs.tar.gz"
  • 成功标志:命令运行几秒后回到提示符,且 J:\WSL_Linux_Root 文件夹下出现了一个名为 ext4.vhdx 的大文件。

🚀 第二步:进入系统并终结代理报错

现在我们进入这个位于 J 盘的纯净 Linux 环境。

  1. 1. 启动并登录
  2. 2. PowerShell
wsl -d OpenClaw-Linux
  1. 1. (你会发现命令提示符变成了类似 root@电脑名:/# 的样子,这代表你已经进城了!)
  2. 2. 暴力安装环境(直接粘贴这一整段): 进入黑色的 Linux 窗口后,粘贴这串经过特殊优化的命令,它会帮你搞定 Node.js 并强制绕过 7890 代理:
  3. 3. Bash
# 更新 Linux 系统并安装 Node.js 22
apt update && apt install -y curl && \
curl -fsSL https://deb.nodesource.com/setup_22.x | bash - && \
apt install -y nodejs

# 彻底清除 Linux 内部可能继承的 Windows 代理环境变量unset http_proxy; unset https_proxy; unset ALL_PROXY;

# 使用国内镜像极速安装 OpenClaw
npm install -g openclaw@latest --registry=https://registry.npmmirror.com
Image

🏁 第三步:启动 OpenClaw

如果上面没有报错,直接输入:

Bash

openclaw gateway
Image

以后每次怎么打开它?

以后你每次想用 OpenClaw,只需要:

  1. 1. 插上 J 盘。
  2. 2. 打开 PowerShell,输入 wsl -d OpenClaw-Linux。
  3. 3. 进去后直接输入 openclaw gateway 命令。

大家如有不懂的,请欢迎留言交流

暂无评论

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

版权信息 © 2026 本站资源收集于网络仅供用于学习和交流,本站一切资源不代表本站立场,如有侵权,请联系本站删除处理!