「2026最新版」0基础保姆级 OpenClaw 完整版本地部署教程｜Windows / macOS / Linux 全平台保姆级教程｜小白如何在电脑装配小龙虾

共计 3105 个字符，预计需要花费 8 分钟才能阅读完成。

目录

• 什么是OpenClaw
• 环境与依赖
• 安装 Node.js（已安装可跳过）

🍟 什么是OpenClaw

OpenClaw 是一个注重隐私与本地化部署的开源 AI 代理框架，其设计遵循“本地优先、安全可控”的原则。不同于常见的对话型 AI，OpenClaw 能深入你的工作流，实现更实际的自动化操作：

• 📂 直接读写本地文件，协助处理文档与数据
• ⚙️ 执行系统指令，完成实际任务
• 🔌 连接各类第三方 API，集成多样化工具
• 💬 支持接入飞书、钉钉、QQ、Telegram 等即时通讯平台
• 🤖 兼容多种主流大模型，包括 OpenAI、Kimi、智谱 GLM、Claude 等

总的来说，OpenClaw 是一款能在您自己电脑上运行的“全能型 AI 助手”，所有操作与数据都留在本地，确保您的隐私安全无虞。

🍔 准备工作

OpenClaw只是一个执行者，它背后需要依托一个为他思考的大模型，我们需要任意一个大模型的 Api 装配给他，以下Api任选一个。

国外大模型：

DeepSeek: https://platform.deepseek.com/
Minimax: https://minimaxi.com/
GLM：https://open.bigmodel.cn/
Moonshot（Kimi）：https://platform.moonshot.cn/
Mimo：https://platform.xiaomimimo.com/

国产大模型：

OpenAI：https://platform.openai.com/
Gemini：https://aistudio.google.com/
Claude：https://platform.claude.com/

🥟 环境与依赖

🎂 安装 Node.js（已安装可跳过）

Windows 用户

1️⃣ 安装 NVM for Windows

 到 nvm-windows releases 下载最新版 nvm-setup.exe，双击安装即可。点击跳转

2️⃣ 安装 Node.js 22

以管理员身份打开 PowerShell，依次执行：

nvm install 22.22.0
nvm use 22.22.0

3️⃣ 验证安装

node -v
# 输出：v22.22.0
npm -v
# 输出：10.x.x

macOS / Linux 用户

1️⃣ 使用 nvm 安装

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重载配置
source ~/.bashrc   # 或 source ~/.zshrc

# 安装 Node.js 22
nvm install 22
nvm use 22
nvm alias default 22

2️⃣ 直接下载安装包

去 Node.js 官网 下载对应平台安装包，按提示安装。

node -v   # v22.x.x
npm -v    # 10.x.x

安装 OpenClaw（OpenClaw 提供三种安装方式，根据你的使用场景选择）

1️⃣ 一键脚本安装（建议小白用这个方法）

Mac / Linux / WSL2 用户：

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

打开 Windows PowerShell 管理员模式（依次输入代码）

# 先放开执行策略
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

# 执行安装命令
iwr -useb https://openclaw.ai/install.ps1 | iex

2️⃣ npm 手动安装（如果网络无法访问安装脚本，可以尝试 npm 手动安装）

# 全局安装
npm install -g openclaw@latest

# 安装后初始化
openclaw onboard --install-daemon

pnpm 用户

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

3️⃣ Docker 部署（适合服务器 / 进阶用户）

如果自己本身有云服务器或 VPS，推荐用 Docker 部署，更加稳定且易于管理

docker run -d \
--name openclaw \
--restart unless-stopped \
-p 18789:18789 \
-v ~/.openclaw:/root/.openclaw \
openclaw/openclaw:latest

使用 Docker Compose 管理（推荐）

# docker-compose.yml
version: "3.8"
services:
openclaw:
image: openclaw/openclaw:latest
container_name: openclaw
restart: unless-stopped
ports:
- "18789:18789"
volumes:
- ~/.openclaw:/root/.openclaw
docker compose up -d

4️⃣ 从源码克隆构建

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖（需要 pnpm）
npm install -g pnpm
pnpm install

# 构建
pnpm ui:build
pnpm build

# 全局链接
pnpm link --global

# 初始化
openclaw onboard --install-daemon

🍳 初始化配置（onboard）

安装完成后，必须运行以下命令进行初始化：

openclaw onboard

接下来终端会弹出以下向导，可以按照以下流程操作：

Do you understand and accept the risk disclosure? →  Yes
Please select a startup mode →  QuickStart
Please configure the AI ​​model API Key → 输入你的 API Key
Communication Platform Configuration →  skip for now
Install the Skills extension package→  NO
Hooks Configuration →  skip for now

启动服务

1️⃣ 打开终端，启动网关

openclaw gateway

2️⃣ 网关窗口不要关闭，接下来新开一个终端，打开 Dashboard

openclaw dashboard

输入完代码后会自动打开浏览器，访问地址为：http://127.0.0.1:XXXX
也可以手动打开浏览器，输入该地址访问。