OpenClaw 安装部署 Mac/Win 双系统完整版指南，一文搞定

发布于 2026-03-08 · 最近火爆的依然还是龙虾🦞。就算是这么火爆，还是有很多朋友依然在得到龙虾🦞的阶段，更别说养虾🦞了。腾讯更是推出，鹅厂门口现场免费安装 OpenClaw 。...

这阵子热度最高的，还得是龙虾🦞。

可火归火，不少朋友还卡在怎么把龙虾🦞弄到手这一步，养虾🦞就更别提了。

腾讯干脆把服务台摆到了鹅厂门口，现场免费帮忙装 OpenClaw，从“装”到“玩”一条龙全包。

来现场装的人年龄从2岁到60岁都有，OpenClaw 创始人 Peter 还转发了鹅厂这场活动。

几个小时下来，几百只龙虾就这么诞生了。

我自己部署的时候坑也没少踩，一路被卡到麻。这东西确实有门槛，装的过程中那些对系统、权限的要求，新手光看报错根本摸不着头脑。

下面这套步骤是我专门请教了技术大佬之后整理的，新手照着走完全没问题。

01. 检查并装好基础环境

Mac系统

检查和安装 Node.js

以前装过 Node.js 的，先在终端敲下面这条命令查版本，必须在 22 及以上才行。

node -v

没装过的，直接去官网下载安装：https://nodejs.org/zh-cn/download

装完再敲一遍上面的命令，确认一下版本。

检查和安装 Homebrew

先输入检查命令

brew --version

能显示版本号，说明已经装过了，

显示 command not found: brew，就是还没有。

那就用下面的命令来装：（直接走国内镜像，速度快，环境变量也会自动配好）

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

按下回车，会让你输入 Mac 密码（输入的时候屏幕上不显示字符，这是正常的）。

按提示挑镜像，输 1 或 2 都行，然后就等脚本自己把剩下的步骤跑完。

最后再跑一遍上面的检查命令，看看 Homebrew 的状态，能输出版本号就算装好了。

Win系统

安装WSL

为什么非得装 WSL ？
因为 OpenClaw 本身就不支持 Win 系统，装了 WSL 相当于先给自己搭了一套 Linux 系统。

在搜索框搜 PowerShell ，右键选以管理员身份运行。

弹出允许应用对设备进行更改的提示，选：是。

输入安装命令

wsl --install

它会自己下载并安装 WSL2 和 Ubuntu（一个 Linux 系统），注意⚠️安装好后需要重启电脑。

重启电脑后，设置 Ubuntu 的窗口会自动弹出来，用户名和密码随便设个简单好记的就行。

窗口显示成这样就对了。

之后再搜 Ubuntu 打开，后面所有的命令都在这儿敲。

安装Node.js

这一步是要在 WSL 里面装 Node.js，之前在 Windows 上装的那份大概率在这边不生效。

先去官网把安装包下载好。

接着在 Ubuntu 里按顺序输入这几条命令

sudo apt update

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

sudo apt install -y nodejs

跑完之后再输命令验证一下装没装好

node -v

能看到版本号就是成功了。

这些都备齐了，就可以动手装 OpenClaw 了。

02. 正式安装OpenClaw

安装命令

MacOS：

输入官方推荐的命令:

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

如果安装途中碰到和我下面截图一样的权限不足问题

就依次执行下面的命令解决，跑完后再重新执行安装命令。

sudo chown -R $(whoami) /usr/local/lib/node_modules

sudo chown -R $(whoami) /usr/local/bin

sudo chown -R 501:20 "/Users/换成你的用户名/.npm"

要是还是不行，再推荐一个思路：先装 nvm，用 nvm 来管npm，然后再执行安装命令。

Windows：

输入官方推荐的命令：

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

装成功后配置向导会自动打开，向导里的选择不分系统，Mac、Windows 都一样。

配置选择

看到这个页面就说明装好了，接着往下选配置。

接下来：

1.这里选：Yes

2.选：QuickStart

3.模型API配置：手上有哪家模型的 API 就选哪家，也可以先 Skip 跳过，之后敲命令 openclaw onboard 重新配，或者直接改本地的 json 文件。

4.配置聊天渠道：现在大家都推荐飞书，拿不准可以先跳过，装完了再用 openclaw channels add 补配置。也可以让龙虾自己帮你接进来。

5.技能Skills配置：选 Yes 后回车，按空格勾跳过，再回车。

6.后面的统统选 No 或跳过。

7.安装完成，选第二个，Web UI 页面会自动打开。

可以发条消息测一下：“介绍下自己”，有回复就说明ok了。

03. 把飞书接进来

前面配聊天渠道时选了 Skip 跳过的，现在可以输入下面的命令重新配置

openclaw channels add

选 Yes，再选飞书渠道，然后选下载安装。

走到 Enter App Secret 这一步先停下来，得先去把飞书机器人创建好。

打开飞书开放平台官网：https://open.feishu.cn/?lang=zh-CN

进开发者后台，点创建企业自建应用，填上应用名称、选好头像，再点创建。

在应用能力里，选择添加机器人

打开权限管理，点批量导入权限，把下面的 json 内容复制进去，申请配置权限。

{
“scopes”: {
“tenant”: [
“contact:contact.base:readonly”,
“contact:user.base:readonly”,
“im:message”,
“im:message.group_at_msg:readonly”,
“im:message.group_msg”,
“im:message.p2p_msg:readonly”,
“im:message.reactions:read”,
“im:message:readonly”,
“im:message:recall”,
“im:message:send_as_bot”,
“im:message:update”,
“im:resource”
],
“user”: [
“docx:document:readonly”
]
}
}

接着发布应用：点创建版本，填好版本号和描述，保存之后申请发布到线上。

进凭证与基础信息，拿到 App ID 和 App Secret 。