Mac 部署安装 OpenClaw 教程:从零搭建个人 AI 助手完整指南
写在前面
我折腾了好一阵子才把 OpenClaw 在我的 MacBook 上跑起来。
这中间踩了不少坑——环境版本不对、配置文件格式出错、端口被占用等等,都是些看着不大但能让人卡半天的问题。
所以我把整个过程整理成了这篇教程,尽量写得详细一些,让大家少走弯路。
这篇教程写给完全没有编程经验的普通用户,即使你从来没用过终端(就是那个黑底白字的窗口),跟着做也能顺利装好。
每一步我都会说清楚该点哪里、该输入什么,不会跳过任何"看似简单"的步骤。
这篇文章适合以下几类朋友:
- 没有技术背景,但想在 Mac 上体验 AI 助手的普通用户
- 想在 Mac 上部署 OpenClaw 但还没动手的
- 安装过程中遇到问题想找解决方案的
- 想了解 OpenClaw 能做什么、值不值得折腾的
接下来我会从最最基础的操作开始,一步一步带你走完整个流程。
OpenClaw 是什么
简单来说,OpenClaw 是一个开源的个人 AI 助手框架。
它本身不提供大语言模型,但可以帮你把 Claude、GPT、DeepSeek、Gemini 这些主流模型串联起来,再对接到 Telegram、WhatsApp、飞书、Discord 等聊天平台上,形成一个真正属于你自己的 AI 助手。
它能做的事情挺多的:
- 多模型调用:同时接入多个 AI 模型(比如 DeepSeek、GPT、Claude),根据需要灵活切换
- 聊天平台对接:把 AI 能力接入你日常使用的通讯工具,比如飞书、Telegram、微信等
- 本地文件管理:让 AI 帮你处理和管理电脑上的文档
- 浏览器自动化:让 AI 帮你完成一些重复性的网页操作
- 对话式操控:用聊天的方式让 AI 帮你在电脑上执行各种操作
- 记忆系统:AI 能记住之前聊过的内容,不会每次都"失忆"
截至 2026 年初,OpenClaw 在 GitHub 上已经有超过 6 万颗星,社区非常活跃。它采用 MIT 开源许可,完全免费使用。
部署前的准备工作
系统和硬件要求
在动手之前,先确认一下你的 Mac 是否满足条件:
| 项目 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | macOS 10.15 及以上 | macOS 14 (Sonoma) 及以上 |
| 处理器 | Intel 或 Apple Silicon 均可 | M 系列芯片体验更佳 |
| 内存 | 8 GB | 16 GB |
| 硬盘空间 | 预留 10 GB | 20 GB 以上更稳妥 |
| 网络 | 能正常上网即可(国内网络就行) | 稳定的宽带连接 |
如果你用的是 M1、M2、M3 或 M4 芯片的 Mac,体验会特别好——Apple Silicon 的单线程性能很强,跑 Node.js 非常流畅,而且功耗极低。
需要提前准备的东西
- 一台 Mac 电脑:能正常开机、能上网就行
- AI 模型的 API Key:这个相当于一把"钥匙",用来让 OpenClaw 调用 AI 模型。国内用户推荐先用 DeepSeek、Kimi,注册就送免费额度,网络也不用额外折腾。(后面会详细说怎么获取)
- 大约 30 分钟的时间:第一次安装预留半小时比较稳妥,熟练之后十来分钟就够了
不需要你会编程,不需要你懂代码,跟着下面的步骤一步步操作就行。
先认识一下"终端"——你的安装工具
在开始之前,我们需要先认识一个工具——终端(Terminal)。
你可以把终端理解为"用打字的方式和电脑对话"。
平时你用鼠标点击图标来打开软件、拷贝文件,而终端是用键盘输入文字命令来完成这些操作。
虽然看起来是个黑底白字的窗口,但其实操作起来并不难,就是把命令复制粘贴进去而已。
怎么打开终端
有两种方式,选一种你顺手的:
方式一:用聚焦搜索(推荐)
- 同时按下键盘上的
Command ⌘键和空格键 - 屏幕中央会弹出一个搜索框
- 输入
Terminal或者"终端" - 按回车键,终端就打开了
方式二:从访达打开
- 打开"访达"(就是你 Dock 栏上那个笑脸图标)
- 点击顶部菜单栏的"前往" → “实用工具”
- 在里面找到"终端",双击打开
打开后你会看到一个窗口,里面可能显示类似这样的文字:
你的用户名@你的电脑名 ~ %这就是终端的"命令行",光标在闪烁,等着你输入命令。
大概长这样子:
在终端里怎么输入命令
非常简单,就三步:
- 复制命令:用鼠标选中本文中灰色方框里的命令文字,按
Command + C复制 - 粘贴到终端:点击终端窗口,按
Command + V粘贴 - 执行命令:按一下
回车键(Enter)
就这么简单!后面所有步骤都是这样操作:复制 → 粘贴 → 回车。
温馨提示:终端里输入密码时,屏幕上不会显示任何字符(连星号都没有),这是正常的安全机制。
只管输入你的 Mac 开机密码,输完按回车就行。
安装基础环境
OpenClaw 需要一个叫做 Node.js 的运行环境才能工作。
你可以把 Node.js 理解成 OpenClaw 的"地基"——没有它,OpenClaw 就跑不起来。
别担心,安装过程就是在终端里复制粘贴几条命令而已。
第一步:安装 Homebrew(Mac 的软件管家)
Homebrew 是 macOS 上的一个"软件安装管家",有了它,后面安装 Node.js 只需要一条命令就能搞定。
很多 Mac 上的开发工具都通过它来安装,装一次以后会经常用到。
如果你之前已经装过 Homebrew 了,可以直接跳到下一步。
不确定有没有装?在终端里输入 brew -v 然后回车,如果显示版本号就说明已经装了。
安装方法(推荐国内镜像,不用访问外网):
由于 Homebrew 官方安装脚本的服务器在国外,国内直接装可能会很慢甚至失败。这里推荐使用国内镜像源安装,速度快、不需要任何特殊网络环境。
打开终端,复制下面这行命令,粘贴进去,按回车:
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"执行后会出现一个菜单让你选镜像源,输入数字 1(中科大源)然后回车即可。
过程中可能会让你输入 Mac 的开机密码(输入时屏幕上不显示任何字符,这是正常的),输完按回车。
安装可能需要几分钟,耐心等一下。完成后关闭终端,重新打开一个新的终端窗口,然后验证一下:
brew -v看到类似 Homebrew 4.x.x 的输出就说明没问题了。
备选方案:如果你的网络条件比较好,也可以用 Homebrew 官方安装命令:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
第二步:安装 Node.js
有了 Homebrew,安装 Node.js 就非常简单了。在终端里执行:
brew install node等它自动下载安装完成(大概 1-3 分钟),然后确认一下版本是否正确:
node -v在终端回车后,应该显示 v22.x.x 或者更高的数字(比如 v22.11.0)。再检查一下附带的包管理工具:
npm -v显示 10.x.x 就行。
如果
node -v显示的版本号低于 22(比如v18.x.x),说明你之前装过旧版本。在终端执行brew upgrade node来升级到最新版。
第三步:配置 npm 全局路径(强烈建议做)
这一步是为了避免后面安装 OpenClaw 时碰到"权限不够"的报错。只需要执行下面 4 条命令,每条都是复制粘贴然后回车:
mkdir -p ~/.npm-globalnpm config set prefix '~/.npm-global'echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrcsource ~/.zshrc说明:上面 4 条命令的作用是告诉电脑"以后安装的全局软件放到你自己的目录里",这样安装时就不会碰到权限问题了。
验证一下配置是否成功:
npm config get prefix输出里包含 .npm-global 就对了。
第四步:配置 npm 国内镜像源(推荐做)
npm 默认从国外服务器下载软件包,国内可能会比较慢。配置成国内镜像源后,下载速度会快很多。在终端执行:
npm config set registry https://registry.npmmirror.com这条命令把 npm 的下载源切换到了淘宝镜像(npmmirror),国内访问速度很快,后面安装 OpenClaw 就不用担心下载慢的问题了。
安装 OpenClaw
基础环境搭好了,接下来正式安装 OpenClaw。这里提供两种方式,普通用户直接看方式一就行。
方式一:一键脚本安装(推荐所有人)
这是官方推荐的方式,也是最省事的。把下面这条命令复制到终端,回车执行:
curl -fsSL https://openclaw.ai/install.sh | bash这条命令在做什么? 它会自动从 OpenClaw 官网下载安装程序,然后自动帮你完成安装。就像你在 App Store 里点"获取"一样,只不过这里是用命令的方式。
国内网络提示:如果这条命令执行后一直卡着不动(等了超过 2 分钟),可以按
Ctrl + C中断,然后改用下面的方式二(npm 安装),效果是一样的。
脚本会自动完成以下操作:
- 检测你的系统环境
- 确认 Node.js 版本是否达标(不够的话会尝试自动安装)
- 下载并安装最新版 OpenClaw
- 在你的电脑上创建默认配置
- 启动初始化引导
整个过程大概 2-5 分钟。安装结束后,验证一下是否装好了:
openclaw --version能看到版本号(比如 v2026.2.6)输出就说明安装成功了!
方式二:npm 安装(国内网络更友好)
如果方式一因为网络原因失败了,或者下载太慢,用 npm 安装反而更顺畅(因为前面已经配好了国内镜像源)。在终端执行:
npm install -g openclaw@latest安装完成后手动执行引导:
openclaw onboard --install-daemon如果安装报错了怎么办? 如果看到包含
sharp或者EACCES字样的错误,试试这个命令:SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest如果还是不行,往后翻到"常见问题"部分,那里有更详细的解决方案。
方式三:从源码构建(仅开发者需要)
如果你是开发者,想深入研究 OpenClaw 的代码或者参与贡献,可以从源码构建。普通用户可以跳过这部分。
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
pnpm link --global
openclaw onboard --install-daemon这种方式需要提前装好 pnpm。如果没有的话,先执行 npm install -g pnpm。
初始化与配置
运行初始化向导
如果你用的是一键脚本安装,引导流程会自动启动。如果没有自动启动,或者你用的是 npm 安装,在终端执行:
openclaw onboard接下来屏幕上会出现一个交互式向导,用键盘上的方向键选择选项,按回车键确认。它会依次问你几个问题:
- 启动模式:用方向键选择
QuickStart(快速开始),然后按回车 - AI 模型选择:这里选你打算用的 AI 模型。如果你还没注册任何模型账号,可以先选 Qwen(通义千问)——它可以扫码直接使用,不需要填 Key
- API Key 输入:如果选了需要 Key 的模型(比如 DeepSeek),把你的密钥粘贴进去。没有的话暂时跳过,后面可以再配
- 聊天平台:选你想对接的通讯工具(飞书、Telegram 等),也可以先跳过
什么是 API Key? 简单说就是一个"通行证"。你注册了 AI 模型的账号后,在它的后台可以生成一串字符(通常以
sk-开头),有了这串字符,OpenClaw 才能调用这个 AI 模型。就像你有了门卡才能刷卡进小区一样。
完成后,OpenClaw 会在你的电脑上生成核心配置文件,准备工作就算做好了。
手动编辑配置文件(一般不需要)
大部分情况下,通过上面的向导就能完成配置。但如果你后续需要修改设置(比如换一个 AI 模型、改端口号等),可以手动编辑配置文件。
配置文件的位置在:~/.openclaw/openclaw.json
~是什么意思? 在 Mac 里,~代表你的"个人文件夹",也就是/Users/你的用户名/这个目录。~/.openclaw/就是你个人文件夹下面一个叫.openclaw的隐藏文件夹(文件夹名前面有个点就表示是隐藏的)。
修改前先备份一下(好习惯,万一改坏了还能恢复):
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak然后用你喜欢的编辑器打开修改。不知道用什么编辑器?最简单的方式是在终端输入:
open -e ~/.openclaw/openclaw.json这样会用 Mac 自带的"文本编辑"应用打开配置文件。
这里给一个接入 DeepSeek 模型的基础配置示例,你可以参考:
{
"models": {
"mode": "merge",
"providers": {
"deepseek": {
"baseUrl": "https://api.deepseek.com/v1",
"apiKey": "sk-替换成你自己的Key",
"api": "openai-completions",
"models": [
{
"id": "deepseek-chat",
"name": "DeepSeek Chat",
"input": ["text"],
"contextWindow": 128000,
"maxTokens": 8192,
"reasoning": false
}
]
}
}
},
"agents": {
"defaults": {
"maxConcurrent": 4,
"model": {
"primary": "deepseek/deepseek-chat"
}
}
},
"gateway": {
"port": 18789,
"mode": "local"
}
}如果你想用 Kimi(月之暗面)模型,把 providers 里的内容换成下面这样就行。
Kimi 最大的优势是支持 200 万字的超长上下文,特别适合处理长文档,而且 Kimi 注册有送免费额度,可以试一下:
{
"models": {
"mode": "merge",
"providers": {
"moonshot": {
"baseUrl": "https://api.moonshot.cn/v1",
"apiKey": "sk-替换成你的Kimi Key",
"api": "openai-completions",
"models": [
{
"id": "moonshot-v1-8k",
"name": "Kimi 8K",
"input": ["text"],
"contextWindow": 8000,
"maxTokens": 4096,
"reasoning": false
},
{
"id": "moonshot-v1-128k",
"name": "Kimi 128K",
"input": ["text"],
"contextWindow": 128000,
"maxTokens": 4096,
"reasoning": false
}
]
}
}
},
"agents": {
"defaults": {
"maxConcurrent": 4,
"model": {
"primary": "moonshot/moonshot-v1-8k"
}
}
},
"gateway": {
"port": 18789,
"mode": "local"
}
}提示:Kimi 的 API Key 可以在 Moonshot AI 开放平台 注册获取。日常对话用
moonshot-v1-8k就够了(更省 Token),需要分析长文档时再切换到moonshot-v1-128k。
修改时的注意事项(很重要,不注意就会报错):
apiKey后面的值一定要替换成你自己的真实 Key- 所有标点符号都必须是英文半角的。最容易出错的是引号
"和冒号:,中文输入法下打出来的是""和:,这些都会导致报错 - 不要在文件里加注释或者多余的文字
验证配置是否正确
改完配置后,建议验证一下格式是否正确。在终端执行:
openclaw doctor这个命令会做一次全面检查,包括配置文件格式、Node.js 版本、API Key 是否可用等。如果一切正常,你会看到一连串的绿色对勾。如果有问题,它会告诉你具体哪里出了错。
接入 AI 模型
选择适合你的模型
OpenClaw 本身不自带 AI 大脑,你需要接入至少一个第三方 AI 服务,让它"有脑子"。
打个比方:OpenClaw 像是一台收音机,AI 模型是电台。收音机本身不产生节目,但调好频道就能听到精彩内容了。
下面是几个主流选项的对比:
| 模型 | 优势 | 适合谁 | 国内能直接用吗 |
|---|---|---|---|
| DeepSeek | 便宜好用,中文理解强 | 大部分国内用户(推荐) | ✅ 可以 |
| Qwen(通义千问) | 扫码就能用,零门槛 | 完全不想折腾的新手 | ✅ 可以 |
| Kimi | 200 万字超长上下文 | 需要处理长文档的人 | ✅ 可以 |
| 智谱 GLM | 中文能力强,免费额度多 | 注重中文场景的用户 | ✅ 可以 |
| Claude | 对话质量最顶级 | 追求最佳体验的用户 | ❌ 需要特殊网络 |
| GPT | 功能最全面 | 有国际网络条件的用户 | ❌ 需要特殊网络 |
我的建议:如果你在国内,直接用 DeepSeek 就好。注册简单、价格便宜、国内网络直连没有任何问题,而且中文对话效果很不错。
本教程后面的配置也以 DeepSeek 为例来演示,全程不需要访问外网。
关于 Claude 和 GPT:这两个模型的 API 服务器在海外,国内普通网络无法直接访问。如果你没有特殊的网络环境,不用考虑它们——上面列的国产模型(DeepSeek、Qwen、Kimi、智谱)完全够用,而且在中文场景下表现甚至更好。
配置 DeepSeek(国内推荐)
下面手把手教你获取 DeepSeek 的 API Key:
第 1 步:注册账号
- 打开浏览器,访问 DeepSeek 开放平台
- 点击"注册",用手机号注册一个账号
- 注册完成后登录
第 2 步:获取 API Key
- 登录后,在左侧菜单找到"API Keys"(或"密钥管理")
- 点击"创建新密钥"
- 系统会生成一串以
sk-开头的字符串,立刻复制保存好!这个密钥只会显示一次,关掉页面就看不到了 - 建议把它存到备忘录或者记事本里备用
关于费用:DeepSeek 注册后一般会送免费额度,日常个人使用很长时间都用不完。后续不够了再充值也很便宜。
第 3 步:把 Key 填进 OpenClaw
在终端执行下面的命令(把 sk-你的密钥 替换成你刚才复制的那串字符):
openclaw config set models.providers.deepseek.apiKey "sk-你的密钥"配置其他国产模型(同样不需要外网)
除了 DeepSeek,你还可以同时接入其他国产模型。比如 Kimi 擅长处理超长文档,智谱 GLM 的中文理解很强,多配几个模型就能根据不同场景灵活切换:
# Kimi(月之暗面)
openclaw config set moonshot.apiKey "你的Kimi密钥"
# 智谱 GLM
openclaw config set zhipu.apiKey "你的智谱密钥"进阶用户补充:如果你有访问海外服务的网络条件,也可以额外接入 Claude 或 GPT 等国际模型:
openclaw config set anthropic.apiKey "sk-ant-你的密钥" openclaw config set openai.apiKey "sk-你的密钥"但这些模型的 API 在国内无法直连,普通用户可以忽略。
配置多个模型的好处是可以随时切换。比如简单的日常聊天用便宜的 DeepSeek,遇到需要深度分析的任务切换到 Claude,这样既省钱又能保证效果。
启动与验证
启动网关服务
一切配置就绪后,就可以启动 OpenClaw 了!在终端执行:
openclaw gateway start启动成功后,运行以下命令确认状态:
openclaw status看到 Gateway reachable 或类似的正常状态提示,就说明服务已经跑起来了。
启动失败怎么办? 如果提示端口被占用(包含
already in use字样),先执行下面的命令清理一下,然后重新启动:lsof -i :18789 | grep -v PID | awk '{print $2}' | xargs kill -9 2>/dev/null
访问 Web 界面
现在到了最激动人心的时刻——打开浏览器(Safari、Chrome 都行),在地址栏输入:
http://127.0.0.1:18789这个地址是什么意思?
127.0.0.1是"本机"的意思,也就是你自己的电脑。18789是 OpenClaw 使用的端口号。所以这个地址的意思是"访问自己电脑上的 OpenClaw 服务"。
你应该能看到 OpenClaw 的控制台界面。试着在输入框里发一条消息,比如"你好"或者"帮我写一首诗"。
如果几秒钟内收到了 AI 的回复,恭喜你——部署成功了! 🎉
也可以通过终端命令直接打开控制台:
openclaw dashboard设置开机自启
每次重启电脑都要手动启动 OpenClaw 肯定很麻烦。你可以设置成开机自动启动:
openclaw gateway install这样你的 Mac 每次开机,OpenClaw 都会在后台自动运行,不需要你手动操作。
如果以后想取消开机自启:
openclaw gateway uninstall接入聊天工具(可选)
到这里 OpenClaw 已经可以用了,你可以在浏览器的 Web 界面里和 AI 聊天。
如果你还想更进一步,把 AI 接入到你日常用的聊天工具里(比如飞书、Telegram),这样就能直接在聊天软件里跟你的 AI 助手对话。这一步不是必须的,感兴趣的话可以试试。
以飞书为例,大致流程是这样的:
- 先安装飞书插件:
openclaw plugins install @m1heng-clawd/feishu-
去 飞书开放平台 注册一个开发者账号,创建一个应用,拿到 App ID 和 App Secret
-
在终端里配置飞书的连接信息(把
cli_你的AppID和你的AppSecret替换成真实的值):
openclaw config set channels.feishu '{"enabled":true,"appId":"cli_你的AppID","appSecret":"你的AppSecret"}' --json- 重启 OpenClaw 让配置生效:
openclaw gateway restart配置完成后,你就可以在飞书里直接和你的 AI 助手对话了。
Telegram 用户:Telegram 的配置更简单。在 Telegram 里找到 @BotFather 创建一个机器人,它会给你一个 Bot Token,把这个 Token 填到 OpenClaw 配置里就行。
日常运维管理
部署完成后,日常用到的命令不多,这里列一份"速查表",建议收藏一下:
| 你想做什么 | 在终端输入的命令 |
|---|---|
| 启动 OpenClaw | openclaw gateway start |
| 停止 OpenClaw | openclaw gateway stop |
| 重启 OpenClaw | openclaw gateway restart |
| 查看是否在运行 | openclaw status |
| 做一次全面检查 | openclaw doctor |
| 查看运行日志 | openclaw gateway logs |
| 更新到最新版 | openclaw update |
| 打开 Web 控制台 | openclaw dashboard |
关于更新:OpenClaw 的更新频率挺高的,建议隔一两周更新一次。更新前先备份一下配置,以防万一:
cp -r ~/.openclaw ~/openclaw-backup-$(date +%Y%m%d)然后执行更新:
openclaw update完整卸载与重置
如果你想彻底移除 OpenClaw 重新来过,在终端依次执行下面的命令。每条命令复制粘贴后按回车:
openclaw gateway stoppkill -f openclawnpm uninstall -g openclawrm -rf ~/.openclawrm -rf /tmp/openclaw执行完后,检查一下是否清理干净:
ps -ef | grep openclaw | grep -v grep如果这条命令没有输出任何内容,说明已经彻底清理干净了。
常见问题
Q1:安装时提示 “command not found: openclaw” 怎么办?
这是最常见的问题,意思是电脑"找不到"你刚装好的 OpenClaw。原因通常是安装路径没有告诉系统。
在终端依次执行下面两条命令:
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrcsource ~/.zshrc然后再试试 openclaw --version,应该就能正常识别了。
Q2:安装 Homebrew 时一直卡住不动怎么办?
这通常是网络问题。Homebrew 的安装源在国外,国内访问可能比较慢。你可以尝试使用国内镜像源安装。在终端执行:
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"这个脚本会引导你选择镜像源(推荐选中科大或清华源),然后自动完成安装。
Q3:Node.js 版本不够怎么升级?
在终端执行:
brew upgrade node升级完后用 node -v 确认版本号是否达到 22 以上。
Q4:终端里输入密码时屏幕没反应,是不是坏了?
没坏!这是 Mac 终端的安全设计。当你输入密码时,屏幕上故意不显示任何字符(连星号 * 都没有),目的是防止旁边的人看到你密码有几位。
直接输入你的 Mac 开机密码,输完按回车就行。即使看不到任何东西,其实已经在输入了。
Q5:配置文件报 JSON 语法错误怎么排查?
最常见的原因:
- 用了中文标点:比如中文的冒号
:、逗号,、引号""。必须全部使用英文标点 - 字符串没有用英文双引号
"包裹 - 最后一个字段后面多了一个逗号
- 在配置文件里面写了中文注释
最简单的排查方法:把配置文件的内容复制到 jsonlint.com 这个网站上,点"Validate JSON"按钮,它会告诉你具体哪一行出了问题。
Q6:端口 18789 被占用了怎么办?
在终端执行:
lsof -i :18789这条命令会显示是哪个程序占用了这个端口。找到对应的 PID 号(一串数字),然后执行:
kill -9 这里替换成PID号如果这个端口确实被其他程序长期使用,你可以让 OpenClaw 换一个端口:
openclaw gateway --port 18790Q7:Web 界面能打开但 AI 不回复消息?
按以下顺序排查:
- API Key 是否有效:有可能过期了或者余额用完了。去你注册的 AI 模型网站(比如 DeepSeek 的控制台)检查一下
- 运行诊断:在终端执行
openclaw doctor,看看哪里报红 - 查看日志:执行
openclaw gateway logs,看最后几行有没有包含error的信息 - 网络问题:如果用的是 DeepSeek 等国产模型,国内网络正常就能用。如果用的是 Claude 或 GPT 等海外模型,需要确认你的网络能正常访问对应的 API 服务器
Q8:macOS 弹出"是否允许网络连接"怎么处理?
直接点"允许"就好。OpenClaw 需要联网才能调用 AI 模型,这是正常的网络请求。
Q9:安装时遇到 EACCES 权限错误怎么解决?
这是因为 npm 安装时权限不够。如果你之前跳过了"配置 npm 全局路径"那一步,现在回去做一下就能解决。
或者临时解决:在安装命令前面加上 sudo,比如 sudo npm install -g openclaw@latest,然后输入你的 Mac 密码。
Q10:我什么都不懂,能不能更简单地用上 AI?
如果你觉得上面的步骤还是太复杂,有一个更简单的临时方案:在初始化向导中选择 Qwen(通义千问) 作为 AI 模型。它不需要你去注册账号、不需要获取 API Key,只需要用手机扫个码就能直接用了。等你熟悉了 OpenClaw 之后,再切换到 DeepSeek 等其他模型也来得及。
总结
回顾一下,整个安装过程其实就是在终端里复制粘贴命令,核心就四步:
- 装地基:安装 Homebrew 和 Node.js(就像装 App 前先装应用商店)
- 装 OpenClaw:一条命令搞定
- 填密钥:告诉 OpenClaw 用哪个 AI 模型、填上 API Key
- 启动验证:打开浏览器看看能不能和 AI 聊天
整个过程顺利的话二十分钟就能搞定。而且全程使用国内镜像源和国产 AI 模型(比如 DeepSeek),不需要任何特殊网络环境,普通家庭宽带就够了。即使你是第一次用终端,跟着本文的步骤一步步操作,也不会有什么大问题。遇到报错不要慌,往上翻翻常见问题部分,大部分坑都覆盖到了。
OpenClaw 这个项目目前还在非常活跃地迭代,社区也很友好。如果你想要一个灵活、可控、支持多模型多平台的本地 AI 助手,它是目前开源方案里非常值得尝试的一个。
如果大家在 Mac 上部署安装 OpenClaw 的过程中还有哪些没弄明白的地方,或者遇到了文中没提到的问题,欢迎在评论区交流讨论~~~ 我看到都会尽量回复的。特别是零基础的朋友,不要怕问"傻问题",每个人都是从不会开始的。也欢迎已经部署成功的朋友分享一下你们的使用体验和玩法!
版权声明
未经授权,禁止转载本文章。
如需转载请保留原文链接并注明出处。即视为默认获得授权。
未保留原文链接未注明出处或删除链接将视为侵权,必追究法律责任!
本文原文链接: https://fiveyoboy.com/articles/mac-deploy-install-openclaw-tutorial/
备用原文链接: https://blog.fiveyoboy.com/articles/mac-deploy-install-openclaw-tutorial/