番外：Mac 真机实测 OpenClaw 安装

副标题：OpenClaw 安装日记：两次翻车与 13 项对账

导读：给打算装 OpenClaw 的你三句话——生产环境 Node 选 24；引导检测超时别慌，转手动配置三个字段，验证照样 2.6 秒级通过；装完必跑 openclaw doctor。依据是我们把 01 篇五步在干净 Mac 上重走一遍：两次翻车、一场虚惊，13 项对账（10 过 / 1 未成立 / 1 降级 / 1 情报），日记体实录，所有输出摘自实验日志。

机型说明：实测为 MacBook Pro（M1 Pro），步骤不挑机型——同为 macOS + Homebrew 工具链的新 Mac mini，直接照着装就行。

一、开局：教程写完，我们自己装了一遍

9 月 21 日 · 中午开工

30 秒回顾（01 篇五步）：①确认 Node 版本（22.14+ 起步）→ ②一条命令安装与引导 → ③装成常驻系统服务 → ④验证并跑通第一次对话 → ⑤选好模型提供商。没读过 01 篇也能跟上本文，但建议先看一眼那篇再回来——这篇就是对它的对账。

前两天刚写完《给AI安个家：OpenClaw 2.0 装出你的 7×24 管家》，教读者五步把管家安进自己机器。文章发了，一个念头却越想越不对劲：我们自己并没有完整装过一遍。教程写完不装，等于菜谱写完不试菜——读者照着做翻了车，锅是作者的。

于是 9 月 21 日中午，我们找了一台干净的 Mac——就是眼下写着这篇日记的这台——从零走了一遍 01 篇主路径。实验设计很简单：对照基准就是 01 篇正文 3.1-3.4 节加官方文档 v2026.9.4 口径，教程里每一条可验证的声明都记一笔"实测是否一致"，最后汇总成对账表。安装路线选 install.sh 官方脚本（跳过 npx 试用——脚本内部本来就走 npm，不必重复）。环境如实交代：macOS 27.2（arm64），Node v26.8.1（Homebrew 渠道——两个月前给这台 Mac 配 Claude Code 时 brew 装下的，OpenClaw 官方文档在 macOS 上推荐的恰是这条路），npm 11.19.0，实验前未安装过 OpenClaw。这台机器还有个额外的用处——它是 Node 26，正好检验 01 篇"26 亦可运行"这个口径到底是文档措辞还是真跑得动。

版本口径（先说清，全文适用）：本机当日由官方 install.sh 实际安装的版本是 v2026.9.5；01 篇教程与知识库的锚点是 v2026.9.4；OpenClaw 2.0 的基线是 v2026.8.1。三者不混用——文中出现的差异，先看版本再看结论。

这篇和 01 篇的关系一句话说清：01 篇讲该装成什么样，这篇记实际装出来什么样。01 篇里可验证的声明十二项，加上一条文档没来得及写的现场情报，合起来就是标题里说的 13 项对账。

对账 1｜我们上次说：干净环境按五步走就能安家。实测是：五步框架成立，但第 2 步的引导环节与第 5 步的提供商选择里各埋着一次意外——下面挨个说。

二、顺利的开局与第一次翻车

9 月 21 日 · 12:30 前后

安装走官方脚本，三步全绿，输出比教程写的还干净：

$ curl -fsSL https://openclaw.ai/install.sh | bash
✓ Detected: macos / Install method: npm
[1/3] ✓ Node.js v26.8.1 found
[2/3] Installing OpenClaw v2026.9.5 · bin link at /opt/homebrew/bin/openclaw
[3/3] 🦞 OpenClaw installed successfully (2026.9.5)!

顺带一证：install.sh 正确识别并复用了 Homebrew 的这份 Node（安装器输出 Active Node.js: v26.8.1 (/opt/homebrew/bin/node)），bin 链接也落在 brew prefix 下、无 PATH 冲突——Mac 走 brew 路线基本不踩 01 篇坑 2，PATH 问题主要是 npm 自管理 Node 路线的场景。

顺利到这里为止。引导流程走到 AI 检测环节，卡住 30 秒——日志时间 12:30:13。翻车：

Setup inference detection timed out after 30000ms; returning partial detection
# 判定：未在此机器上检测到现有 AI 访问方式

01 篇 3.2 节写过：引导会自动找到已有的 Claude Code 或 Codex CLI 登录直接复用——而这台机器上，Claude Code 是登录着的，~/.codex 里还躺着 6 个 Codex skills。检测却说"什么都没找到"。

事后跑 openclaw doctor（内置体检命令，第四节细说），doctor 清清楚楚看得见这些 Codex 资产，还给出了迁移建议——检测环节看不见、体检环节看得见，说明东西在，是检测没摸到。我们的判断从严表述：本机复现了检测 30 秒超时，疑似 v2026.9.5 的检测问题，也不排除本机网络或权限因素——单机单次，不定性。

有一说一，翻车之后的兜底行为倒是和教程写的一致：检测未检出后，引导自动落进了提供商选择的手动配置流程，正是 01 篇说的"检测不到任何 AI 访问时，引导会自动进入手动提供商配置"。

对账 2｜我们上次说：引导会自动找到已有 AI 访问，复用登录（01 篇 3.2，转述 v2026.9.4 文档口径）。实测是：本机超时未检出。未检出时直接走手动配置，同样简单——下一节就是手动配置救场实录。

侧栏·彩蛋（不抢主线，顺手记录）：①引导界面是中文的，01 篇没提，9.5 现状；②开场的免责声明是一个完整安全面板，比教程写的"一行提示"更醒目——教程写保守了；③9.5 新增"你想创建什么？小型团队：参谋长+专家"选项，实选后真的创建了 5 个 agent（main/coordinator/researcher/writer/reviewer，各有独立 workspace），03-05 篇有大用；④每条命令带随机幽默 tagline，比如"Half butler, half debugger, full crustacean"——半管家半调试器，全甲壳类，跟本系列的管家隐喻不谋而合。

三、第二次翻车与绕路成功

9 月 21 日 · 12:30 过后

3.1 第二次翻车与 Node 口径

顺着手动配置往下走：在提供商列表里选 More… → Z.AI → Coding-Plan-CN，翻第二辆车——安装 @openclaw/zai-provider 插件时，npm view 子进程直接原生崩溃，不是报错，是崩溃：

node::PlatformInit ... Assertion failed: (err)==(0)
# 堆栈指向 node/26.8.1 的 libnode

这个崩溃把 01 篇的一个口径撞松了。在本机 Homebrew 渠道的 Node 26.8.1 + npm 11.19 环境下（崩溃堆栈指向 Homebrew Cellar 打包的 libnode；npm registry 已确认是官方源，可排除镜像站因素），主安装流程全程正常（见第二节的三步全绿），但 Z.AI 路线的这个子流程崩到不可用。

对账 3｜我们上次说：Node 26 亦可运行（01 篇 3.1 并集口径）。实测是：能装、能跑基本功能，个别子流程有崩溃场景。修订表述：生产环境稳妥起见推荐 Node 24，26 可用于尝鲜——想验证是否渠道因素，可换 nodejs.org 官方安装包的 Node 复现；想稳妥的读者，装之前 node -v 看一眼。

3.2 绕路成功与虚惊一场

Z.AI 走不通，换 Custom Provider——任意 OpenAI 兼容端点，手动填三个字段。key 哪来？我们这份从商汤日日新平台（sensenova.cn）注册领取——实测时（2026 年 9 月）它家的 Token Plan 处于公测期，deepseek-v4-flash 在免费额度里；现在是否仍免费，以平台当期政策为准。向导里实际填的东西，整理成字段级示意（key 与端点 ID 已脱敏）：

{
  "baseUrl": "https://token.sensenova.cn/v1",
  "model": "deepseek-v4-flash",
  "apiKey": "******（粘贴时输入，不回显）"
}

（向导会自动生成端点 ID，形如 custom-token-***-cn。）

保存前，OpenClaw 用一次真实调用验证这个组合——2.6 秒后：

✓ Inference verified / AI 检查：在 2.6 秒内回复
# 日志：agent model: custom-token-***-cn/deepseek-v4-flash

第二行值得多看一眼：默认模型落成了 custom-token-***-cn/deepseek-v4-flash——正是 01 篇讲的 provider/model 格式，自定义端点也严格守约。

虚惊出现在启动后：日志里 SECRETS_DEGRADED 警告刷了 10 条，覆盖全部 5 个 agent——custom provider 粘贴的 key 生成的 secret 引用没被全部找到，官方给的重试建议是 openclaw secrets reload。看着吓人，但我们决定先不处理，直接去 Control UI 发了第一句话——回复秒到。结论：这类启动时序的 secret 警告属于噪音级，功能通就是通，警告单放后面处理不迟（secret 怎么规范管理，留到 07 篇讲信任边界时细说）。

对账 4｜我们上次说：引导在保存前用一次真实调用验证模型（01 篇 2.1）。实测是：2.6 秒验证通过，"验证后才保存"逐字兑现——这条是 01 篇最经得起实测的声明之一。

四、常驻、基线与 doctor 大体检

9 月 21 日 · 12:44

首答已通，接着 openclaw gateway install 把 OpenClaw 装成常驻服务：输出确认 LaunchAgent 落在 ~/Library/LaunchAgents/ai.openclaw.gateway.plist，日志在 ~/Library/Logs/openclaw/——01 篇说 macOS 上这一步装 LaunchAgent，实锤，连重复执行的幂等提示（已加载则建议 --force 重装）都想好了。然后跑 openclaw gateway status：

Service: LaunchAgent (loaded)
Gateway: bind=loopback (127.0.0.1), port=18789
Dashboard: http://127.0.0.1:18789/
Runtime: running (pid *****, state active)
Connectivity probe: ok
Capability: connected-no-operator-scope
Listening: 127.0.0.1:18789

对着 01 篇的预期输出注释看：监听 18789 ✓、Runtime: running ✓、Connectivity probe: ok ✓——三要素逐字命中。这不是巧合：教程里那行注释抄的是官方文档的健康基线，而实测与官方基线完全一致。顺带一提输出里的 Capability: connected-no-operator-scope——这是 command owner（命令所有者）未设置的体现——未设置时网关只连不控，属于"能连上、还没接线"的状态，02 篇接通渠道后自然解决，不是故障。

对账 5｜我们上次说：gateway status 预期输出为官方健康基线三项（01 篇 3.4）。实测是：逐字一致，零偏差。

最后跑了 openclaw doctor 做大体检，15+ 个分类面板，丰富度超教程预期。几个现场发现顺手记录：四个专家 agent（coordinator 到 reviewer）名下各 34 个 allowed skills 因缺对应二进制不可用，doctor 给了 --fix 批量禁用的选项；zsh 补全也可以在 doctor 的交互选项里一并装上。体检翻出三个值得单独说的问题——明文 secret 警告（第 07 篇）、Memory 双坑（第 03 篇）、Codex 资产迁移路径（第 02 篇）——本文不展开，各自留到对应正编篇里细说。

五、结论：13 项对账与给读者的清单

9 月 21 日 · 收工

把全程对照 01 篇的声明逐项清点，共 13 项对账（12 项声明验证 + 1 项文档未及的现场情报）：

#	01 篇说	实测
1	install.sh 安装流程	✅ 一致
2	安全提示 → Quick start	✅ 更醒目的免责面板
3	自动检测复用已有 AI 访问	❌ 本机超时未检出
4	Node 26 亦可运行	⚠️ 主流程可跑（Homebrew 渠道实测），个别子流程崩溃
5	真实调用验证后保存	✅ 2.6 秒验证
6	provider/model 格式	✅ 自定义端点也守约
7	前台运行、需手动 gateway install	✅
8	macOS 装 LaunchAgent	✅ plist 实锤
9	健康基线三项	✅ 逐字一致
10	浏览器自动开仪表盘+首答	✅
11	默认只绑本机回环	✅ status/doctor 双印证
12	doctor 输出配置问题清单	✅ 丰富度超预期
13	（文档未及）中文引导界面	🆕 9.5 现场情报

（第 13 项为现场情报记录，不计入声明验证——对账口径再咬合一次。）

10 项通过，1 项未成立，1 项降级，1 项新情报。一处未成立、一处降级，这两处的勘误已经落地：01 篇公众号文章的置顶留言、CSDN 版 3.1/3.2 节末的实测注记，读者两处都能看到修订说明。有人会问：教程如实转述了 v2026.9.4 的文档口径，凭什么要勘误？我们的想法是：文档口径是文档的事，读者拿着教程在今天装机，撞上的就是 9.5 的现场——把实测差异补在读者看得见的地方，比论证"当时没写错"有用得多。

给照着教程装的读者五条命令级建议：

1. 检测超时别慌：卡满 30 秒报"未检测到"时，直接选手动配置或 Custom Provider，三个字段（端点/模型/key）填完照样 2.6 秒级验证；错过引导也不怕，openclaw configure 随时回来补
2. Node 选 24：生产环境稳妥起见推荐 24；26 能装能跑基本功能，留给尝鲜，装前 node -v 看一眼
3. Custom Provider 最小字段：引导内 More… → Custom Provider，一个 OpenAI 兼容端点 URL + 模型名 + key，三个字段就够跑通第一次对话
4. 装完必跑 openclaw doctor：重点看 Security 与 Memory 两块面板，明文 secret 和记忆配置问题它会直接点名
5. SECRETS 类警告先看功能：启动时序的降级警告不等于故障，先发一句话试试，通了就可以先不管

实验边界声明：本篇全部结论来自单机（Mac / Node 26.8.1 为 Homebrew 渠道安装 / npm registry 为官方源 / v2026.9.5 当日版本）单次实验，不构成普遍结论；检测超时与子进程崩溃的归因保持"疑似"，欢迎在不同环境复现或证伪。

中午开工，12:44 网关装成常驻服务，体检完收工，前后一顿午饭的工夫。安装、首次对话、常驻、体检都过了，还差一件：消息渠道没接。顺带一记：写这篇日记用的 Claude Code，正是两个月前那次 brew 安装留下的；今天 OpenClaw 又装进了同一套 brew + Node 工具链，同一套环境跑了两个工具。下一篇正编（02 篇）就打通渠道，让飞书和钉钉的消息直达 OpenClaw。

---

免责声明

本文内容仅供学习交流，所述方法需结合实际场景灵活运用。 AI 工具输出结果仅供参考，关键业务决策请结合人工判断。

本文由 AI 辅助创作，经人工审核编辑后发布。