手把手教你一键部署OpenClaw，全程无卡点，1分钟搞定！

泰白聊AI

3094人浏览 · 2026-03-06 19:40:15

泰白聊AI · 2026-03-06 19:40:15 发布

OpenClaw（也就是大家常说的“大龙虾机器人”）简单说就是个能跑在本地的全能AI小秘。不管是发邮件、定日程，还是搞定各种系统操作，它都能通过WhatsApp、Telegram、飞书这些聊天软件帮你办妥。最重要的是，数据都在自己硬盘里，隐私这块儿拿捏得死死的。这篇教程不管是Mac、Linux还是Windows用户都能看，从怎么装、怎么设，到怎么连聊天软件，还有遇到坑怎么办，全都包圆了，小白也能轻松搞定。
手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

一、安装前的准备工作

1. 系统和硬件底线

配置项	最低得有	推荐配置
操作系统	苹果得macOS 12以上 / Ubuntu 20.04往后 / Windows 10（必须开WSL2）	macOS 14+ / Ubuntu 22.04+ / Windows 11
内存	至少4G	8G起步才顺畅
磁盘空间	留个2G就行	建议10G以上的固态硬盘
核心依赖	Node.js 18.0以上	Node.js v22 LTS最新版

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

2. 动手前得先有的东西

AI模型的API Key：像Claude、GPT-4/5、阿里的百炼、Kimi这些，只要兼容OpenAI接口的都行（这个得你自己去人家官网注册弄一个）；
网络环境：强烈建议把npm切成国内源（不然下载慢到怀疑人生），Windows用户一定记得先把Git装好（不然拉代码报错）。

二、各系统快速安装指南

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

方案1：MAC/LINUX系统（官方推荐，最省事）

打开终端，直接跑下面这个官方的一键脚本（Node.js和那些杂七杂八的依赖它都会自动帮你搞定）：
```
curl -fsSL https://openclaw.ai/install.sh | bash
```

也可以用npm全局安装（这招算备选方案）：

# 换成国内源（选做，但能快很多）
npm config set registry https://registry.npmmirror.com
# 全局装OpenClaw
npm install -g openclaw@latest

检查一下装没装好：
```
openclaw --version
```
只要跳出版本号，就算大功告成。

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

方案2：WINDOWS系统（原生适配，防坑版）

Windows原生支持其实稍微差点意思，得先搞定Node.js环境。全程记得用管理员身份开PowerShell来弄：

装个Node.js v22：

# 装个nvm（管Node版本的神器，强烈安利）
iwr -useb https://raw.githubusercontent.com/coreybutler/nvm-windows/master/nvm-setup.exe | iex
# 装好并启用Node.js 22
nvm install 22
nvm use 22.22.0

跑一下Windows专用的安装脚本：

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

万一遇到策略报错，先敲这行命令，然后再试着重装：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

验货：
```
openclaw --version
```

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

方案3：开发者进阶玩法（直接拉源码）

这种适合想自己改代码、搞开发的大佬，Mac、Linux或者Windows（WSL2）都能用：

# 拉取代码库
git clone https://github.com/openclaw/openclaw.git
# 进目录装依赖
cd openclaw && pnpm install && pnpm run build
# 初始化搞起
pnpm run openclaw onboard

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

三、初始化配置（这一步很关键）

东西装好了，接着运行初始化命令，进入交互模式把AI模型和基础参数设好：

# 通用初始化
openclaw onboard
# Windows新手直接用这个快速版
openclaw onboard --flow quickstart

1. 风险告知

第一次配的时候会跳出一行吓人的话：I understand this is powerful and inherently risky. Continue?，别慌，选 Yes 继续就行。
手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

2. 挑个AI模型并填入API KEY

用方向键选个顺手的模型（Claude、GPT-4都行，国内朋友为了稳还是优先阿里百炼或者Kimi吧）；
把之前准备好的API Key粘进去（就是 sk- 开头的那串字符），回车确认；
有的模型可能需要跳到浏览器里授权一下，按提示点几下就好。

3. 基础设置

技能包（Skill）：新手先别折腾，直接选 No 跳过，后面需要了随时能装；
记忆功能（Hooks）：把 session-memory 勾上（这样它能记住上下文，不用你像复读机一样重复需求），别的默认不动；
搞定这些后，Gateway网关服务就自动跑起来了，默认端口是 18789。

4. 进管理后台

配好之后，浏览器通常会自己弹出一个本地后台，要是没弹，手动输这个地址：

http://127.0.0.1:18789

第一次进得输那个初始化时生成的Token（千万存好，丢了就得重新初始化一遍，很麻烦）。
手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

四、连接聊天软件（拿飞书打个样）

OpenClaw支持WhatsApp、Telegram、飞书、钉钉、微信这些主流平台。飞书相对来说配置简单、也不容易掉线，下面就拿飞书演示，别的平台原理都差不多。

1. 装个飞书插件

终端/PowerShell里敲这行命令：

openclaw plugins install @m1heng-clawd/feishu
# 进插件目录把依赖装全了
cd /root/.openclaw/extensions/feishu/ && npm install --verbose

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

2. 去飞书开放平台建个应用

先去飞书开放平台（网址自己搜一下），登录后点那个“创建企业自建应用”；
起个名（比如“大龙虾私人助理”），随便选个图标，点创建；
进应用管理页，点“添加应用能力”，选“机器人”，然后点添加。

3. 搞定权限和事件订阅

（1）批量开权限

在权限管理里找“批量导入权限”按钮；

复制下面这段JSON代码粘进去，点导入（这步很核心，不然机器人就是个聋哑人）：

{
 "scopes": {
  "tenant": [
   "contact:user.base:readonly",
   "im:chat",
   "im:message",
   "im:message:send_as_bot",
   "im:resource"
  ],
  "user": []
 }
}

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

（2）事件订阅设置

进“事件与回调”，配置里选“长连接”，记得点保存；
点“添加事件”，选“消息与群组”，把 im.message.receive_v1 勾上（这个是用来收消息的，必选）；
订阅方式选长连接，不用填什么回调地址，自动就生效了。

（3）发布应用

进“版本管理与发布”，新建个版本，版本号和描述随便填；
保存并发布。注意：不发布的话，你在后台配出花来也没用。

4. 让OpenClaw连上飞书

回到终端敲命令，添加个通信渠道：
```
openclaw channels add
```
按提示把飞书的App ID和App Secret填进去（在飞书开放平台的“凭证基础信息”里找）；
重启网关，让刚才的配置生效：
```
openclaw gateway restart
```
查查状态：
```
openclaw status
```
看到 Gateway running 就是连上了。
手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

5. 在飞书里试玩

打开手机或电脑上的飞书，进工作台，找到你刚建的“大龙虾私人助理”，点进去发私信；
发点啥都行（比如“Hi”、“整理今天的日程”），只要机器人回话了，就算大功告成。

五、日常用法和常用指令

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

1. 怎么用？

在绑定好的聊天窗口里直接说人话就行，机器人自己会去执行，比如：

查邮件：“帮我把上周没读的邮件过一遍，把会议纪要理出来”；
管文件：“把桌面的PDF都丢到文档文件夹里，按日期排好”；
玩系统：“跑个命令看看CPU现在占用多少”；
定闹钟：“每天早上9点准时发当天的待办清单给我”。

2. 终端命令速查表

功能	命令
看版本	`openclaw --version`
看死活（运行状态）	`openclaw status`
启动/关掉/重启	`openclaw start/stop/restart`
重新配置（重走初始化）	`openclaw onboard`
仅重启网关	`openclaw gateway restart`
看看装了啥插件	`openclaw plugins list`
装新插件	`openclaw plugins install 插件名`
删插件	`openclaw plugins uninstall 插件名`
求助	`openclaw --help`

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

六、疑难杂症与防坑手册

1. 安装卡在 NODE-GYP REBUILD 不动了

原因：电脑里没装Python或者C++编译工具。
解法：

Win：装Visual Studio Build Tools和CMake；
Mac：跑 xcode-select --install 装Xcode工具包；
Linux：跑 sudo apt install build-essential python3。

2. WINDOWS报错“系统找不到指定的路径”

原因：系统被精简过、没开WSL或者没装Git。
解法：

装Git（去官网下），装完必须重启电脑；
开WSL2：PowerShell里敲 wsl --install；

清一下npm缓存然后重装试试：

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

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

3. 飞书那边提示“未建立长连接”

解法：

仔细对一遍App ID和Secret是不是粘错了；
稍微等个一两分钟再点保存（有时候是网不行）；
终端里执行 openclaw gateway restart 重启网关，然后再去配。

4. 发消息机器人装死不回

排查思路：

敲 openclaw status 看看网关是不是挂了；
飞书后台有没有把 im.message.receive_v1 这个事件加上；
确定应用发布了没（没点发布就是没生效）；
看看日志：openclaw gateway --verbose，一般能看到具体哪报错了。

5. 国内下载依赖卡住或者失败

解法：

换国内npm源：npm config set registry https://registry.npmmirror.com；
挂个梯子，或者自己手动下离线包。

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

七、进阶调优（爱折腾的看）

汉化和微信支持：国内用建议装个社区汉化版，对微信和企业微信支持更好：
```
npm install -g openclaw-cn@latest
```

Docker部署：要想7x24小时不关机，用Docker容器跑最稳：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
docker compose up -d openclaw-gateway

跑本地模型：改一下 .env 文件里的 MODEL_PROVIDER 和 API_KEY，就能跑Llama、Qwen这些本地模型，断网也能用。
安全限制：在 config.json 里设一下 allowed_commands 和 denied_commands，别让机器人瞎跑危险命令，安全第一。

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

八、几点碎碎念

隐私安全：虽然OpenClaw数据都在本地，但要是电脑里有那种特别机密的商业数据，还是别瞎装。建议搞个闲置电脑或者云服务器（VPS）专门跑它；
版本选择：别迷信最新版（官方更新太快容易崩），小白老老实实装稳定版：npm install -g openclaw@1.0.0（具体的稳定版本号自己查一下）；
后台保活：本地跑的时候，终端窗口一关服务就停了。想让它一直跑，得用pm2这类工具挂在后台。
手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！