OpenClaw保姆级安装教程

（2026年4月14日更新）

什么是OpenClaw？

OpenClaw 是一款个人 AI 助手，国内称“龙虾助手”，运行在你自己的设备上。目前火遍国内外，它可以通过你已经在使用的通讯渠道（微信、QQ、飞书、WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、Microsoft Teams、WebChat 等）与你交互，还支持语音对话、Canvas 可视化等高级功能，可以真正为你做事，而不是口头说说。

它的核心设计理念是：

• 个人化：为你个人服务，而非企业级多用户系统
• 本地运行：以网关的形式运行在你的设备上
• 多渠道接入：支持几乎所有主流通讯平台
• 功能丰富：浏览器控制、Canvas 可视化、语音交互、定时任务等

系统要求

• Node.js ≥ 22（必须）
• 操作系统：≥ macOS13.5
• 包管理器：npm

安装示例

现以苹果Mac电脑为例，详细演示安装过程：

第一步：安装HOMEBREW

打开mac电脑的终端，运行以下命令：

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

若出现以上提示，点安装

安装完成后，重新运行以下命令：

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

输入数字1，回车

在Password：后面输入开机密码，输入时是看不见密码的，凭感觉输入，然后回车

按Y，回车

在Password：后面输入开机密码，输入时是看不见密码的，凭感觉输入，然后回车

此步骤成功后，再次输入开机密码，然后按回车

推荐输入5回车

安装成功后，关闭终端

重新打开终端，让配置生效

第二步：安装Git

在终端中输入：brew install git

回车等待安装完成，然后关闭终端

第三步：安装Node.js

打开网页：https://nodejs.org/zh-cn/download，下载你Mac电脑CPU型号对应的Node.js版本（苹果M芯片选择ARM64平台），推荐22.2.2版

第四步：安装OpenClaw

重新打开终端，在终端中运行：npm config set registry https://registry.npmmirror.com   （把npm下载源切换到国内镜像，安装速度会更快）

然后再运行：git config –global url.”https://github.com/“.insteadOf ssh://git@github.com/   （让Git在访问github时自动把SSH地址改成htts地址，避免SSH配置错误）

最后运行：sudo npm install -g openclaw@latest   （用管理员权限全局安装最新版OpenClaw）

输入开机密码开始安装

（若出现added 数量 packages in 1m，就说明安装完成）

第五步：配置OpenClaw

（如果你以前有安装过飞书，请提前运行这个命令：sudo rm -rf ~/.openclaw/extensions/feishu 彻底删除飞书的配置目录，否则飞书配置会有问题。如果没有安装过飞书，可以忽视这个命令。）

如果需要内外网访问后台界面，可以运行以下四条命令：

openclaw config set gateway.bind “lan”

openclaw config set gateway.controlUi.allowedOrigins ‘[“*”]’

openclaw config set gateway.controlUi.allowInsecureAuth true

openclaw config set gateway.controlUi.dangerouslyDisableDeviceAuth true

运行命令openclaw onboard 进行初始化向导