Mac 本地部署
在 Mac 本地完成 Homebrew、部署命令、配置向导和界面访问验证，确认 Agent 可以正常启动。
按步骤走，最快 15 分钟跑起来。
工具专项 · 安装配置
OpenClaw 会连接模型、消息渠道和工具；安装成功之外，还要验证权限、日志和停止方式。
只回复“测试链路已收到”并附当前时间；不要调用外部工具，不要读取文件，也不要保存长期记忆。
完整文章包含当前安装命令、风险边界、故障排查和逐项验收。
Step 1
OpenClaw 不只是聊天窗口，它会连接模型、渠道和工具，权限边界比普通对话更重要。
安装前先确定第一个低风险用途、允许访问的目录、模型费用上限和消息触发范围。不要一开始就接主账号、整个硬盘或公开群。
Step 2
安装器会检测系统、处理需要的 Node 版本并启动 onboarding；Homebrew 不是前置条件。
curl -fsSL https://openclaw.ai/install.sh | bashopenclaw --version
openclaw doctor
openclaw gateway statusStep 3
先跑通模型，再接一个测试渠道；每一步独立验收。
选择一个已有的 Provider，设置用量或预算提醒；用不含隐私的固定问题测试返回和费用记录。
只允许访问独立测试目录，不要把主目录或云盘根目录作为第一块工作区。
优先使用测试群或测试账号，默认只响应明确触发，不接受任何成员随意调用。
Step 4
界面能连接只是开始，必须跑通消息、模型、回复和日志四段链路。
http://127.0.0.1:18789/Step 5
openclaw onboard --install-daemon 或 openclaw gateway install 安装 macOS LaunchAgent。启用前先完成最小链路和停止演练。理解机制
分层理解后，排错就不会一出问题就重装。
Dashboard 是管理界面；Gateway 是接收事件、调用模型与工具、发送回复的后台进程；模型 Provider 则负责生成。网页能打开，只能证明管理界面可访问，不能证明消息链路完整。
例如：Dashboard 正常但消息不回复时，先看 openclaw gateway status 和日志是否收到事件，再测模型调用；不要直接删除配置重装。
127.0.0.1 改成对公网开放的监听地址，只为了手机能访问。管理面板和 Gateway 不应在没有认证、网络限制与安全评估时直接暴露公网。第一单验收
把原“第一单”教程合并到安装流程，避免安装完又重复走一遍相同步骤。
确认Gateway状态正常，并记录停止命令。
只允许测试账号或测试群明确触发。
只返回固定文本与时间，不调用文件或外部工具。
找到同一请求，确认模型、耗时、错误和凭证脱敏。
资料 · 时效核验