小龙虾 OpenClaw 安装详细教学：Windows / macOS / Linux / WSL2 全流程

文章目录

• • 1. 小龙虾 OpenClaw 是什么？
  • 2. 安装前准备
  • • 2.1 系统要求
    • 2.2 你需要准备的东西
    • 2.3 新手推荐安装路线
  • 3. 推荐安装方式总览
  • 4. Windows 安装教程
  • • 4.1 打开 PowerShell
    • 4.2 临时放开脚本执行限制
    • 4.3 使用官方脚本安装
    • 4.4 不自动进入初始化向导的安装方式
    • 4.5 验证 Windows 安装结果
  • 5. macOS 安装教程
  • • 5.1 打开终端
    • 5.2 使用官方脚本安装
    • 5.3 不自动进入初始化向导
    • 5.4 验证 macOS 安装结果
  • 6. Linux 安装教程
  • • 6.1 更新系统软件包
    • 6.2 运行官方安装脚本
    • 6.3 如果不想自动初始化
    • 6.4 验证 Linux 安装结果
  • 7. Windows WSL2 安装教程
  • • 7.1 安装 WSL2
    • 7.2 进入 Ubuntu
    • 7.3 在 WSL2 中安装 OpenClaw
    • 7.4 验证 WSL2 安装结果
    • 7.5 Windows 浏览器访问 WSL2 中的控制台
  • 8. npm 手动安装教程
  • • 8.1 检查 Node.js 和 npm
    • 8.2 npm 安装 OpenClaw
    • 8.3 验证安装
    • 8.4 npm 安装失败怎么办？
  • 9. 初始化 OpenClaw
  • • 9.1 运行初始化命令
    • 9.2 初始化时会让你配置什么？
    • 9.3 什么是 `–install-daemon`？
  • 10. 启动和打开控制台
  • • 10.1 查看 Gateway 状态
    • 10.2 启动 Gateway
    • 10.3 重启 Gateway
    • 10.4 停止 Gateway
    • 10.5 打开 Dashboard
  • 11. 接入模型 API
  • • 11.1 常见模型选择
    • 11.2 API Key 填写原则
    • 11.3 模型名要写对
  • 12. 可选：安装 Ollama 本地模型
  • • 12.1 安装 Ollama
    • 12.2 下载本地模型
    • 12.3 在 OpenClaw 中使用 Ollama
  • 13. 常见安装报错解决
  • • 13.1 报错：`openclaw` 不是内部或外部命令
    • 13.2 报错：PowerShell 不允许执行脚本
    • 13.3 报错：Node 版本太低
    • 13.4 报错：npm 权限不足
    • 13.5 报错：Gateway 启动失败
    • 13.6 控制台打不开
    • 13.7 模型一直不回复
    • 13.8 Ollama 能用，但 OpenClaw 调不通
  • 14. 卸载与重装
  • • 14.1 npm 卸载
    • 14.2 删除配置目录
    • 14.3 重装流程
  • 15. 安全注意事项
  • • 15.1 不要随便安装陌生 Skills
    • 15.2 不要暴露本地控制台
    • 15.3 保护 API Key
    • 15.4 权限最小化
  • 16. 安装成功验收清单
  • 17. 命令速查表
  • • Windows 官方安装
    • Windows 安装但不自动初始化
    • macOS / Linux / WSL2 官方安装
    • macOS / Linux / WSL2 安装但不自动初始化
    • npm 安装
    • pnpm 安装
    • 初始化
    • 检查版本
    • 环境诊断
    • 查看 Gateway 状态
    • 启动 Gateway
    • 重启 Gateway
    • 停止 Gateway
    • 打开控制台
    • Ollama 下载模型
    • Ollama 运行模型
  • 18. 参考资料

1. 小龙虾 OpenClaw 是什么？

OpenClaw，中文圈常被称为“小龙虾”，是一个可以自托管的 AI 助手 / AI Agent Gateway。它可以运行在你的电脑或服务器上，通过本地 Gateway 连接大模型、工具、浏览器、文件系统和聊天平台。

你可以把它理解成：

用户
↓
Web 控制台 / Telegram / 飞书 / Discord / QQ / 其他入口
↓
OpenClaw Gateway
↓
大模型 API / 本地模型 / 工具 / 文件 / 浏览器自动化

它和普通聊天网页最大的区别是： OpenClaw 不只是聊天，它更像一个可以扩展工具和渠道的 AI 自动化中枢。

2. 安装前准备

2.1 系统要求

推荐系统：

Windows 10 / Windows 11
macOS
Linux
Windows WSL2

推荐运行环境：

Node.js：Node 24 推荐，Node 22.16+ 可用
内存：8GB 起步，16GB 更舒服
磁盘：至少 3GB 可用空间
网络：首次安装需要联网
浏览器：Chrome / Edge / Firefox 均可

2.2 你需要准备的东西

安装前建议准备：

2.3 新手推荐安装路线

如果你不知道该选哪种方式，就按下面来：

Windows 用户：PowerShell 官方脚本安装
macOS 用户：curl 官方脚本安装
Linux 用户：curl 官方脚本安装
Windows 进阶用户：WSL2 中用 Linux 脚本安装
已有 Node.js 的用户：npm install -g openclaw@latest

3. 推荐安装方式总览

本文重点讲官方脚本和 npm 安装。

4. Windows 安装教程

4.1 打开 PowerShell

在 Windows 上建议使用 PowerShell。

操作步骤：

打开后先检查 PowerShell 是否可用。

输入：

$PSVersionTable.PSVersion

能输出版本号即可。

4.2 临时放开脚本执行限制

如果你的系统限制脚本执行，可以先运行：

Set-ExecutionPolicy –Scope Process –ExecutionPolicy Bypass

这条命令只影响当前 PowerShell 窗口，关闭窗口后失效。

4.3 使用官方脚本安装

在 PowerShell 中运行：

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

这个命令会自动完成：

检测系统环境
安装或使用 Node.js
安装 OpenClaw
启动初始化向导

安装过程中可能需要你确认一些选项，按提示操作即可。

4.4 不自动进入初始化向导的安装方式

如果你只想安装 OpenClaw，不想立刻进入配置向导，可以运行：

& ([scriptblock]::Create((iwr –useb https://openclaw.ai/install.ps1))) –NoOnboard

之后手动初始化：

openclaw onboard —install-daemon

4.5 验证 Windows 安装结果

安装完成后，新开一个 PowerShell 窗口，执行：

openclaw —version

如果输出版本号，说明安装成功。

继续检查：

openclaw doctor

如果没有严重错误，就可以进入初始化。

5. macOS 安装教程

5.1 打开终端

打开 Launchpad，搜索：

Terminal

或使用快捷键 / Spotlight 搜索“终端”。

5.2 使用官方脚本安装

运行：

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

这个脚本会自动安装 OpenClaw，并启动初始化流程。

5.3 不自动进入初始化向导

如果你想先安装，后配置：

curl -fsSL https://openclaw.ai/install.sh | bash -s — –no-onboard

之后手动执行：

openclaw onboard –install-daemon

5.4 验证 macOS 安装结果

openclaw –version
openclaw doctor

如果命令可用，说明安装成功。

6. Linux 安装教程

Linux 用户可以直接用官方 bash 脚本安装。

6.1 更新系统软件包

Ubuntu / Debian：

sudo apt update
sudo apt install -y curl ca-certificates

CentOS / Rocky / AlmaLinux：

sudo dnf install -y curl ca-certificates

Arch Linux：

sudo pacman -Syu curl ca-certificates

6.2 运行官方安装脚本

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

6.3 如果不想自动初始化

curl -fsSL https://openclaw.ai/install.sh | bash -s — –no-onboard

然后：

openclaw onboard –install-daemon

6.4 验证 Linux 安装结果

openclaw –version
openclaw doctor

7. Windows WSL2 安装教程

WSL2 是 Windows 上的 Linux 子系统。对于需要长期运行工具、跑自动化脚本、做 AI 工作流的人，WSL2 通常比 Windows 原生命令行更舒服。

7.1 安装 WSL2

以管理员身份打开 PowerShell：

wsl —install

安装完成后重启电脑。

查看 WSL 状态：

wsl –l –v

如果看到 Ubuntu 并且版本是 2，说明 WSL2 可用。

7.2 进入 Ubuntu

wsl

进入后你会看到类似：

username@computer:~$

7.3 在 WSL2 中安装 OpenClaw

先更新系统：

sudo apt update
sudo apt install -y curl ca-certificates

运行安装脚本：

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

7.4 验证 WSL2 安装结果

openclaw –version
openclaw doctor

7.5 Windows 浏览器访问 WSL2 中的控制台

如果 Gateway 在 WSL2 中运行，通常可以在 Windows 浏览器访问：

http://127.0.0.1:18789/

如果打不开，先检查 Gateway 是否启动：

openclaw gateway status

然后重启：

openclaw gateway restart

8. npm 手动安装教程

如果你已经有 Node.js，可以用 npm 直接安装。

8.1 检查 Node.js 和 npm

node -v
npm -v

推荐：

Node 24
或 Node 22.16+

如果版本太低，建议先更新 Node.js。

8.2 npm 安装 OpenClaw

npm install -g openclaw@latest

也可以使用 pnpm：

pnpm add -g openclaw@latest

8.3 验证安装

openclaw –version

如果输出版本号，说明安装成功。

8.4 npm 安装失败怎么办？

如果出现权限问题，macOS/Linux 不建议直接乱用 sudo。可以先查看 npm 全局路径：

npm prefix -g

如果你熟悉 Node 环境，推荐用 nvm 管理 Node.js。

安装 nvm 后重新安装 Node：

nvm install 24
nvm use 24
npm install -g openclaw@latest

Windows 用户可以使用 nvm-windows，或者直接安装 Node.js 官方安装包。

9. 初始化 OpenClaw

安装 OpenClaw 只是第一步，真正能用还需要初始化。

9.1 运行初始化命令

openclaw onboard –install-daemon

这条命令的作用：

进入 OpenClaw 初始化向导
配置 Gateway
配置认证信息
配置默认模型
安装后台 daemon 服务
让 Gateway 可以持续运行

9.2 初始化时会让你配置什么？

常见配置项包括：

如果是第一次使用，可以按默认推荐选项继续。

9.3 什么是 –install-daemon？

–install-daemon 表示把 Gateway 安装成后台服务。

好处：

关闭终端后服务仍然运行
重启后更方便恢复
适合长期作为 AI 助手使用

如果不加这个参数，可能需要你手动启动服务。

10. 启动和打开控制台

10.1 查看 Gateway 状态

openclaw gateway status

如果显示 running / active / started 等状态，说明服务已经启动。

10.2 启动 Gateway

openclaw gateway start

10.3 重启 Gateway

openclaw gateway restart

修改配置后通常需要重启。

10.4 停止 Gateway

openclaw gateway stop

10.5 打开 Dashboard

openclaw dashboard

或者手动在浏览器打开：

http://127.0.0.1:18789/

如果 Dashboard 打开后可以正常聊天，说明安装流程已经基本完成。

11. 接入模型 API

OpenClaw 本身是 Gateway，不等于模型。你需要给它配置模型。

11.1 常见模型选择

11.2 API Key 填写原则

填写 API Key 时注意：

不要把 Key 发给别人
不要写进公开仓库
不要截图发群
不要放到 CSDN/GitHub 文章里

如果 Key 泄露：

立即删除旧 Key
重新创建新 Key
检查账户余额和调用记录

11.3 模型名要写对

模型名必须和平台文档一致。例如：

deepseek-chat
qwen-plus
gpt-4.1
claude-3-5-sonnet

不同平台模型名会变化，如果报错，优先检查模型名和 Base URL。

12. 可选：安装 Ollama 本地模型

如果你想让小龙虾调用本地模型，可以安装 Ollama。

12.1 安装 Ollama

访问：

https://ollama.com/

下载安装包并安装。

安装完成后检查：

ollama –version

12.2 下载本地模型

示例：

ollama pull qwen2.5:7b

查看已安装模型：

ollama list

运行测试：

ollama run qwen2.5:7b

12.3 在 OpenClaw 中使用 Ollama

初始化或配置模型时选择 Ollama，填写：

Base URL：http://127.0.0.1:11434
Model：qwen2.5:7b

注意模型名必须和：

ollama list

显示的一致。

修改配置后重启 Gateway：

openclaw gateway restart

13. 常见安装报错解决

13.1 报错：openclaw 不是内部或外部命令

Windows 常见：

'openclaw' 不是内部或外部命令，也不是可运行的程序或批处理文件。

原因：

OpenClaw 没装成功
npm 全局路径没加入 PATH
终端没有重新打开

解决：

npm config get prefix

找到 npm 全局目录，常见路径：

C:\\Users\\你的用户名\\AppData\\Roaming\\npm

把它加入系统环境变量 PATH，然后重新打开 PowerShell。

13.2 报错：PowerShell 不允许执行脚本

报错类似：

running scripts is disabled on this system

解决：

Set-ExecutionPolicy –Scope Process –ExecutionPolicy Bypass

然后重新运行安装命令。

13.3 报错：Node 版本太低

检查：

node -v

如果版本太低，升级到 Node 24 或 Node 22.16+。

13.4 报错：npm 权限不足

macOS/Linux 可能出现：

EACCES: permission denied

推荐解决方式：

nvm install 24
nvm use 24
npm install -g openclaw@latest

不建议随便使用：

sudo npm install -g openclaw

除非你清楚自己在做什么。

13.5 报错：Gateway 启动失败

先检查：

openclaw doctor
openclaw gateway status

尝试重启：

openclaw gateway restart

如果仍失败，检查：

端口是否被占用
配置文件是否写错
API Key 是否为空
Node 版本是否满足要求
防火墙是否拦截

13.6 控制台打不开

浏览器访问：

http://127.0.0.1:18789/

如果打不开：

openclaw gateway status
openclaw gateway restart

再检查本地防火墙。

13.7 模型一直不回复

排查顺序：

1. API Key 是否正确
2. Base URL 是否正确
3. 模型名是否正确
4. 账号是否有余额
5. 网络是否能访问模型平台
6. Gateway 是否重启

可以先换一个最基础的模型测试，避免因为高级模型名写错导致失败。

13.8 Ollama 能用，但 OpenClaw 调不通

检查：

ollama list

确认模型名。

测试 Ollama：

ollama run qwen2.5:7b

OpenClaw 里填写：

Base URL：http://127.0.0.1:11434
Model：qwen2.5:7b

然后：

openclaw gateway restart

14. 卸载与重装

14.1 npm 卸载

npm uninstall -g openclaw

如果用 pnpm：

pnpm remove -g openclaw

14.2 删除配置目录

配置通常位于：

~/.openclaw

Windows 可能是：

C:\\Users\\你的用户名\\.openclaw

谨慎删除：

rm -rf ~/.openclaw

Windows PowerShell：

Remove-Item –Recurse –Force "$env:USERPROFILE\\.openclaw"

注意：删除配置目录会清空 OpenClaw 相关配置、认证、缓存等信息。

14.3 重装流程

建议按这个顺序：

1. 停止 Gateway
2. 卸载 OpenClaw
3. 删除损坏配置，可选
4. 重新安装
5. 重新 onboard
6. 重新配置模型

命令示例：

openclaw gateway stop
npm uninstall -g openclaw
npm install -g openclaw@latest
openclaw onboard –install-daemon

15. 安全注意事项

OpenClaw 是能调用工具、文件、浏览器和外部渠道的 AI Agent，所以安装后一定要重视安全。

15.1 不要随便安装陌生 Skills

不要复制陌生网页里给出的安装命令，尤其是：

curl xxx | bash
powershell -enc xxx
npm install 某未知包
python -c "一长串代码"

安装第三方 Skills 前应检查：

来源是否可信
GitHub 是否开源
代码是否可读
是否要求输入钱包/浏览器/Cookie/私钥
是否执行混淆命令
是否要求关闭杀毒软件

15.2 不要暴露本地控制台

默认本地地址：

http://127.0.0.1:18789/

只允许本机访问较安全。

不要直接公网暴露：

0.0.0.0:18789

如果需要远程访问，建议用：

VPN
Tailscale
ZeroTier
SSH 隧道
带认证的反向代理

15.3 保护 API Key

不要把 API Key 写在：

截图
博客
GitHub
CSDN
群聊
公开配置文件

如果泄露，立即删除并重新生成。

15.4 权限最小化

建议：

不需要文件权限就不要开
不需要命令执行就不要开
不需要浏览器自动化就不要开
不需要公网访问就不要开

AI Agent 的能力越大，误操作和被诱导执行危险操作的风险越高。

16. 安装成功验收清单

安装完成后，逐项检查：

• openclaw –version 能输出版本号；
• openclaw doctor 没有严重错误；
• openclaw onboard –install-daemon 已执行；
• openclaw gateway status 显示 Gateway 正常；
• 浏览器能打开 http://127.0.0.1:18789/；
• Dashboard 能正常进入；
• 模型 API 已配置；
• 可以发送消息并收到回复；
• 如果使用 Ollama，ollama list 能看到模型；
• API Key 没有被公开；
• 没有把控制台直接暴露到公网。

17. 命令速查表

Windows 官方安装

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

Windows 安装但不自动初始化

& ([scriptblock]::Create((iwr –useb https://openclaw.ai/install.ps1))) –NoOnboard

macOS / Linux / WSL2 官方安装

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

macOS / Linux / WSL2 安装但不自动初始化

curl -fsSL https://openclaw.ai/install.sh | bash -s — –no-onboard

npm 安装

npm install -g openclaw@latest

pnpm 安装

pnpm add -g openclaw@latest

初始化

openclaw onboard –install-daemon

检查版本

openclaw –version

环境诊断

openclaw doctor

查看 Gateway 状态

openclaw gateway status

启动 Gateway

openclaw gateway start

重启 Gateway

openclaw gateway restart

停止 Gateway

openclaw gateway stop

打开控制台

openclaw dashboard

Ollama 下载模型

ollama pull qwen2.5:7b

Ollama 运行模型

ollama run qwen2.5:7b

18. 参考资料

• OpenClaw 官方安装文档：https://docs.openclaw.ai/install
• OpenClaw Getting Started：https://docs.openclaw.ai/start/getting-started
• OpenClaw Installer Internals：https://docs.openclaw.ai/install/installer
• OpenClaw GitHub：https://github.com/openclaw/openclaw
• Ollama 官网：https://ollama.com/
• Hello Claw 中文教程仓库：https://github.com/datawhalechina/hello-claw
• OpenClaw 中文指南：https://github.com/liyupi/openclaw-guide