OpenClaw 完整安装教程（2026最新版，全平台通用）

作者：CSDN博客

OpenClaw 是一款强大的 AI 助手工具，支持本地部署、多模型接入（含 GLM-4.6、Claude 等），可实现代码辅助、自动化工作流等核心能力。本文整理零基础友好、全平台兼容、可直接复制发布的安装指南，包含一键安装、手动安装、Docker 部署、GLM-4.6 模型配置及常见问题排查，新手也能 10 分钟快速上手。
一、系统与环境要求

macOS 12+Linux（Ubuntu 20.04+、Debian 11+、Fedora 38+）Windows 10/11

必须：Node.js v20+（推荐 v22 LTS）

---

二、安装 Node.js（全平台）

macOS

1. brew install node@22

复制代码

Linux（Ubuntu/Debian）

1. curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
2. sudo apt-get install -y nodejs

复制代码

Windows

官网下载安装包一路下一步：
https://nodejs.org/zh-cn/download/

验证安装

1. node -v
2. npm -v

复制代码

---

三、3 种安装方式（按需选一种）

方式 1：一键安装（新手首选）

macOS / Linux

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

复制代码

Windows（管理员 PowerShell）

以管理员身份运行 PowerShell：

按 Win 键，搜索 PowerShell右键点击 Windows PowerShell选择 以管理员身份运行点击 是 确认

在管理员 PowerShell 窗口中，依次执行以下两条命令：

1. Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
3. Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

复制代码

1. 这是什么意思？
2. 第一条命令：允许当前用户运行本地和下载的脚本
3. 第二条命令：允许当前用户运行本地和下载的脚本
4. 安全提示：这些命令只会影响您自己的账户，不会影响系统安全或其他用户。

复制代码

复制以下命令，粘贴到 PowerShell 窗口中，按 Enter 执行：

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

复制代码

方式 2：npm 手动安装

macOS / Linux

1. sudo npm install -g openclaw@latest

复制代码

Windows

1. npm install -g openclaw@latest

复制代码

sharp 安装失败（macOS 常用）

1. SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

复制代码

验证

1. openclaw --version

复制代码

---

方式 3：Docker 部署

1. docker run -d \
2.   --name openclaw \
3.   -p 3000:3000 \
4.   -v ~/.openclaw:/root/.openclaw \
5.   openclaw/openclaw:latest

复制代码

---

四、初始化配置（必做）

1. openclaw onboard

复制代码

按提示配置：

风险告知
这一步主要是告诉你，使用OpenClaw可能会有一些风险。请问你是否继续？按 向左方向键 ←，选择 Yes，按 Enter 回车确认选择 QiuickStart 模式配置 AI 模型 API Key
配置 GLM-4.7/GLM-4.6（重点步骤）：
输入智谱 AI API Key（从 智谱开放平台 获取：注册→登录→API 密钥管理→创建密钥）；




配置完 AI 模型后，OpenClaw 会询问你要连接哪个通讯平台？
暂时跳过，选择 skip for now选择Skills: 选择NO是否开启Hooks：选择 skip for now启动服务并打开UI界面

---

大功告成拉
五、启动与使用

1. 窗口 A：openclaw gateway → 保持打开
2. 另外打开一个窗口 B：openclaw dashboard → 自动打开网页

复制代码

Web 控制台：
http://localhost:3000

---

给大家提供了一个一键启动的脚本，桌面新建txt,复制下面这段代码，在修改后缀为"OpenClaw 网关启动.bat“,双击运行即可

1. @echo off
2. echo Using Node v22.12.0 via nvm...
3. nvm use 22.12.0 >nul
5. echo Starting OpenClaw Gateway...
6. openclaw gateway start

复制代码

六、常见问题

权限不足

macOS/Linux：加 sudoWindows：用管理员终端



• sharp 安装失败（macOS）
  bash
  1. brew install vips
  2. npm install -g openclaw@latest

  复制代码
  模型调用失败
  
  检查 API Key、Base URL、模型名执行 openclaw restart
  
  
  

配置完成后，即可在本地 Web 控制台、VS Code 中高效调用 GLM-4.6，实现 AI 辅助开发、自动化工作流等场景，大幅提升效率～

原文地址：https://blog.csdn.net/qq_44862208/article/details/158610272