OpenClaw(龙虾) 安装教程:Mac 和 Windows 保姆级部署指南

今天这篇文章，我就来手把手带大家把 OpenClaw 装起来。Mac 用户和 Windows 用户都照顾到了，跟着走就行。

Mac OS

开始之前，先搞清楚几件事

选什么系统？

系统	推荐程度	说明
Mac	强烈推荐	体验最好，能调用日历、备忘录、截图等系统功能
Windows	完全可用	推荐用 WSL2 跑，体验接近 Mac
Linux	适合折腾	开发者的老朋友了，不多说

简单来说：有 Mac 就用 Mac，没有 Mac 用 Windows 也完全没问题。

聊天工具怎么选？

国内用户
：推荐飞书，API 完善、消息稳定、免费版够用
海外用户
：推荐 Telegram，Bot 生态最强、功能最全

当然，企业微信、钉钉、QQ 也都支持，只是配置稍微麻烦一点。

Windows 部署

硬件要求

别担心，OpenClaw 本身不吃配置，AI 推理都是云端完成的：

CPU
：正常能用就行
内存
：8GB 起步（推荐 16GB）
硬盘
：留 10GB 空间
网络
：能上网就行（需要调 API 嘛）

Mac 安装教程

Mac 上装 OpenClaw 是最省心的，基本上一行命令搞定。

第一步：打开终端

按 Command + 空格，输入 Terminal，回车，终端就出来了。

开发工具

如果你用 iTerm2 之类的第三方终端也完全 OK。

第二步：一键安装

在终端里粘贴这行命令，回车：

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

这个脚本会自动帮你：

检测系统环境
安装 Node.js（如果你没装的话）
下载 OpenClaw
配好环境变量

整个过程大概 2-5 分钟，泡杯咖啡的功夫就好了。

第三步：确认装好了

openclaw --version

如果终端输出了版本号（比如 2026.2.9），恭喜你，装好了。

AI 自动化平台

第四步：初始化配置

这一步是重头戏，运行配置向导：

openclaw onboard

向导会一步步问你以下内容：

1. 接受风险提示 —— 选 Yes，放心往下走。

2. 选择启动模式 —— 推荐选 QuickStart，省事。

3. 选择 AI 模型 —— 这里划重点：

新手怕麻烦的话，直接选 qwen（通义千问）就行！ 选了之后会自动跳转到 Qwen 的登录页面，授权一下就完事了，不需要自己去申请什么 API Key。这是最省心的方式，适合想赶紧用起来的同学。

不过要注意：Qwen 免费额度每天问答次数有限，超了之后机器人会提示你。如果你用得比较频繁，还是建议后面配一个自己的 API Key。

AI 工具

想自己配 Key 的话，国内推荐这几个：

模型	特点	适合场景
DeepSeek	性价比之王，推理强	日常对话、代码生成
Kimi	200 万字超长上下文	长文档分析
智谱 GLM	中文理解好	中文内容创作

提醒一句：不管你选哪个平台，AI 对话都是要消耗 token 的，聊得越多花得越多。尤其是发长文、传文件、搞分析这种，token 消耗会很快。建议平时关注一下用量，别月底收到账单吓一跳。

4. 输入 API Key（选了 Qwen 的可以跳过这步） —— 去对应模型的官网申请，复制粘贴进去就行。

5. 选择聊天工具 —— 飞书、Telegram 或者先选 None 跳过（后面随时能配）。

6. Gateway 端口 —— 默认 18789，直接回车跳过。

Mac OS

7. 选择 Skills —— 用空格键勾选你需要的技能包，不确定的话直接跳过。

8. 启用 Hooks —— 建议启用，用于内容引导、日志和会话记录。

配置完成后，OpenClaw 会自动启动 Gateway 服务。

第五步：验证运行

openclaw channels status

看到 Gateway reachable. 就说明一切正常。

打开浏览器访问 http://127.0.0.1:18789/chat，就能看到 Web 聊天界面了。

日常使用命令

# 启动服务
openclaw gateway start

# 开机自启（推荐）
openclaw gateway enable

# 停止服务
openclaw gateway stop

# 更新 OpenClaw
openclaw update

Windows 安装教程

Windows 上有两种方式可以装 OpenClaw，我都说一下，你按自己情况选。

开发者 API 服务

方案一：WSL2 + Ubuntu（推荐）

这是官方推荐的方式。说白了就是在 Windows 里跑一个 Linux 环境，体验和 Mac/Linux 基本一致。

第一步：启用 WSL2

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

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

执行完之后重启电脑，这一步不能省。

第二步：安装 Ubuntu

打开 Microsoft Store
搜索 Ubuntu 22.04 LTS（或 24.04 LTS）
点「获取」安装
首次启动时设置一个用户名和密码（这是 Linux 里的，随便设）

第三步：更新系统和装依赖

在 Ubuntu 终端里执行：

软件

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

第四步：装 Node.js

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

装完验证一下：

node -v   # 应该显示 v22.x.x
npm -v

第五步：装 OpenClaw

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

第六步：验证安装

openclaw --version

第七步：从 Windows 访问

OpenClaw 跑在 WSL2 里，但 Windows 浏览器可以直接访问。在 WSL2 终端里启动：

Node.js 安装

openclaw gateway run --port 18789

然后在 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

双击就能启动，很方便。

方案二：PowerShell 原生安装

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

网络应用与在线工具

第一步：装 Node.js

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

装的时候记得勾上「自动安装必要的工具」。

第二步：确认 Node.js 装好了

打开 PowerShell：

node -v
npm -v

都能输出版本号就对了。

第三步：安装 OpenClaw

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

AI 工具

npm install -g openclaw@latest

如果你想用汉化版：

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

第四步：解决可能遇到的权限问题

如果安装报权限错误，试试这几个：

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

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

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

改完之后重新打开一个 PowerShell 窗口再试。

第五步：验证和初始化

openclaw --version
openclaw onboard --install-daemon

后面的配置流程和 Mac 那边一样，跟着向导走就行。

Windows 部署

Windows 常见问题

sharp 模块加载失败？

npm cache clean --force
npm install -g openclaw@latest --force

Windows Defender 拦截了？

把这两个路径加到 Defender 排除项里：

C:\Users\你的用户名\AppData\Roaming\npm
C:\Users\你的用户名\.openclaw

API 怎么配？

OpenClaw 本身不自带 AI 模型，需要你接入一个。

Linux 与 Unix

零配置方案：选 Qwen（新手首选）

前面说了，配置向导里直接选 qwen，授权登录就能用，完全不需要折腾 API Key。赶时间或者怕麻烦的直接选这个。

缺点就是每天有免费问答次数限制，超了会被提示。如果后面觉得不够用，再换成下面的自配方案。

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

想要更稳定、不限次数的体验，建议自己申请一个 API Key：

DeepSeek（推荐，性价比最高）

去 DeepSeek 开放平台注册
创建 API Key
在 OpenClaw 配置向导里选 DeepSeek，粘贴 Key

价格大概 0.001 元 / 千 tokens，具体花费取决于你的使用频率。

Mac OS

Kimi（长文本场景推荐）

去 Moonshot AI 开放平台注册
创建 API Key
配置方式同上

智谱 GLM（中文场景推荐）

去智谱 AI 开放平台注册
创建 API Key
配置方式同上

如果你已经有 Claude 或 GPT 的 Key，当然也能用，在向导里选对应的就行。

再次提醒：不管用哪个模型，AI 对话都是按 token 计费的。长对话、传文件、上下文越长消耗越大。建议定期去对应平台的控制台看看用量，做到心里有数。
PowerShell 教程

接入聊天工具

装好 OpenClaw 之后，接入聊天工具才算真正”用起来”。

飞书、Telegram、企业微信、QQ……这些平台的 Bot 配置方式各不相同，需要的权限也不一样。好消息是官方文档把所有平台的配置步骤和权限列表都整理好了，直接去看就行：

官方渠道配置文档：https://docs.openclaw.ai/zh-CN/channels
点开对应的平台，里面有详细的创建步骤、权限清单、回调地址配置等，照着做就行，比我这里写得全多了。

下面简单说一下大致流程，让你心里有个数：

飞书（国内推荐）

大致流程：在飞书开放平台创建应用 → 配置事件订阅 → 开通权限（官方文档列了一大堆权限，别漏了）→ 在 OpenClaw 里绑定。

计算机硬件

# 安装飞书插件
openclaw plugins install @m1heng-clawd/feishu

# 配置（替换成你自己的 App ID 和 Secret）
openclaw config set channels.feishu '{"enabled":true,"appId":"cli_xxx","appSecret":"xxx"}' --json

具体的 App ID 怎么拿、权限勾哪些，直接看官方文档里的飞书部分，写得很清楚。

Telegram（海外推荐）

# 在 Telegram 找 @BotFather，发 /newbot 创建机器人
# 拿到 Bot Token 之后：

openclaw channels add telegram
openclaw config set channels.telegram.botToken "your-bot-token"
openclaw gateway restart

其他平台

企业微信、钉钉、QQ 等平台的配置方式也都在官方渠道文档里有说明，需要的自行查阅。

软件

总结

场景	推荐方案
有 Mac	Mac 本地安装，一行命令搞定
Windows 用户	WSL2 + Ubuntu，体验接近原生
不想折腾 WSL	PowerShell 原生安装，也能用
需要 24 小时运行	考虑云端部署（腾讯云 20 元/月起）

整体来说，OpenClaw 的安装过程不算复杂，最核心的就三步：装好 → 跑向导 → 配 API Key。剩下的就是根据自己需求接入聊天工具了。

有问题的话可以去 OpenClaw 看看文档，或者在社区里提问。

祝大家玩得开心。

Node.js 安装