ARTICLE · 1078258
Openclaw小龙虾M1/M2安装教程,Mac用户别错过
Openclaw小龙虾M1/M2安装教程,Mac用户别错过上周有位读者私信我，说他在新买的 M2 MacBook Air 上折腾 Openclaw 折腾到凌晨两点，最后卡在一个权限报错上，差点把整个系统重装。我看完他的截图哭笑不得——这问题我去年也踩过，而且解决方法只有一行。所以今天干脆把这套流程完整写一遍，尤其是 M1、M2 芯片的机器，坑和 Intel 机型真的不太一样。
先弄明白：M1/M2 到底特殊在哪
很多教程一上来就甩命令，但我觉得先把底层逻辑说清楚，后面出问题你才知道去哪儿找原因。苹果从 M1 开始把芯片从 x86 换成了 ARM 架构，这一换，连带影响了好几个地方：
芯片架构从 x86_64 变成 arm64，很多为老 Intel 机器编译的程序不能直接跑
Homebrew 的安装位置从 /usr/local 挪到了 /opt/homebrew，环境变量没配好就会提示「找不到命令」
Rosetta 2 可以翻译运行老程序，但它不是万能的，涉及底层调用的东西照样会崩
系统对权限管得更严，终端想写入某些目录需要额外授权
我第一次在 M1 上装的时候，就栽在第二条上。当时明明按教程装完了，敲命令却一直报 command not found，查了半小时才发现是 PATH 没更新。所以记住一句话：在 M 系列芯片上，路径问题永远排在报错原因的第一位。
第一步：打开龙虾安装地址：https://top.wokk.cn
第二步：选择Windows10/11或macOS apple、intel芯片下载。
第三步：双击安装包（exe或者dmg文件）等待3分钟。
第四步：打开桌面TopClaw龙虾软件注册登录即可使用
如果你不确定自己的机器是什么架构，打开终端敲 uname -m，返回 arm64 就是 M 系列，返回 x86_64 就是 Intel。这一步别偷懒，后面所有选择都依赖它。
两条安装路线，按自己的情况选
目前大家装 Openclaw 主要走两条路，我两条都试过，各有各的适用场景。
路线一：用包管理器一键装
如果你已经装了 Homebrew，这条路最省心。先执行一次更新，把软件源同步到最新，然后再安装。装完记得检查一下版本号，确认拿到的是 arm64 版本而不是转过译的老版本。我身边大部分朋友用的都是这条路，出问题的概率最低。 
确认 Homebrew 本身是 arm64 版本，可以看它的安装目录是不是 /opt/homebrew
安装前先更新软件源，避免拉到过期的包
装完用版本查询命令验证一下，别装完就当万事大吉
路线二：从源码编译
如果你需要最新的特性，或者包管理器里的版本太旧，那就得自己编译。这条路的门槛稍微高一点，核心是要先装好编译工具链。苹果的开发者命令行工具装完之后，基础的编译器、链接器就都有了。
先安装命令行开发工具，终端会弹窗确认，跟着走完就行
克隆仓库时注意分支，别默认拉了个开发中的不稳定版本
编译过程比较吃 CPU，M1 和 M2 的机器大概几分钟到十几分钟不等，中途别关窗口
如果编译报错提示缺少某个库，多半是依赖没装全，按提示补上再重来
我个人更推荐新手先走第一条路。理由很简单：包管理器帮你处理了依赖和架构适配，你只需要关心「能不能跑起来」，而不是「为什么编译不过」。等你用熟了，再去折腾源码也不迟。
装完之后，这几个坑我替你踩过了
能用和好用之间，往往隔着几个细节。下面这些是我自己以及身边朋友真实遇到过的：
终端重启了吗？ 环境变量改完之后，必须关掉终端重开一次才生效，很多人卡在这一步
权限提示别乱点。 系统弹出「终端想要访问某文件夹」时，看清楚是哪个目录再同意，别一路点允许
配置文件路径要对。 M 系列芯片的配置目录和 Intel 机器不同，照搬老教程的路径百分之百失效
版本冲突。 如果之前用别的方式装过，先彻底卸载干净再装新的，否则两个版本打架，报错信息会非常迷惑
别用管理员权限硬来。 遇到权限报错就加 sudo 是个坏习惯，正确做法是搞清楚文件属主，把权限改对
我一直觉得，折腾环境这件事本身就是一种学习。报错不可怕，可怕的是你不知道为什么报错就一通乱试。每次解决问题后花两分钟复盘一下原因，下次同类问题你会快十倍。
另外提醒一句，装完之后建议先跑一次最简单的功能，确认基础流程通畅，再去改配置、加扩展。上来就深度定制，一旦出问题你根本分不清是安装环节的锅还是配置环节的锅。
整个流程走下来，顺利的话二十分钟就能搞定，不顺利可能要多花一两个小时排查。但只要你记住「先确认架构、再选路线、最后处理路径和权限」这个顺序，基本上不会走进死胡同。如果你在安装过程中遇到别的怪问题，欢迎在评论区留言，我看到会尽量回复。折腾环境这件事，一个人摸索很累，有人搭把手就轻松多了。
OpenClaw中文版龙虾安装地址：https://top.wokk.cn
先弄明白：M1/M2 到底特殊在哪
很多教程一上来就甩命令，但我觉得先把底层逻辑说清楚，后面出问题你才知道去哪儿找原因。苹果从 M1 开始把芯片从 x86 换成了 ARM 架构，这一换，连带影响了好几个地方：
芯片架构从 x86_64 变成 arm64，很多为老 Intel 机器编译的程序不能直接跑
Homebrew 的安装位置从 /usr/local 挪到了 /opt/homebrew，环境变量没配好就会提示「找不到命令」
Rosetta 2 可以翻译运行老程序，但它不是万能的，涉及底层调用的东西照样会崩
系统对权限管得更严，终端想写入某些目录需要额外授权
我第一次在 M1 上装的时候，就栽在第二条上。当时明明按教程装完了，敲命令却一直报 command not found，查了半小时才发现是 PATH 没更新。所以记住一句话：在 M 系列芯片上，路径问题永远排在报错原因的第一位。
第一步：打开龙虾安装地址：https://top.wokk.cn
第二步：选择Windows10/11或macOS apple、intel芯片下载。
第三步：双击安装包（exe或者dmg文件）等待3分钟。
第四步：打开桌面TopClaw龙虾软件注册登录即可使用
如果你不确定自己的机器是什么架构，打开终端敲 uname -m，返回 arm64 就是 M 系列，返回 x86_64 就是 Intel。这一步别偷懒，后面所有选择都依赖它。
两条安装路线，按自己的情况选
目前大家装 Openclaw 主要走两条路，我两条都试过，各有各的适用场景。
路线一：用包管理器一键装
如果你已经装了 Homebrew，这条路最省心。先执行一次更新，把软件源同步到最新，然后再安装。装完记得检查一下版本号，确认拿到的是 arm64 版本而不是转过译的老版本。我身边大部分朋友用的都是这条路，出问题的概率最低。
确认 Homebrew 本身是 arm64 版本，可以看它的安装目录是不是 /opt/homebrew
安装前先更新软件源，避免拉到过期的包
装完用版本查询命令验证一下，别装完就当万事大吉
路线二：从源码编译
如果你需要最新的特性，或者包管理器里的版本太旧，那就得自己编译。这条路的门槛稍微高一点，核心是要先装好编译工具链。苹果的开发者命令行工具装完之后，基础的编译器、链接器就都有了。
先安装命令行开发工具，终端会弹窗确认，跟着走完就行
克隆仓库时注意分支，别默认拉了个开发中的不稳定版本
编译过程比较吃 CPU，M1 和 M2 的机器大概几分钟到十几分钟不等，中途别关窗口
如果编译报错提示缺少某个库，多半是依赖没装全，按提示补上再重来
我个人更推荐新手先走第一条路。理由很简单：包管理器帮你处理了依赖和架构适配，你只需要关心「能不能跑起来」，而不是「为什么编译不过」。等你用熟了，再去折腾源码也不迟。
装完之后，这几个坑我替你踩过了
能用和好用之间，往往隔着几个细节。下面这些是我自己以及身边朋友真实遇到过的：
终端重启了吗？ 环境变量改完之后，必须关掉终端重开一次才生效，很多人卡在这一步
权限提示别乱点。 系统弹出「终端想要访问某文件夹」时，看清楚是哪个目录再同意，别一路点允许
配置文件路径要对。 M 系列芯片的配置目录和 Intel 机器不同，照搬老教程的路径百分之百失效
版本冲突。 如果之前用别的方式装过，先彻底卸载干净再装新的，否则两个版本打架，报错信息会非常迷惑
别用管理员权限硬来。 遇到权限报错就加 sudo 是个坏习惯，正确做法是搞清楚文件属主，把权限改对
我一直觉得，折腾环境这件事本身就是一种学习。报错不可怕，可怕的是你不知道为什么报错就一通乱试。每次解决问题后花两分钟复盘一下原因，下次同类问题你会快十倍。
另外提醒一句，装完之后建议先跑一次最简单的功能，确认基础流程通畅，再去改配置、加扩展。上来就深度定制，一旦出问题你根本分不清是安装环节的锅还是配置环节的锅。
整个流程走下来，顺利的话二十分钟就能搞定，不顺利可能要多花一两个小时排查。但只要你记住「先确认架构、再选路线、最后处理路径和权限」这个顺序，基本上不会走进死胡同。如果你在安装过程中遇到别的怪问题，欢迎在评论区留言，我看到会尽量回复。折腾环境这件事，一个人摸索很累，有人搭把手就轻松多了。
OpenClaw中文版龙虾安装地址：https://top.wokk.cn