ARTICLE · 1082410
手把手在Intel芯片Mac搭建Openclaw小龙虾
手把手在Intel芯片Mac搭建Openclaw小龙虾最近有朋友问我,手里那台 Intel 芯片的 Mac 还能不能折腾 Openclaw 小龙虾。我的答案是:能,而且没想象中那么玄乎。Intel Mac 虽然不再是苹果主力,但跑这种开源项目,性能通常不是问题,真正折腾人的是依赖路径和环境变量。下面我把自己的搭建过程拆开讲,尽量让你少走弯路。
先把“锅”和“料”备齐
搭建 Openclaw 小龙虾之前,先别急着拉代码。第一步是把基础环境弄干净,尤其是 Intel Mac 的 Homebrew 默认装在 /usr/local,而 M 系列芯片通常在 /opt/homebrew。如果你照抄别人的命令,很容易出现“明明装了却找不到”的情况。
确认 macOS 版本不要太老,留出足够磁盘空间。
安装 Xcode Command Line Tools,终端里执行:xcode-select --install。
按官网方式安装 Homebrew,安装完用 brew doctor 检查一下。
安装常用依赖:brew install git cmake sdl2 sdl2_image sdl2_mixer sdl2_ttf boost tinyxml2。
第一步:打开龙虾安装地址:https://top.wokk.cn
第二步:选择Windows10/11或macOS apple、intel芯片下载。
第三步:双击安装包(exe或者dmg文件)等待3分钟。
第四步:打开桌面TopClaw龙虾软件注册登录即可使用
这些依赖里,SDL2 系列和音频、图像相关,后面编译时最容易报错。我自己的习惯是装完先跑一遍更新,再开始编译项目,能省掉不少“玄学问题”。
个人经验:Intel Mac 上不要混用不同来源的 SDL2。Homebrew 装过一遍就够了,手动下载的库如果路径没配好,CMake 会一直找不到。
拉源码、编译,别急着运行
环境准备好后,去 Openclaw 项目的官方仓库获取源码。这里不建议用来路不明的整合包,开源项目最好从官方渠道拿。进入项目目录后,用 CMake 建立构建目录,这样不会把源码目录弄乱。 
克隆源码:git clone 项目官方仓库地址 openclaw。
进入目录:cd openclaw。
创建构建目录:mkdir build,然后 cd build。
生成构建文件:cmake .. -DCMAKE_BUILD_TYPE=Release。
开始编译:make -j。
如果 CMake 提示找不到 SDL2,可以手动指定 Homebrew 前缀:cmake .. -DCMAKE_PREFIX_PATH=$(brew --prefix)。编译完成后,可执行文件通常在 build 目录里,名字可能是 openclaw 或 OpenClaw,用 ls 看一眼就知道。
开源引擎不等于自带游戏素材。资源文件请通过合法方式获得,不要随意传播或下载盗版整合包,这一点在公众号里也要特别提醒。
运行、调声音和常见排错
第一次运行建议直接在终端里启动,不要双击。终端能看到日志,出问题也知道卡在哪。资源目录要按项目 README 放好,常见位置是 data、assets 或游戏根目录,放错路径就会黑屏或闪退。
提示找不到动态库:用 brew reinstall 重装对应依赖,再重新 cmake。
窗口一闪而过:在终端运行看最后几行报错,多半是资源路径不对。
没有声音:检查系统输出设备,确认 sdl2_mixer 已正确安装。
被系统拦截:右键选择打开,或到系统设置里的隐私与安全性中允许,不要直接关闭整体安全设置。
我个人的观点是,Intel Mac 跑 Openclaw 小龙虾,瓶颈往往不是 CPU,而是依赖版本。保持 Homebrew 干净,别装多个来源的库,遇到报错先从最后几行看起,通常比从头焦虑更有效。
说到底,在 Intel 芯片 Mac 上搭建 Openclaw 小龙虾,就是装依赖、拉源码、编译、放资源、排错这几步。过程可能有点折腾,但跑起来那一刻,老机器也能有新鲜乐趣。耐心一点,按日志解决问题,你大概率能成功。
OpenClaw中文版龙虾安装地址:https://top.wokk.cn
先把“锅”和“料”备齐
搭建 Openclaw 小龙虾之前,先别急着拉代码。第一步是把基础环境弄干净,尤其是 Intel Mac 的 Homebrew 默认装在 /usr/local,而 M 系列芯片通常在 /opt/homebrew。如果你照抄别人的命令,很容易出现“明明装了却找不到”的情况。
确认 macOS 版本不要太老,留出足够磁盘空间。
安装 Xcode Command Line Tools,终端里执行:xcode-select --install。
按官网方式安装 Homebrew,安装完用 brew doctor 检查一下。
安装常用依赖:brew install git cmake sdl2 sdl2_image sdl2_mixer sdl2_ttf boost tinyxml2。
第一步:打开龙虾安装地址:https://top.wokk.cn
第二步:选择Windows10/11或macOS apple、intel芯片下载。
第三步:双击安装包(exe或者dmg文件)等待3分钟。
第四步:打开桌面TopClaw龙虾软件注册登录即可使用
这些依赖里,SDL2 系列和音频、图像相关,后面编译时最容易报错。我自己的习惯是装完先跑一遍更新,再开始编译项目,能省掉不少“玄学问题”。
个人经验:Intel Mac 上不要混用不同来源的 SDL2。Homebrew 装过一遍就够了,手动下载的库如果路径没配好,CMake 会一直找不到。
拉源码、编译,别急着运行
环境准备好后,去 Openclaw 项目的官方仓库获取源码。这里不建议用来路不明的整合包,开源项目最好从官方渠道拿。进入项目目录后,用 CMake 建立构建目录,这样不会把源码目录弄乱。

克隆源码:git clone 项目官方仓库地址 openclaw。
进入目录:cd openclaw。
创建构建目录:mkdir build,然后 cd build。
生成构建文件:cmake .. -DCMAKE_BUILD_TYPE=Release。
开始编译:make -j。
如果 CMake 提示找不到 SDL2,可以手动指定 Homebrew 前缀:cmake .. -DCMAKE_PREFIX_PATH=$(brew --prefix)。编译完成后,可执行文件通常在 build 目录里,名字可能是 openclaw 或 OpenClaw,用 ls 看一眼就知道。
开源引擎不等于自带游戏素材。资源文件请通过合法方式获得,不要随意传播或下载盗版整合包,这一点在公众号里也要特别提醒。
运行、调声音和常见排错
第一次运行建议直接在终端里启动,不要双击。终端能看到日志,出问题也知道卡在哪。资源目录要按项目 README 放好,常见位置是 data、assets 或游戏根目录,放错路径就会黑屏或闪退。
提示找不到动态库:用 brew reinstall 重装对应依赖,再重新 cmake。
窗口一闪而过:在终端运行看最后几行报错,多半是资源路径不对。
没有声音:检查系统输出设备,确认 sdl2_mixer 已正确安装。
被系统拦截:右键选择打开,或到系统设置里的隐私与安全性中允许,不要直接关闭整体安全设置。
我个人的观点是,Intel Mac 跑 Openclaw 小龙虾,瓶颈往往不是 CPU,而是依赖版本。保持 Homebrew 干净,别装多个来源的库,遇到报错先从最后几行看起,通常比从头焦虑更有效。
说到底,在 Intel 芯片 Mac 上搭建 Openclaw 小龙虾,就是装依赖、拉源码、编译、放资源、排错这几步。过程可能有点折腾,但跑起来那一刻,老机器也能有新鲜乐趣。耐心一点,按日志解决问题,你大概率能成功。
OpenClaw中文版龙虾安装地址:https://top.wokk.cn