小龙小openClaw mac电脑安装部署
环境准备:软硬件要求一目了然
想在macOS上顺利运行OpenClaw,你的系统得先满足几个基础条件,这事儿就像盖房子前得打好地基一样。
操作系统要求
首先看看操作系统:macOS 12 (Monterey) 或更高版本,这是最基本的门槛。
硬件要求
接着是硬件。OpenClaw对芯片架构支持得挺全面,无论是Apple Silicon (包括M1到最新的M4系列),还是传统的Intel (x86_64)处理器,都能跑起来。
软件依赖
软件层面需要准备三样东西:Node.js 22+版本、Git,以及一个可选的包管理工具Homebrew。先准备好这些,后面安装流程会顺畅得多。
第一步:安装Homebrew
Homebrew可以看作是macOS上的“软件管家”,用它来安装后续的Node.js等依赖,会非常省心。
打开终端,输入下面这条命令来安装:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后,别忘了验证一下。输入brew --version,如果能显示出Homebrew的版本号,那就说明它已经在你的系统上安家落户了。
第二步:安装Node.js和Git
有了Homebrew,安装Node.js和Git就变成了两行简单的命令。
在终端里依次执行:
brew install node
brew install git
同样,安装完得确认是否成功。分别运行node -v和git --version,看到各自的版本信息输出,就可以放心进行下一步了。
第三步:安装OpenClaw
核心环节来了。OpenClaw官方提供了一键安装脚本,这对新手来说非常友好。
只需执行下面这条命令:
curl -fsSL https://openclaw.ai/install.sh | bash
这个脚本很智能,它会自动检测你的系统环境。如果发现Node.js还没安装,它会帮你装上;接着会自动下载OpenClaw,并完成必要的环境变量配置。整个过程基本无需人工干预。
第四步:初始化配置
安装好二进制文件只是开始,要让OpenClaw真正工作起来,还需要进行初始化配置。
运行配置向导:
openclaw onboard
跟着向导的指引走,流程很清晰,主要包括这几步:
- 首先,阅读并接受风险提示。
- 然后,选择安装模式。对于大多数用户,直接选择推荐的QuickStart模式是最快上手的办法。
- 最后,配置你打算使用的AI模型提供商,比如OpenAI、Anthropic等,将你的API密钥配置进去。
第五步:验证安装
配置完成后,怎么知道一切是否就绪了呢?
执行一个简单的验证命令:
openclaw --version
如果终端清晰地打印出了OpenClaw的版本号,那么恭喜你,安装环节大功告成。
第六步:启动OpenClaw服务
现在,让我们把服务运行起来。启动OpenClaw的网关服务,命令如下:
openclaw gateway start
服务启动后,打开你常用的浏览器,在地址栏输入:
http://127.0.0.1:18789
如果能看到OpenClaw的控制面板页面,那就说明整个系统已经从安装到启动,全部畅通无阻了。
遇到问题怎么办?常见排错指南
即便流程再清晰,有时也难免会遇到小麻烦。这里有几个最常见的“拦路虎”和解决思路:
权限问题
如果在安装Node.js包或执行脚本时遇到权限错误,大概率是npm的全局目录权限设置问题。确保当前用户对相关目录有读写权限。
端口占用
启动网关时如果提示端口被占用(默认是18789),别担心。你可以通过配置轻松更换成另一个未被使用的端口号。