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

brew install node@22

Linux（Ubuntu/Debian）

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

Windows

官网下载安装包一路下一步：

https://nodejs.org/zh-cn/download/

验证安装

node -v
npm -v

---

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

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

macOS / Linux

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

Windows（管理员 PowerShell）

以管理员身份运行 PowerShell：

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

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

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

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

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

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

方式 2：npm 手动安装

macOS / Linux

sudo npm install -g openclaw@latest

Windows

npm install -g openclaw@latest

sharp 安装失败（macOS 常用）

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

验证

openclaw --version

---

方式 3：Docker 部署

docker run -d \
  --name openclaw \
  -p 3000:3000 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

---

四、初始化配置（必做）

openclaw onboard

按提示配置：

1. 风险告知
   这一步主要是告诉你，使用OpenClaw可能会有一些风险。请问你是否继续？按 向左方向键 ←，选择 Yes，按 Enter 回车确认
2. 选择 QiuickStart 模式
3. 配置 AI 模型 API Key
   配置 GLM-4.7/GLM-4.6（重点步骤）：
   输入智谱 AI API Key（从 智谱开放平台 获取：注册→登录→API 密钥管理→创建密钥）；
   
4. 配置完 AI 模型后，OpenClaw 会询问你要连接哪个通讯平台？
   暂时跳过，选择 skip for now
5. 选择Skills: 选择NO
6. 是否开启Hooks：选择 skip for now
7. 启动服务并打开UI界面
   

---

大功告成拉

五、启动与使用

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

Web 控制台：

http://localhost:3000

---

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

@echo off
echo Using Node v22.12.0 via nvm...
nvm use 22.12.0 >nul

echo Starting OpenClaw Gateway...
openclaw gateway start

六、常见问题

1. 权限不足

   • macOS/Linux：加 sudo
   • Windows：用管理员终端

2. sharp 安装失败（macOS）
   bash

   brew install vips
   npm install -g openclaw@latest
   

3. 模型调用失败

   • 检查 API Key、Base URL、模型名
   • 执行 openclaw restart

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