夜雨聆风OpenClaw Mac 安装部署完全指南
你有没有想过，你的 Mac 可以变成一个不睡觉的私人助手？
不是 Siri 那种——你说一句它答一句的「语音播报机」。而是一个真正能动手做事的 AI Agent：帮你读文件、写代码、查资料、发消息、操控浏览器……就像给你的电脑装了一个永远在线的隐形员工。
这就是 OpenClaw。
今天这篇文章，手把手教你在 Mac 上把它装起来。不需要你是程序员，只要你会复制粘贴命令，5 分钟就能搞定。
先说说 OpenClaw 是什么
你可以把 OpenClaw 想象成一个「AI 管家框架」——
ChatGPT、Claude 这些大模型很能聊，但它们只能在浏览器对话框里待着。而 OpenClaw 做的事情，是给这些聪明的大脑接上手脚，让它们能直接在你的电脑上干活。
几个关键特点：
●本地运行： 数据不上传云端，隐私有保障
●随时找它： 通过 Telegram、微信、飞书、WhatsApp 都能和它对话
●啥都能干： 读文件、写代码、跑脚本、上网查东西、管日程……
●24/7 待命： 注册成系统服务后，开机就自动运行
●完全免费： 开源项目，代码全部公开
它的核心是一个叫 Pi 的极简编码 Agent——只带了 4 个基础工具（读、写、编辑、执行命令），但通过扩展系统，几乎没有它做不了的事。
开始之前，你需要准备什么
别紧张，清单很短：
●一台 Mac： M 系列芯片（M1/M2/M3/M4）最佳，Intel Mac 也完全可以
●稳定的网络： 安装过程需要下载一些依赖包
●一个 AI 模型的 API Key： 这是你给 Agent「接大脑」用的，国内外都有不错的选择
国内模型（访问稳定，中文表现好）：
●通义千问 Qwen（阿里云，dashscope.aliyuncs.com 申请 API Key，有免费额度）
●深度求索 DeepSeek（api.deepseek.com，性价比极高，推理能力强）
●智谱 GLM-4（open.bigmodel.cn，清华系出品，中文理解优秀）
●百度文心一言 ERNIE（cloud.baidu.com，百度千帆平台）
●月之暗面 Kimi（platform.moonshot.cn，长上下文能力突出）
海外模型（需要科学上网）：
●Anthropic Claude（Agent 场景下表现最好）
●OpenAI GPT
●Google Gemini
什么是 API Key？简单说，就是一个「通行证」。你去 AI 服务商的网站注册一个开发者账号，就能拿到。国内平台注册简单，一般新用户都有免费额度可以先体验。
第一步：安装 Homebrew（Mac 的软件管家）
Homebrew 是 Mac 上的「应用商店命令行版」——很多开发工具都通过它来安装。如果你之前折腾过 Mac，很可能已经有了。
打开你的「终端」应用（在启动台搜索「终端」或「Terminal」），复制粘贴这行命令，按回车：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"你会看到什么： 终端会输出一大堆文字，中间可能会让你输入开机密码（输入时屏幕上不会显示字符，这是正常的）。整个过程大约 1～3 分钟。
如果你的 Mac 是 Apple Silicon（M 系列芯片），安装完还需要执行下面两行，告诉系统去哪里找 Homebrew：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofileeval "$(/opt/homebrew/bin/brew shellenv)"验证一下有没有装好：
brew --version预期结果： 看到类似 Homebrew 4.x.x 的版本号，就说明成功了。
踩坑提示：如果提示 command not found: brew，大概率是 PATH 没配好。重新执行上面那两行 echo 和 eval 命令，然后重新打开一个终端窗口再试。
第二步：安装 Node.js（OpenClaw 的运行环境）
OpenClaw 是用 Node.js 写的，所以需要先装一下它的运行环境。你不需要了解 Node.js 是什么，把它想象成「OpenClaw 需要的燃料」就行。
brew install node你会看到什么： 终端会开始下载和安装，大约 30 秒到 1 分钟。
验证一下：
node --version预期结果： 显示 v22.x 或更高的版本号就 OK。
小知识：OpenClaw 推荐 Node.js 22 LTS 或 24 版本。通过 Homebrew 安装的默认就是最新稳定版，不用额外操心。
第三步：安装 OpenClaw（重头戏来了）
万事俱备，现在安装主角。官方提供了一键安装脚本，复制粘贴就完事：
curl -fsSL https://openclaw.ai/install.sh | bash你会看到什么： 脚本会自动检测你的系统环境，下载并安装 OpenClaw CLI 工具，最后启动一个引导向导。整个过程大约 1～2 分钟。
如果你更习惯手动安装（或者上面的脚本有问题），也可以用 npm：
npm install -g openclaw@latest踩坑提示：macOS 上安装偶尔会遇到 sharp 模块编译错误（一个图像处理库）。如果碰到了，换这个命令：
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest加了一个环境变量让它跳过本地编译，问题就解决了。
第四步：初始化配置（给 Agent 接上大脑）
这一步是整个过程最有意思的部分——你要给你的 AI Agent 做「入职培训」了。
openclaw onboard --install-daemon--install-daemon 这个参数会把 OpenClaw 注册成系统服务，以后开机就自动运行，不用每次手动启动。
你会看到什么： 一个交互式的引导向导，会一步一步问你几个问题——
1.选择模式： 选 QuickStart 就好（新手推荐，一路默认即可）
2.配置 AI 模型： 选你的 AI 提供商（比如 Anthropic），然后粘贴你的 API Key
3.连接消息渠道（可选）： 想用飞书聊天就选飞书，后面会教你怎么连
4.安装技能（可选）： 比如浏览器控制、天气查询等，可以先跳过，以后随时加
5.启动 Gateway 服务： 向导结束时会自动帮你启动
跟着向导走就行，每一步都有提示，不会迷路。
第五步：验证安装（检查一切是否就绪）
最后来做个「体检」，确保一切正常运行：
openclaw doctor预期结果： 全部显示绿色通过。如果有报错，doctor 命令会告诉你哪里出了问题以及怎么修复。
再看看 Gateway 服务的状态：
openclaw gateway status预期结果： 显示 running 或 active，表示服务正在运行。
最后，打开控制面板感受一下：
openclaw dashboard你会看到什么： 浏览器会自动打开 http://127.0.0.1:18789/，这是 OpenClaw 的 Web 控制面板。你可以直接在这里和你的 AI Agent 对话——试试跟它打个招呼吧！
加分项：连接飞书，随时随地找你的 Agent
装好 OpenClaw 之后，最爽的用法之一就是通过飞书和它聊天——走在路上、躺在沙发上，随时给 Agent 派活。
设置方法如下：
1.登录飞书开放平台（open.feishu.cn），创建一个「企业自建应用」
2.在「凭证与基础信息」页面获取 App ID 和 App Secret
3.开启「机器人」能力，配置消息回调地址（指向你的 OpenClaw 服务）
4.在 OpenClaw 配置文件中添加飞书渠道，填入 App ID、App Secret 和 Verification Token
5.重启 Gateway 服务，然后在飞书里搜索你的应用机器人，发消息试试
搞定！现在去飞书找你刚创建的机器人聊聊天吧，背后回答你的就是你自己的 AI Agent。
除了飞书，OpenClaw 还支持 Telegram、WhatsApp、Discord、微信等渠道。可以在引导向导中选择，也可以后续在配置文件里添加。
常用命令速查表
装好之后，这几个命令会是你的常客：
进阶玩法
给 Agent 一个「专属工位」
OpenClaw 运行时权限比较高（毕竟它要帮你读写文件、执行命令），如果你比较在意安全隔离，可以给它创建一个专门的 macOS 用户：
1.打开「系统设置」→「用户与群组」→「添加用户」
2.取名 openclaw-agent，设为管理员
3.切换到这个账户，重新走一遍安装流程
这样 Agent 的所有操作都在独立账户下进行，不会碰到你的个人文件。
放到服务器上，24/7 永不下线
Mac 会休眠，但服务器不会。如果你手头有一台 Linux 服务器（VPS、AWS EC2、甚至一台树莓派），可以把 OpenClaw 部署上去：
curl -fsSL https://openclaw.ai/install.sh | bashopenclaw onboard --install-daemon命令跟 Mac 上一模一样。部署在服务器上的好处是 Agent 真正做到全天候在线，配合 Telegram 等消息渠道，走到哪都能用。
常见问题
Q：安装过程中报权限错误怎么办？
A：试试在命令前面加 sudo，比如 sudo npm install -g openclaw@latest，然后输入你的开机密码。
Q：我的 API Key 用完了怎么办？
A：去对应服务商的控制台充值或申请更多额度。日常使用的话，Claude API 大约每月几美元就够了。
Q：Mac 合盖休眠后 Agent 会断吗？
A：会的。如果需要 24/7 在线，建议部署到服务器上（见上面的进阶玩法），或者在系统设置中关闭休眠。
Q：可以同时连多个消息渠道吗？
A：当然可以！Telegram、飞书、WhatsApp 可以同时连接，Agent 会统一响应。
Q：数据安全吗？会不会被上传？
A：OpenClaw 完全本地运行，你的文件和对话数据只存在于你自己的机器上。唯一的网络请求是发给 AI 模型的对话内容（就像你在 ChatGPT 网页版聊天一样）。
总结：三条命令，拥有一个私人 AI Agent
回顾一下，整个安装过程核心就三步：
brew install nodecurl -fsSL https://openclaw.ai/install.sh | bashopenclaw onboard --install-daemon从今天开始，你的 Mac 不只是一台电脑——它是一个会思考、会行动的 AI 工作站。
下一步可以做什么
装好只是开始，真正好玩的在后面：
●探索技能市场： 访问 clawhub.com，给你的 Agent 装上更多技能
●连接更多渠道： 把飞书、微信也接上，打造全平台 AI 助手
●自定义 Agent 人设： 通过 SOUL.md 文件定义 Agent 的性格和说话方式（没错，你可以让它变得很有趣）
●关注我们： 后续会分享更多 OpenClaw 的玩法和使用技巧
相关链接
●官方文档：docs.openclaw.ai
●GitHub 源码：github.com/openclaw/openclaw
●社区 Discord：discord.com/invite/clawd
●技能市场：clawhub.com
如果这篇文章帮到了你，欢迎转发给同样对 AI 感兴趣的朋友！