2026年OpenClaw（龙虾）保姆级Linux安装

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

OpenClaw的安装是一个跨平台的系统工程，其核心依赖于Node.js环境，并涉及CLI工具安装、API配置、服务启动等多个环节。根据【参考资料】，不同操作系统（Windows， Linux/macOS/WSL2）的安装流程和具体命令存在差异 [ref_1][ref_2][ref_3][ref_4][ref_5]。以下将遵循环境准备 → 核心安装 → 初始化配置 → 功能验证的完整逻辑链，为你提供一份详尽的保姆级教程，涵盖命令、配置和常见问题排查。

一、核心安装流程总览

为清晰对比不同平台的方案，下表汇总了关键步骤的差异与执行要点。

步骤	Windows (PowerShell)	Linux / macOS / WSL2 (Bash)	核心目的与备注
1. 环境准备	安装 Node.js (≥ v22 LTS), Git, (可选) Ollama [ref_2]	安装 Node.js (≥ v22) 和 Git [ref_3][ref_4]	为 OpenClaw 提供运行时和包管理支持。
2. 核心安装	官方 PowerShell 脚本 [ref_4] 或 Chocolatey [ref_3]	官方 Bash 脚本 (`curl ...`) [ref_1][ref_4] 或 Docker [ref_4]	安装 `openclaw` CLI 命令行工具。
3. 配置 API	运行 `openclaw onboard` 交互配置，或手动编辑配置文件 [ref_2]	运行 `openclaw onboard` 交互配置，或手动编辑配置文件 [ref_5]	接入 Kimi、Moonshot、MiniMax、阿里云百炼等大模型服务 [ref_1][ref_2]。
4. 启动服务	执行 `openclaw start` 启动 Gateway 服务和 Dashboard [ref_2]	执行 `openclaw start` 启动 Gateway 服务和 Dashboard [ref_1][ref_3]	启动本地服务，提供 Web 控制台 (`http://localhost:3000`) 和 API 网关。
5. 功能验证	通过 Web 界面对话或 CLI 测试文件操作、代码生成 [ref_5][ref_6]	通过 Web 界面对话或 CLI 测试文件操作、代码生成 [ref_4][ref_6]	确认 AI 助手能正常响应并执行任务。

二、分平台详细安装步骤

2.1 Windows 平台安装 (以 PowerShell 为例)

环境准备：安装 Node.js 和 Git 首先，确保你的系统已安装 Node.js v22 或更高版本的 LTS 版以及 Git。如果未安装，可从官网下载安装。安装后，在 PowerShell 中验证版本 [ref_2]。
```
# 验证Node.js和Git是否已正确安装 node --version git --version 
```
*(可选) 安装 Ollama*：如果你想使用本地大模型（如 Qwen），可以安装 Ollama [ref_5]。
核心安装：使用官方一键脚本 (推荐) 在 以管理员身份运行 的 PowerShell 中执行以下命令。脚本会自动处理依赖和安装 [ref_4]。
```
# 使用curl下载并执行官方PowerShell安装脚本 curl -fsSL https://install.openclaw.org/install.ps1 | powershell -ExecutionPolicy Bypass -c 
```
如果遇到执行策略错误，可以先运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 允许脚本执行 [ref_4]。
替代方案：通过 Chocolatey 安装 如果你已使用 Chocolatey 包管理器，安装会更简便 [ref_3]。
```
# 使用choco命令一键安装OpenClaw choco install openclaw 
```
验证安装与初始化配置 安装完成后，重新打开一个新的 PowerShell 终端，验证 CLI 工具。
```
# 检查openclaw命令行工具版本，确认安装成功 openclaw --version 
```
首次使用，需要运行配置向导来设置 AI 模型 API。这会引导你配置如硅基流动、阿里云百炼等平台的 API Key [ref_2][ref_5]。
```
# 启动交互式配置向导，按提示填入你的API密钥等信息 openclaw onboard 
```

**2.2 Linux / macOS / WSL2 平台安装 (以 Ubuntu/macOS Bash 为例)**

环境准备：安装 Node.js 22+ 系统自带的 Node.js 版本可能较低，建议使用 NodeSource 或 nvm 安装指定版本 [ref_3][ref_4]。

# 对于Ubuntu/Debian系统，使用NodeSource仓库安装Node.js 22.x curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs # 对于macOS，推荐使用Homebrew安装最新的Node.js (v24/v27-29) [ref_1] # brew install node

核心安装：使用官方一键脚本 (推荐) 这是最快捷的安装方式，脚本会自动下载并安装 CLI [ref_1][ref_4]。
```
# 下载并执行安装脚本 curl -fsSL https://install.openclaw.org/install.sh | sh 
```
安装完成后，可能需要重启终端或执行 source ~/.bashrc (或 ~/.zshrc) 使命令生效。

验证安装与初始化配置 验证 CLI 并运行配置向导，步骤与 Windows 类似。

# 验证安装 openclaw --version # 运行配置向导，配置你的大模型API（如Kimi, Moonshot, MiniMax）[ref_1][ref_5] openclaw onboard

Docker 部署方案 (适用于 Linux/macOS) 对于偏好容器化的环境，可以使用 Docker 运行 OpenClaw，这能有效隔离环境依赖 [ref_4]。首先确保已安装 Docker，然后执行：
```
# 拉取并运行OpenClaw容器（此处为示例，具体端口映射和数据卷挂载请参考官方镜像文档） docker run -d -p 3000:3000 --name openclaw openclaw/openclaw:latest 
```
运行后，可通过 http://localhost:3000 访问 Web 界面。

三、通用配置与启动

配置 API Keys openclaw onboard 是主要的交互式配置方式。你也可以手动编辑配置文件（通常位于 ~/.openclaw/config.json 或项目目录下），直接填入从各 AI 平台（如 Kimi、MiniMax、硅基流动、阿里云百炼、GPT、Claude 等）获取的 API Key 和 Base URL [ref_1][ref_2][ref_5]。一个简化的配置示例如下：
```
{ "modelProviders": { "minimax": { "apiKey": "你的-MiniMax-API-KEY", "baseURL": "https://api.minimax.chat/v1" }, "moonshot": { "apiKey": "你的-Moonshot-API-KEY" } } } 
```
启动服务与访问 Web 控制台 配置完成后，即可启动 OpenClaw 的网关服务和 Web 仪表盘 [ref_1][ref_2]。
```
# 启动所有服务（Gateway, Dashboard等） openclaw start 
```
命令执行后，终端会输出服务访问地址，通常是 http://localhost:3000。在浏览器中打开此地址，即可进入 OpenClaw 的 Web 可视化控制台，开始与你的“私人贾维斯”对话 [ref_6]。
核心功能验证示例 为了确认安装成功且 AI 助手功能正常，可以进行一个简单测试。例如，让 OpenClaw 总结一个本地文件的内容 [ref_5]。
- 在 Web 界面：直接输入自然语言指令，如“请总结我桌面上的 report.txt 文件内容”。
- 通过 CLI：虽然主要交互在 Web 界面，但你可以验证 CLI 功能。此测试能同时验证其文件系统访问能力和 AI 推理能力。

四、常见问题与故障排查

问题现象	可能原因	解决方案
`openclaw` 命令未找到	1. 安装后未重启终端。 2. 安装路径未加入系统 PATH。	1. 关闭并重新打开所有终端窗口。 2. 手动检查并添加安装路径到环境变量。
`curl` 安装脚本执行失败	1. 网络连接问题。 2. 系统权限不足（Linux/macOS 需要 `sh` 执行权限）。	1. 检查网络，或尝试使用代理。 2. 在 Linux/macOS 可尝试 `curl …
`onboarding` 配置 API Key 后服务无法调用模型	1. API Key 填写错误或已失效。 2. 对应的模型服务商网络不可达。 3. 配置文件路径或格式错误。	1. 在 AI 平台控制台重新生成并复制正确的 API Key [ref_5]。 2. 检查网络连通性。 3. 检查 `~/.openclaw/config.json` 文件格式是否正确。
Web 界面 (`localhost:3000`) 无法访问	1. `openclaw start` 服务未成功启动。 2. 端口 3000 被其他程序占用。	1. 查看 `openclaw start` 命令输出是否有错误日志。 2. 更换端口启动，例如 `openclaw start --port 8080` (如果支持该参数)，或终止占用端口 3000 的进程。
在 WSL2 中 `systemctl --user` 相关服务启动失败	WSL2 默认不启用 systemd。	参考 WSL2 特定教程，通过修改 `/etc/wsl.conf` 启用 systemd，或使用 `--user` 标志及 `lingering` 设置来管理用户级服务 [ref_5]。