我折腾了好一阵子才把 OpenClaw 在我的 MacBook 上跑起来。
这中间踩了不少坑——环境版本不对、配置文件格式出错、端口被占用等等，都是些看着不大但能让人卡半天的问题。
所以我把整个过程整理成了这篇教程，尽量写得详细一些，让大家少走弯路。
这篇教程写给完全没有编程经验的普通用户，即使你从来没用过终端（就是那个黑底白字的窗口），跟着做也能顺利装好。
每一步我都会说清楚该点哪里、该输入什么，不会跳过任何”看似简单”的步骤。
这篇文章适合以下几类朋友：
- 没有技术背景，但想在 Mac 上体验 AI 助手的普通用户
- 想在 Mac 上部署 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 是否满足条件：
如果你用的是 M1、M2、M3 或 M4 芯片的 Mac，体验会特别好——Apple Silicon 的单线程性能很强，跑 Node.js 非常流畅，而且功耗极低。
- 一台 Mac 电脑：能正常开机、能上网就行
- AI 模型的 API Key：这个相当于一把”钥匙”，用来让 OpenClaw 调用 AI 模型。国内用户推荐先用 DeepSeek、Kimi，注册就送免费额度，网络也不用额外折腾。（后面会详细说怎么获取）
- 大约 30 分钟的时间：第一次安装预留半小时比较稳妥，熟练之后十来分钟就够了
不需要你会编程，不需要你懂代码，跟着下面的步骤一步步操作就行。
在开始之前，我们需要先认识一个工具——终端（Terminal）。
你可以把终端理解为”用打字的方式和电脑对话”。
平时你用鼠标点击图标来打开软件、拷贝文件，而终端是用键盘输入文字命令来完成这些操作。
虽然看起来是个黑底白字的窗口，但其实操作起来并不难，就是把命令复制粘贴进去而已。
有两种方式，选一种你顺手的：
方式一：用聚焦搜索（推荐）
- 同时按下键盘上的 键和键
- 屏幕中央会弹出一个搜索框
- 输入 或者”终端”
- 按回车键，终端就打开了
方式二：从访达打开
- 打开”访达”（就是你 Dock 栏上那个笑脸图标）
- 点击顶部菜单栏的”前往” → “实用工具”
- 在里面找到”终端”，双击打开
打开后你会看到一个窗口，里面可能显示类似这样的文字：
这就是终端的”命令行”，光标在闪烁，等着你输入命令。
大概长这样子：
非常简单，就三步：
- 复制命令：用鼠标选中本文中灰色方框里的命令文字，按 复制
- 粘贴到终端：点击终端窗口，按 粘贴
- 执行命令：按一下
就这么简单！后面所有步骤都是这样操作：复制 → 粘贴 → 回车。
温馨提示：终端里输入密码时，屏幕上不会显示任何字符（连星号都没有），这是正常的安全机制。
只管输入你的 千问 Qwen 教程 Mac 开机密码，输完按回车就行。
OpenClaw 需要一个叫做 Node.js 的运行环境才能工作。
你可以把 Node.js 理解成 OpenClaw 的”地基”——没有它，OpenClaw 就跑不起来。
别担心，安装过程就是在终端里复制粘贴几条命令而已。
Homebrew 是 macOS 上的一个”软件安装管家”，有了它，后面安装 Node.js 只需要一条命令就能搞定。
很多 Mac 上的开发工具都通过它来安装，装一次以后会经常用到。
如果你之前已经装过 Homebrew 了，可以直接跳到下一步。
不确定有没有装？在终端里输入 然后回车，如果显示版本号就说明已经装了。
安装方法（推荐国内镜像，不用访问外网）：
由于 Homebrew 官方安装脚本的服务器在国外，国内直接装可能会很慢甚至失败。这里推荐使用国内镜像源安装，速度快、不需要任何特殊网络环境。
打开终端，复制下面这行命令，粘贴进去，按回车：
如图：
执行后会出现一个菜单让你选镜像源，输入数字 1（中科大源）然后回车即可。
过程中可能会让你输入 Mac 的开机密码（输入时屏幕上不显示任何字符，这是正常的），输完按回车。
安装可能需要几分钟，耐心等一下。完成后关闭终端，重新打开一个新的终端窗口，然后验证一下：
看到类似 的输出就说明没问题了。
备选方案：如果你的网络条件比较好，也可以用 Homebrew 官方安装命令：
有了 Homebrew，安装 Node.js 就非常简单了。在终端里执行：
等它自动下载安装完成（大概 1-3 分钟），然后确认一下版本是否正确：
在终端回车后，应该显示 或者更高的数字（比如 ）。再检查一下附带的包管理工具：
显示 就行。
如果 显示的版本号低于 22（比如 ），说明你之前装过旧版本。在终端执行 来升级到最新版。
这一步是为了避免后面安装 OpenClaw 时碰到”权限不够”的报错。只需要执行下面 4 条命令，每条都是复制粘贴然后回车：
说明：上面 4 条命令的作用是告诉电脑”以后安装的全局软件放到你自己的目录里”，这样安装时就不会碰到权限问题了。
验证一下配置是否成功：
输出里包含 就对了。
npm 默认从国外服务器下载软件包，国内可能会比较慢。配置成国内镜像源后，下载速度会快很多。在终端执行：
这条命令把 npm 的下载源切换到了淘宝镜像（npmmirror），国内访问速度很快，后面安装 OpenClaw 就不用担心下载慢的问题了。
基础环境搭好了，接下来正式安装 OpenClaw。这里提供两种方式，普通用户直接看方式一就行。
这是官方推荐的方式，也是最省事的。把下面这条命令复制到终端，回车执行：
这条命令在做什么？ 它会自动从 OpenClaw 官网下载安装程序，然后自动帮你完成安装。就像你在 App Store 里点”获取”一样，只不过这里是用命令的方式。
国内网络提示：如果这条命令执行后一直卡着不动（等了超过 2 分钟），可以按 中断，然后改用下面的方式二（npm 安装），效果是一样的。
脚本会自动完成以下操作：
- 检测你的系统环境
- 确认 Node.js 版本是否达标（不够的话会尝试自动安装）
- 下载并安装最新版 OpenClaw
- 在你的电脑上创建默认配置
- 启动初始化引导
整个过程大概 2-5 分钟。安装结束后，验证一下是否装好了：
能看到版本号（比如 ）输出就说明安装成功了！
如果方式一因为网络原因失败了，或者下载太慢，用 npm 安装反而更顺畅（因为前面已经配好了国内镜像源）。在终端执行：
安装完成后手动执行引导：
如果安装报错了怎么办？ 如果看到包含 或者 字样的错误，试试这个命令：
如果还是不行，往后翻到”常见问题”部分，那里有更详细的解决方案。
如果你是开发者，想深入研究 OpenClaw 的代码或者参与贡献，可以从源码构建。普通用户可以跳过这部分。
这种方式需要提前装好 。如果没有的话，先执行 。
如果你用的是一键脚本安装，引导流程会自动启动。如果没有自动启动，或者你用的是 npm 安装，在终端执行：
接下来屏幕上会出现一个交互式向导，用键盘上的方向键选择选项，按回车键确认。它会依次问你几个问题：
- 启动模式：用方向键选择 （快速开始），然后按回车
- AI 模型选择：这里选你打算用的 AI 模型。如果你还没注册任何模型账号，可以先选 Qwen（通义千问）——它可以扫码直接使用，不需要填 Key
- API Key 输入：如果选了需要 Key 的模型（比如 DeepSeek），把你的密钥粘贴进去。没有的话暂时跳过，后面可以再配
- 聊天平台：选你想对接的通讯工具（飞书、Telegram 等），也可以先跳过
什么是 API Key？ 简单说就是一个”通行证”。你注册了 AI 模型的账号后，在它的后台可以生成一串字符（通常以 开头），有了这串字符，OpenClaw 才能调用这个 AI 模型。就像你有了门卡才能刷卡进小区一样。
完成后，OpenClaw 会在你的电脑上生成核心配置文件，准备工作就算做好了。
大部分情况下，通过上面的向导就能完成配置。但如果你后续需要修改设置（比如换一个 AI 模型、改端口号等），可以手动编辑配置文件。
配置文件的位置在：
是什么意思？ 在 Mac 里， 代表你的”个人文件夹”，也就是 这个目录。 就是你个人文件夹下面一个叫 的隐藏文件夹（文件夹名前面有个点就表示是隐藏的）。
修改前先备份一下（好习惯，万一改坏了还能恢复）：
然后用你喜欢的编辑器打开修改。不知道用什么编辑器？最简单的方式是在终端输入：
这样会用 Mac 自带的”文本编辑”应用打开配置文件。
这里给一个接入 DeepSeek 模型的基础配置示例，你可以参考：
如果你想用 Kimi（月之暗面）模型，把 里的内容换成下面这样就行。
Kimi 最大的优势是支持 200 万字的超长上下文，特别适合处理长文档，而且 Kimi 注册有送免费额度，可以试一下：
提示：Kimi 的 API Key 可以在 Moonshot AI 开放平台 注册获取。日常对话用 就够了（更省 Token），需要分析长文档时再切换到 。
修改时的注意事项（很重要，不注意就会报错）：
- 后面的值一定要替换成你自己的真实 Key
- 所有标点符号都必须是英文半角的。最容易出错的是引号 和冒号 ，中文输入法下打出来的是 和 ，这些都会导致报错
- 不要在文件里加注释或者多余的文字
改完配置后，建议验证一下格式是否正确。在终端执行：
这个命令会做一次全面检查，包括配置文件格式、Node.js 版本、API Key 是否可用等。如果一切正常，你会看到一连串的绿色对勾。如果有问题，它会告诉你具体哪里出了错。
OpenClaw 本身不自带 AI 大脑，你需要接入至少一个第三方 AI 服务，让它”有脑子”。
打个比方：OpenClaw 像是一台收音机，AI 模型是电台。收音机本身不产生节目，但调好频道就能听到精彩内容了。
下面是几个主流选项的对比：
我的建议：如果你在国内，直接用 DeepSeek 就好。注册简单、价格便宜、国内网络直连没有任何问题，而且中文对话效果很不错。
本教程后面的配置也以 DeepSeek 为例来演示，全程不需要访问外网。
关于 Claude 和 GPT：这两个模型的 API 服务器在海外，国内普通网络无法直接访问。如果你没有特殊的网络环境，不用考虑它们——上面列的国产模型（DeepSeek、Qwen、Kimi、智谱）完全够用，而且在中文场景下表现甚至更好。
下面手把手教你获取 DeepSeek 的 API Key：
第 1 步：注册账号
- 打开浏览器，访问 DeepSeek 开放平台
- 点击”注册”，用手机号注册一个账号
- 注册完成后登录
第 2 步：获取 API Key
- 登录后，在左侧菜单找到”API Keys”（或”密钥管理”）
- 点击”创建新密钥”
- 系统会生成一串以 开头的字符串，立刻复制保存好！这个密钥只会显示一次，关掉页面就看不到了
- 建议把它存到备忘录或者记事本里备用
关于费用：DeepSeek 注册后一般会送免费额度，日常个人使用很长时间都用不完。后续不够了再充值也很便宜。
第 3 步：把 Key 填进 OpenClaw
在终端执行下面的命令（把 替换成你刚才复制的那串字符）：
除了 DeepSeek，你还可以同时接入其他国产模型。比如 Kimi 擅长处理超长文档，智谱 GLM 的中文理解很强，多配几个模型就能根据不同场景灵活切换：
进阶用户补充：如果你有访问海外服务的网络条件，也可以额外接入 Claude 或 GPT 等国际模型：
但这些模型的 API 在国内无法直连，普通用户可以忽略。
配置多个模型的好处是可以随时切换。比如简单的日常聊天用便宜的 DeepSeek，遇到需要深度分析的任务切换到 Claude，这样既省钱又能保证效果。
一切配置就绪后，就可以启动 OpenClaw 了！在终端执行：
启动成功后，运行以下命令确认状态：
看到 或类似的正常状态提示，就说明服务已经跑起来了。
启动失败怎么办？ 如果提示端口被占用（包含 字样），先执行下面的命令清理一下，然后重新启动：
现在到了最激动人心的时刻——打开浏览器（Safari、Chrome 都行），在地址栏输入：
这个地址是什么意思？ 是”本机”的意思，也就是你自己的电脑。 是 OpenClaw 使用的端口号。所以这个地址的意思是”访问自己电脑上的 OpenClaw 服务”。
你应该能看到 OpenClaw 的控制台界面。试着在输入框里发一条消息，比如”你好”或者”帮我写一首诗”。
如果几秒钟内收到了 AI 的回复，恭喜你——部署成功了！ 🎉
也可以通过终端命令直接打开控制台：
每次重启电脑都要手动启动 OpenClaw 肯定很麻烦。你可以设置成开机自动启动：
这样你的 Mac 每次开机，OpenClaw 都会在后台自动运行，不需要你手动操作。
如果以后想取消开机自启：
到这里 OpenClaw 已经可以用了，你可以在浏览器的 Web 界面里和 AI 聊天。
如果你还想更进一步，把 AI 接入到你日常用的聊天工具里（比如飞书、Telegram），这样就能直接在聊天软件里跟你的 AI 助手对话。这一步不是必须的，感兴趣的话可以试试。
以飞书为例，大致流程是这样的：
- 先安装飞书插件：
- 去 飞书开放平台 注册一个开发者账号，创建一个应用，拿到 App ID 和 App Secret
- 在终端里配置飞书的连接信息（把 和 替换成真实的值）：
- 重启 OpenClaw 让配置生效：
配置完成后，你就可以在飞书里直接和你的 AI 助手对话了。
Telegram 用户：Telegram 的配置更简单。在 Telegram 里找到 @BotFather 创建一个机器人，它会给你一个 Bot Token，把这个 Token 填到 OpenClaw 配置里就行。
部署完成后，日常用到的命令不多，这里列一份”速查表”，建议收藏一下：
关于更新：OpenClaw 的更新频率挺高的，建议隔一两周更新一次。更新前先备份一下配置，以防万一：
然后执行更新：
如果你想彻底移除 OpenClaw 重新来过，在终端依次执行下面的命令。每条命令复制粘贴后按回车：
执行完后，检查一下是否清理干净：
如果这条命令没有输出任何内容，说明已经彻底清理干净了。
这是最常见的问题，意思是电脑”找不到”你刚装好的 OpenClaw。原因通常是安装路径没有告诉系统。
在终端依次执行下面两条命令：
然后再试试 ，应该就能正常识别了。
这通常是网络问题。Homebrew 的安装源在国外，国内访问可能比较慢。你可以尝试使用国内镜像源安装。在终端执行：
这个脚本会引导你选择镜像源（推荐选中科大或清华源），然后自动完成安装。
在终端执行：
升级完后用 确认版本号是否达到 22 以上。
没坏！这是 Mac 终端的安全设计。当你输入密码时，屏幕上故意不显示任何字符（连星号 都没有），目的是防止旁边的人看到你密码有几位。
直接输入你的 Mac 开机密码，输完按回车就行。即使看不到任何东西，其实已经在输入了。
最常见的原因：
- 用了中文标点：比如中文的冒号 、逗号 、引号 。必须全部使用英文标点
- 字符串没有用英文双引号 包裹
- 最后一个字段后面多了一个逗号
- 在配置文件里面写了中文注释
最简单的排查方法：把配置文件的内容复制到 jsonlint.com 这个网站上，点”Validate JSON”按钮，它会告诉你具体哪一行出了问题。
在终端执行：
这条命令会显示是哪个程序占用了这个端口。找到对应的 PID 号（一串数字），然后执行：
如果这个端口确实被其他程序长期使用，你可以让 OpenClaw 换一个端口：
按以下顺序排查：
- API Key 是否有效：有可能过期了或者余额用完了。去你注册的 AI 模型网站（比如 DeepSeek 的控制台）检查一下
- 运行诊断：在终端执行 ，看看哪里报红
- 查看日志：执行 ，看最后几行有没有包含 的信息
- 网络问题：如果用的是 DeepSeek 等国产模型，国内网络正常就能用。如果用的是 Claude 或 GPT 等海外模型，需要确认你的网络能正常访问对应的 API 服务器
直接点”允许”就好。OpenClaw 需要联网才能调用 AI 模型，这是正常的网络请求。
这是因为 npm 安装时权限不够。如果你之前跳过了”配置 npm 全局路径”那一步，现在回去做一下就能解决。
或者临时解决：在安装命令前面加上 ，比如 ，然后输入你的 Mac 密码。
如果你觉得上面的步骤还是太复杂，有一个更简单的临时方案：在初始化向导中选择 Qwen（通义千问） 作为 AI 模型。它不需要你去注册账号、不需要获取 API Key，只需要用手机扫个码就能直接用了。等你熟悉了 OpenClaw 之后，再切换到 DeepSeek 等其他模型也来得及。
回顾一下，整个安装过程其实就是在终端里复制粘贴命令，核心就四步：
- 装地基：安装 Homebrew 和 Node.js（就像装 App 前先装应用商店）
- 装 OpenClaw：一条命令搞定
- 填密钥：告诉 OpenClaw 用哪个 AI 模型、填上 API Key
- 启动验证：打开浏览器看看能不能和 AI 聊天
整个过程顺利的话二十分钟就能搞定。而且全程使用国内镜像源和国产 AI 模型（比如 DeepSeek），不需要任何特殊网络环境，普通家庭宽带就够了。即使你是第一次用终端，跟着本文的步骤一步步操作，也不会有什么大问题。遇到报错不要慌，往上翻翻常见问题部分，大部分坑都覆盖到了。
OpenClaw 这个项目目前还在非常活跃地迭代，社区也很友好。如果你想要一个灵活、可控、支持多模型多平台的本地 AI 助手，它是目前开源方案里非常值得尝试的一个。
如果大家在 Mac 上部署安装 OpenClaw 的过程中还有哪些没弄明白的地方，或者遇到了文中没提到的问题，欢迎在评论区交流讨论～～～ 我看到都会尽量回复的。特别是零基础的朋友，不要怕问”傻问题”，每个人都是从不会开始的。也欢迎已经部署成功的朋友分享一下你们的使用体验和玩法！
发布者：Ai探索者，转载请注明出处：https://javaforall.net/261468.html原文链接：https://javaforall.net
