【终极指南】全网最全OpenClaw安装教程（2026年最新版）

发布时间：2026年3月10日分类：AI动态浏览量：749

【终极指南】全网最全OpenClaw安装教程（2026年最新版）

发布时间： 2026年3月10日
适用系统： Windows 10/11, macOS (Intel/Apple Silicon), Linux (Ubuntu/Debian/CentOS)
目标读者：所有用户，从零基础小白到资深开发者

引言：为什么你需要一个本地AI助手？

在这个AI时代，你是否担心隐私泄露？是否厌倦了昂贵的API调用费？OpenClaw（原Clawdbot）就是你的终极解决方案！它是一个开源的、本地运行的AI代理框架，能将强大的AI模型（如Claude、GPT-4、DeepSeek、Qwen等）连接到你的即时通讯工具（如飞书、Telegram）或本地Web界面。

核心优势：

隐私至上：所有数据本地处理，不上传云端。
无限可能：通过安装“技能（Skills）”，它可以读写文件、执行代码、管理系统、操作Excel，甚至帮你自动写周报！
一次付费，终身使用：模型API按需调用，丰俭由人。

别再犹豫了，跟着这篇保姆级教程，半小时内让你的电脑拥有一个专属的AI超级大脑！

第一部分：安装前准备（必看！）

在开始之前，请确保你的系统环境满足以下要求。这是90%的安装失败原因！

项目	最低要求	推荐配置
操作系统	Windows 10/11 (64位), macOS 10.15+, Linux	Windows 11, macOS 12+, Ubuntu 22.04+
内存 (RAM)	4 GB	8 GB 或更高
磁盘空间	500 MB	1 GB+ (用于存放模型和技能)
核心依赖	Node.js v20+	Node.js v22 LTS (必须！)
网络	需访问 npm, GitHub	稳定连接，国内用户建议配置代理

步骤1：安装 Node.js
OpenClaw基于Node.js开发，这是最关键的一步。

Windows/macOS通用方法（推荐）：
访问 https://nodejs.org/zh-cn/download/，下载 LTS版本（长期支持版），如v22.x。下载后像安装普通软件一样，一路“下一步”即可。
Linux (Ubuntu/Debian) 方法：
添加 Node.js 22.x 源
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
安装 Node.js
sudo apt-get install -y nodejs
版本验证（所有系统通用）：
node -v
应输出 v22.x.x 或更高版本
npm -v
应输出 10.x.x 或更高版本
如果版本过低，请务必升级！

步骤2：安装 Git (可选但强烈推荐)
部分技能和源码安装需要Git。

Windows: 下载并安装 https://git-scm.com/download/win，安装时勾选 "Add to PATH"。
macOS: brew install git
Linux: sudo apt install git

第二部分：核心安装（四种方法，任选其一）

方法一：官方一键脚本（新手首选，3分钟搞定）

这是最简单、最推荐的方式，脚本会自动检测并安装所有依赖。

打开终端：
- macOS/Linux: 打开“终端 (Terminal)”。
- Windows: 按 Win + X，选择 “Windows PowerShell (管理员)” 或 “终端 (管理员)”。
执行安装命令：
- macOS / Linux / WSL2:bash1curl -fsSL https://openclaw.ai/install.sh | bash 2
- Windows (PowerShell):powershell1iwr -useb https://openclaw.ai/install.ps1 | iex 2
- 国内用户加速版（如果官方脚本慢）：bash1# macOS/Linux 2curl -fsSL https://open-claw.org.cn/install-cn.sh | bash 3# Windows 4iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex 5
脚本会自动下载并安装Node.js（如果未安装）、OpenClaw CLI，并引导你进入配置向导。

方法二：npm 手动安装（适合已装Node.js的用户）

如果你已经配置好Node.js环境，可以使用npm全局安装。

bash1# 全局安装OpenClaw
2npm install -g openclaw@latest
3
4# 国内用户建议切换镜像加速
5npm config set registry https://registry.npmmirror.com
6npm install -g openclaw@latest
7

安装完成后，运行 openclaw --version 验证，如果显示版本号则成功。

方法三：Docker 部署（服务器/隔离环境首选）

适合在服务器上部署，或不想污染本地系统环境的用户。需要先安装 https://www.docker.com/products/docker-desktop/。

bash1# 方式1：直接运行官方镜像
2docker run -d \
3  --name openclaw \
4  -p 3000:3000 \
5  -v ~/.openclaw:/root/.openclaw \
6  openclaw/openclaw:latest
7
8# 方式2：使用 docker-compose (更灵活)
9# 1. 创建 docker-compose.yml 文件
10# 2. 写入以下内容
11version: '3.8'
12services:
13  openclaw:
14    image: openclaw/openclaw:latest
15    container_name: openclaw
16    ports:
17      - "3000:3000"
18    volumes:
19      - ~/.openclaw:/root/.openclaw
20    restart: unless-stopped
21# 3. 在文件目录下运行 docker-compose up -d
22

注意： Docker方式需要后续进入容器执行 docker exec -it openclaw bash 然后运行 openclaw onboard 进行配置。

方法四：源码安装（开发者/贡献者）

适合想二次开发或体验最新功能的极客。

bash1# 1. 克隆仓库
2git clone https://github.com/openclaw/openclaw.git
3cd openclaw
4
5# 2. 安装依赖并构建
6pnpm install
7pnpm ui:build
8pnpm build
9
10# 3. 全局链接并启动配置
11pnpm link --global
12openclaw onboard --install-daemon
13

第三部分：初始化配置（核心步骤）

安装完成后，必须运行初始化向导来配置模型、网关和技能。

启动配置向导：
在终端中运行以下命令，它会帮你安装后台守护进程（开机自启）。bash1openclaw onboard --install-daemon 2
跟随向导提示操作（新手推荐路径）：
- 风险确认： 看到一大段ASCII画和警告，别慌！这是在提醒你OpenClaw功能强大但也有风险。输入 Yes 并回车确认。
- 引导模式选择： 选择 ✅ QuickStart (快速启动)，这对新手最友好。
- 模型来源选择：
  - 新手/想省事： 选择你已有Key的厂商，如 Qwen (阿里云，有免费额度)。
  - 需要多模型切换： 推荐 OpenRouter 或 Custom Provider。
  - 想免费体验： 选择 Qwen，然后按提示跳过API Key配置，先用Web UI体验。
- 配置模型： 如果选择了自定义提供商，需要手动输入API Base URL、API Key等。对于国内用户，可以选择 Custom Provider，然后配置 DashScope (阿里云) 或 Moonshot (Kimi) 等。
- 技能 (Skills) 配置： 向导会问是否现在安装常用技能。新手推荐先跳过，后续按需安装。选择 No。
- 自动化小助手： 选择 ✅ session-memory (会话记忆) 和 ✅ boot-md (启动时加载Markdown)，这两个非常实用。
- 重启服务： 选择 ✅ Restart，让配置生效。
- 启动方式： 选择 ✅ Hatch in TUI (在终端界面启动) 或 ✅ Open Dashboard (直接打开网页)。新手推荐 Hatch in TUI，之后再手动打开网页。

第四部分：启动使用与技能扩展

打开Web UI 控制台：
配置完成后，在终端输入：bash1openclaw dashboard 2浏览器会自动打开控制面板，地址通常是 http://127.0.0.1:18789。如果没有自动打开，终端会显示完整的URL，包含一个token，复制到浏览器访问即可。
安装必备技能（让OpenClaw更强大）：
OpenClaw的强大之处在于其可扩展的“技能”。打开一个新的终端窗口，运行以下命令安装常用技能：bash1# 办公助手 (自动写周报、提炼文档、生成PPT) 2openclaw skills install @openclaw/office 3 4# 代码工具 (生成代码、解释逻辑、排查错误) 5openclaw skills install @openclaw/code 6 7# 文件管理 (批量重命名、格式转换、内容提取) 8openclaw skills install @openclaw/file 9 10# 系统优化 11openclaw skills install @openclaw/system 12安装后直接生效，无需重启！
连接即时通讯工具（以飞书为例）：
- 飞书端： 登录飞书开发者后台，创建“企业自建应用”，获取App ID和App Secret，并在“事件与回调”中配置长连接和接收消息事件。
- OpenClaw端： 运行 openclaw config，在 Channels -> Link 中选择 feishu，粘贴App ID和Secret，按提示完成配置。
- 重启网关：openclaw gateway start。
- 现在，你可以在飞书里直接@你的AI机器人并与它对话了！

第五部分：常用命令与问题排查

常用命令速查表：

openclaw --version: 查看版本
openclaw dashboard: 启动Web UI
openclaw onboard: 重新运行配置向导
openclaw gateway start/stop/status: 管理网关服务
openclaw skills list: 查看已安装技能
openclaw skills install <skill-name>: 安装技能
openclaw uninstall --all --yes: 彻底卸载

常见问题 (FAQ)：

Q: 安装时提示 node 版本错误？
- A: 你的Node.js版本太低了！必须升级到v20以上，强烈推荐v22 LTS。使用 nvm (Node Version Manager) 可以轻松管理多个Node版本。
Q: npm install 速度极慢或失败？
- A: 网络问题。切换npm镜像源：npm config set registry https://registry.npmmirror.com。
Q: 浏览器无法访问 127.0.0.1:18789？
- A: 检查端口是否被占用，或网关服务是否启动。尝试重启网关：openclaw gateway restart。
Q: 模型无法连接？
- A: 检查API Key是否正确、有效，以及网络是否能访问模型服务商的API。国内用户访问OpenAI等服务可能需要代理。

第六部分：卸载与清理

如果想彻底移除OpenClaw：

官方卸载命令（首选）：bash1openclaw uninstall --all --yes --non-interactive 2
手动清理（如果命令失效）：
- 停止并卸载网关服务（Windows需用sc命令）。
- 删除配置文件目录：~/.openclaw (Linux/macOS) 或 C:\Users\<用户名>\.openclaw (Windows)。
- 删除全局npm包：npm uninstall -g openclaw。