乐于分享
好东西不私藏

�� OpenClaw 安装教程( Mac旧系统小白友好版)

�� OpenClaw 安装教程( Mac旧系统小白友好版)

⚠️ 安全须知

OpenClaw 安装后会在你的电脑上开放网络服务、接管你的消息账号并存储敏感凭证,一旦被入侵后果严重不要用于存有重要资料的主力电脑哈。最好是在一台没有任何信息的空电脑或者没有重要资料的云服务器上面安装。

我使用的是一台重装了系统的旧 Mac(macOS 12),很多基础工具都没有,非常适合同样使用旧 Mac 的小白跟着操作。

我的配置如图所示:

话不多说,我们开始安装吧

1:安装Homebrew

打开终端,检查下电脑有没有装Homebrew,输入如下命令

brew --version

如果提示zsh: command not found: brew就是没装,输入以下命令,装一下(这个是国内镜像,速度更快)

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

安装过程如图所示,会让选择一些信息,可以跟我选一样的

2:安装龙虾

在终端上执行以下命令:

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

💡 macOS 12 特别处理

如果你的系统是 macOS 12(Monterey)或更低版本,脚本可能提示 Node.js 安装失败,需要额外操作:

1. 安装 MacPorts

前往 MacPorts 官网 下载并安装适合你系统版本的安装包。

官网地址:https://www.macports.org/

安装完成后更新:

bash sudo port -v selfupdate

2. 通过 MacPorts 安装 Node.js 22

bash sudo port install nodejs22

3. 清理残留锁文件

如图所示之前安装失败留下了锁文件,按终端提示删除,例如:

bash rm -/Users/你的用户名/Library/Caches/Homebrew/downloads/xxxxx.incomplete

3. 重新执行安装脚本

再试一下刚才的命令,发现可以安装成功了!~

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

4:龙虾的初始化配置

安装完成后,会进入交互式配置向导,如果需要快速配置可以按下表建议选择:

如果想具体看选项的含义,可以看如下信息

1:是否给 Dashboard 生成一个访问令牌(token),用来保护你的本地服务?

这个肯定要选yes了!~

简单说就是:

  • OpenClaw 在本地开了一个网页控制台(http://127.0.0.1:18789

  • 为了防止其他程序或网页偷偷访问这个控制台,需要一个 token 做验证

如果选 No

  • Dashboard 就没有 token 保护,任何能访问你电脑的程序都可以直接打开控制台

  • 安全性低,官方也说了 token 认证现在是推荐的默认方式

2:是否把权限收紧到 700,就是确保只有你本人(目录的所有者)可以访问、读写和执行这个目录里的内容。

还是选 Yes,收紧权限更安全,防止其他用户读取你的配置文件(里面有 token)。

权限 700 是什么意思?

在 Linux/macOS 系统中,文件和目录的权限通常用三位数字表示:

  • 第一位 (7):文件所有者(你) 的权限。

    • 7 = 读(4) + 写(2) + 执行(1) = 完全控制。

  • 第二位 (0):用户组 的权限。0 代表该组成员没有任何权限。

  • 第三位 (0):其他所有用户 的权限。0 代表其他人没有任何权限。

3:创建这个目录存储会话记录吗?

选 Yes,这是正常初始化需要的。

4:是否开按Tab自动补全

看个人习惯:

  • Yes — 以后输入 openclaw 后按 Tab 可以自动补全命令,比较方便

  • No — 没有自动补全,影响不大

建议选 Yes,用起来更顺手。

5:是否要将 OpenClaw 的核心服务设置为开机自启并在后台一直运行。

选 Yes,这会把 gateway 安装为后台服务,这样每次开机自动启动,不需要手动运行。

6:选择 Gateway 服务用什么运行时环境来运行

简单说,就是选一个“发动机”来驱动 OpenClaw。这里听官方建议选Node,更稳定

到这里就配置成功啦~

5:修复Gateway启动失败

配置完成后,如果命令行里有提示 Gateway启动失败, 我们在终端执行命令,检查一下为什么启动失败

openclaw daemon stop && openclaw gateway run --verbose

原因找到了!gateway.mode is unset  gateway.mode 没有设置,在终端运行这个命令修复下:

openclaw config set gateway.mode local

然后再执行以下命令启动:

openclaw gateway run --verbose

gateway启动成功

6:打开控制台

这次我们可以再在浏览器试下访问刚才的小龙虾控制台。

控制台地址:http://127.0.0.1:18789/chat?session=main

🎉 看到 OpenClaw 控制台界面,成功啦!~

好了,你的小龙虾已经上线待命了 🦞 装好了的扣 1,卡在哪步了的扣步骤编号,一起来填坑~

下一篇大家想看小龙虾的什么内容呢~

欢迎留言~~