【保姆级教程】手把手教你安装openclaw

说来惭愧，第一次在网上刷到 OpenClaw 这个名字的时候，我下意识以为是个独立游戏——毕竟 logo 是一只像素风的太空龙虾🦞，谁能想到它其实是个正儿八经的开源 AI 智能体网关？简单来说，OpenClaw 能把你的电脑变成一个 7×24 小时运转的 AI 私人助手。它运行在本地，能对接各种大模型（Claude、GPT、DeepSeek、Kimi、Qwen 都行），还能绑定飞书、Teleg

一天一杯冰美式

2541人浏览 · 2026-03-09 21:24:41

一天一杯冰美式 · 2026-03-09 21:24:41 发布

前言：我是怎么入坑 OpenClaw 的

说来惭愧，第一次在网上刷到 OpenClaw 这个名字的时候，我下意识以为是个独立游戏——毕竟 logo 是一只像素风的太空龙虾🦞，谁能想到它其实是个正儿八经的开源 AI 智能体网关？

简单来说，OpenClaw 能把你的电脑变成一个 7×24 小时运转的 AI 私人助手。它运行在本地，能对接各种大模型（Claude、GPT、DeepSeek、Kimi、Qwen 都行），还能绑定飞书、Telegram、WhatsApp、Discord 等聊天工具。也就是说，你在手机上发条消息，家里的电脑就能帮你干活——写代码、管文件、抓网页、发通知……相当炸裂。

我折腾了大概一个周末，终于把它跑通了。这篇文章就把整个安装过程原原本本地记录下来，Mac 和 Windows 都会覆盖到，希望能帮后来的朋友少踩一些坑。

一、装之前先搞清楚几个问题

1.1 OpenClaw 到底是个啥？

引用官方的描述：

OpenClaw 是适用于任何操作系统的 AI 智能体 Gateway 网关，支持 WhatsApp、Telegram、Discord、iMessage 等。
翻译成人话就是：它是一个本地运行的 AI 调度中心。你通过聊天工具给它发指令，它调用 AI 模型帮你完成任务，然后把结果回传给你。所有数据都存在你自己的电脑上，隐私可控。

它不是一个大模型本身，而是一个连接你和各种大模型的桥梁 + 执行器。

1.2 硬件要求高吗？

完全不高。AI 推理是交给云端模型的，OpenClaw 本身就是个 Node.js 应用，要求很低：

项目	最低要求	推荐配置
CPU	随便，能亮机就行	—
内存	8GB	16GB
硬盘	10GB 可用空间	—
Node.js	≥ 22（重要！）	22.x LTS
网络	能上网	稳定网络

1.3 系统怎么选？

系统	推荐指数	备注
macOS	⭐⭐⭐⭐⭐	官方首推，能调用日历、备忘录等系统能力
Linux	⭐⭐⭐⭐	服务器部署首选
Windows (WSL2)	⭐⭐⭐⭐	体验接近原生 Linux
Windows (原生)	⭐⭐⭐	能用，但可能踩坑

我个人的主力环境是 Mac，备机用的 Windows + WSL2，两条路线下面都会详细说。

二、macOS 安装全过程

Mac 上装 OpenClaw 是体验最丝滑的，基本一行命令搞定。

2.1 打开终端

Command + 空格 → 输入 Terminal → 回车。用 iTerm2、Warp 之类的第三方终端也完全 OK。

2.2 一键安装

复制下面这行命令，粘贴到终端里回车：

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

这个安装脚本会自动帮你做以下几件事：

检测系统环境
如果没有 Node.js 22+，帮你装一个
全局安装 OpenClaw CLI
配置好环境变量
整个安装过程大概 2-5 分钟。安装完成后，脚本会自动进入新手引导（onboard），不需要你手动执行其他命令——终端会直接弹出配置向导的交互界面，需要你手动同意后继续。

⚠️ 踩坑提示：如果你之前用 Homebrew 装过全局的 libvips，可能会导致 sharp 模块编译失败。遇到这种情况，用这条命令代替：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
openclaw onboard --install-daemon

2.3 新手引导配置（重头戏）

接上一步，安装脚本跑完后会直接进入引导界面。下面把每一步的选择逻辑理一下：

1.接受风险提示

选 Yes，继续。
在这里插入图片描述

2.选择启动模式

推荐选 QuickStart，省事。除非你是要做二次开发，否则不需要选 Hackable 模式。
选择QuickStart后按下回车键
3.选择 AI 模型提供商

推荐一个我写代码都在用的API站，支持Claude Code，Codex，Gemini，稳定性高，速度快，价格实惠。
https://portunex.gewulabs.group
追求顶级效果的同学可以使用：Claude Opus 4.6 或 GPT-5.4。
我这里选择的是Claude的模型，这里选择跳过，我们使用配置文件来配置。
在这里插入图片描述

4.接入飞书
选择飞书后会让下载飞书的
在这里插入图片描述
选完之后跟着提示填入你申请的飞书机器人的凭证即可。
下面几个选项这样选即可

Gateway 端口
默认 18789，直接回车就好。除非这个端口被占用了才需要改。
选择 Skills（技能包）

用空格键勾选你需要的，按回车确认。我第一次装的时候也没想好要用什么，直接跳过了，后面再按需安装。

启用 Hooks

建议启用。Hooks 可以做内容引导、日志记录和会话管理，对后续调试很有帮助。

输入 API Key
我们找到这个文件 /Users/自己用户名/.openclaw/openclaw.json 添加以下配置，apiKey是在之前提过的网站中创建的。

"models": {
    "providers": {
      "claude-relay": {
        "baseUrl": "https://api.portunex.gewulabs.group",
        "apiKey": "ptx_xxxxxx",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }

这样就算配置好模型了

2.4 验证一切正常

向导跑完、Gateway 启动之后，来确认一下安装状态：

# 看看版本号，确认 CLI 装好了
openclaw --version

# 检查渠道连接
openclaw channels status

出现OpenClaw 2026.3.8 (3caab92)和Gateway reachable.就说明一切正常了。
在控制台输入：

# 进入web控制页面
openclaw dashboard

2.5 日常使用的几条常用命令

# 启动 Gateway
openclaw gateway start

# 设置开机自启（推荐，省心）
openclaw gateway enable

# 停止 Gateway
openclaw gateway stop

# 检查健康状态
openclaw doctor
openclaw status
openclaw health

# 更新到最新版
openclaw update

# 打开 Web 仪表板
openclaw dashboard

至此，Mac 上的 OpenClaw 就完全跑起来了。

三、Windows 安装全过程

Windows 上有两种方案，我都试过，各有优劣。

方案 A：WSL2 + Ubuntu（推荐）

这是官方推荐的方式，本质上是在 Windows 里跑一个 Linux 环境。体验和原生 Linux 基本一致，坑最少。

步骤 1：启用 WSL2

以管理员身份打开 PowerShell（右键开始菜单 → Windows Terminal (管理员)），执行：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
wsl --set-default-version 2

然后重启电脑。这一步必须重启，不能跳过。

步骤 2：安装 Ubuntu

打开 Microsoft Store
搜索 Ubuntu 22.04 LTS（或 24.04 LTS）
点击「获取」安装
首次启动时设置用户名和密码（Linux 内部用的，随便设）
步骤 3：更新系统 & 安装依赖

在 Ubuntu 终端里执行：

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git wget build-essential

步骤 4：安装 Node.js 22

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

验证：

node -v   # 应该是 v22.x.x
npm -v    # 应该是 10.x.x

步骤 5：安装 OpenClaw & 完成引导

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

和 Mac 一样，脚本跑完会自动进入新手引导，跟着向导走就行，配置流程完全相同。

步骤 6：从 Windows 浏览器访问

向导完成后 Gateway 会自动启动，Windows 主系统可以直接访问。在浏览器打开：

http://localhost:18789

就能看到控制界面了。

💡 小技巧：可以在桌面创建一个 start-openclaw.bat：

@echo off
echo Starting OpenClaw Gateway in WSL2...
wsl -d Ubuntu-22.04 -u root service openclaw start
timeout /t 3
start http://localhost:18789

双击就能一键启动，非常方便。

方案 B：PowerShell 原生安装

不想折腾 WSL？也行。直接在 Windows 里装。

步骤 1：安装 Node.js

去 Node.js 官网下载 22.x LTS 的 Windows 安装包，一路 Next。

安装时记得勾选「自动安装必要的工具」（Automatically install the necessary tools）。

验证：

node -v
npm -v

步骤 2：安装 OpenClaw

有两种方式，选一个就行：

方式一：一键脚本（推荐）

用管理员身份打开 PowerShell，执行：

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

脚本会自动处理安装并进入新手引导。

方式二：手动 npm 安装

npm install -g openclaw@latest
openclaw onboard --install-daemon

想用中文汉化版的话：

npm install -g @qingchencloud/openclaw-zh@latest
openclaw onboard --install-daemon

手动安装时，引导不会自动启动，需要自己执行 openclaw onboard --install-daemon。

步骤 3：解决可能的权限问题

Windows 上最常踩的坑就是权限。如果安装报错，按顺序试这几条：

# 1. 允许执行脚本
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# 2. 修改 npm 全局目录（避免权限冲突）
npm config set prefix "C:\npm"
npm config set cache "C:\npm-cache"

# 3. 把新目录加到系统 PATH
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\npm", "User")

改完之后一定要关掉 PowerShell 重新打开再试。
Windows 常见问题速查

问题	解决方案
sharp 模块加载失败	npm cache clean --force 然后重装
Windows Defender 拦截	把 %APPDATA%\npm 和 %USERPROFILE%.openclaw 加到排除列表
openclaw: command not found	检查 npm prefix -g 的路径是否在 PATH 里
Gateway 启动后浏览器打不开	检查防火墙是否放行了 18789 端口

四、API 配置详解

OpenClaw 本身不包含 AI 模型，需要你接入一个。这一步直接决定了你的使用体验。

4.1 零配置方案（新手首选）

在 onboard 向导里直接选 qwen，浏览器会跳转到通义千问的授权页面，登录一下就能用。

优点：零门槛，不需要申请任何 Key 缺点：每天免费额度有限，超了就要等第二天

适合想赶紧体验一下的同学。

4.2 自配 API Key（推荐长期使用）

打开网页https://portunex.gewulabs.group注册后。
创建一个apiKey，配置到文件中即可使用了。

4.3 配置文件位置

~/.openclaw/openclaw.json

五、推荐安装的技能

必装（日常 90% 场景靠这几个）

技能	安装命令	干嘛用的
Tavily Web Search	clawhub install tavily-search	联网搜索，比内置搜索质量好很多（需要去 tavily.com 免费申请 API Key）
Summarize	clawhub install summarize	丢个链接/PDF/视频给它，直接出摘要。日用神器
self-improving-agent	clawhub install self-improving-agent	让 OpenClaw 记住你的习惯和纠错，越用越聪明
GitHub	clawhub install github	管理 issues、PR、CI，开发者必备