用途
本技能用于在 macOS(尤其是 Mac mini)上搭建或审查私有 OpenClaw 主机、选择其服务生命周期方式,或诊断主机可靠性问题。文档定位为操作指导,明确不授权安装工具、更改账户权限、暴露端口或连接消息账户。
前置条件
需选择经过审查、不可变更的 OpenClaw 发行版,并查阅其官方前置条件与安装方法。当前上游入门文档列出 Node.js 24.16+ 或 26.1+,应核对所选发行版,而不是沿用历史上的 Node 18 指引。上线前需确定主机与用户、获批的提供商凭据、存储、备份、支出上限,以及允许的工具与渠道范围。
使用方式
先盘点现有安装,在变更前保留配置与数据。仅在获授权时下载外部源码或安装器,固定经审查的版本或提交,在临时目录中检查完整目录树与生命周期钩子,再取得激活或安装授权;不得将未经审查的网络安装器直接管道进 shell。使用该发行版文档中的安装器或包工作流,不要假设应用具备 db:migrate、dist/server.js、Redis、3000 端口或 /api/health 等接口。
通过受支持的引导界面、在预期的非管理员用户下完成配置。凭据应保存在受支持的密钥机制中并限制文件权限,不要覆盖已有 .env,也不要把密钥写入命令行参数。云端模型仍会将提示词传出主机,仅本地托管并不等于隐私保证。
在获批安装持久化后,使用受支持的 Gateway 服务。官方 macOS 路径采用每用户 LaunchAgent,而非此前展示的通用 root LaunchDaemon,需记录登录、解锁、重启方面的限制。
openclaw --version
openclaw gateway status
openclaw gateway install
openclaw dashboard
应从允许与拒绝的客户端两侧验证实际监听地址与认证。文档默认 Gateway 端口为 18789,但应检查配置而非假设。私有绑定、要求认证或配对,并将远程访问限制在预期身份;VPN 只是额外的传输与访问控制,不构成对智能体工具的授权。
仅在成本与数据获授权后,用合成提示词测试提供商访问,并验证工具权限、取消、日志与恢复流程。记录确切版本与观察结果;仪表盘 HTTP 成功并不等于智能体可用或原生会话重载成功。
主机可靠性
使用主机与运维检查。保留 FileVault 与屏幕锁定;FileVault 在重启后可能需要交互式解锁,应在声称无人值守可用前用用户的恢复方案进行测试。任何电源设置都应记录原值与恢复路径;不要默认创建管理员服务账户、禁用屏幕安全或开放大范围防火墙访问。
使用 Docker 时,仅采用所选发行版实际支持的 Compose 文件:固定镜像、将获批端口绑定到回环地址、明确保留卷与备份,并验证 macOS 容器运行时在预期用户会话中启动。若无明确需求,不要添加可选的 Redis 或 Ollama 服务;macOS 上的 Linux 容器不意味着原生 Apple GPU 加速。不要将删除卷作为常规排障手段。
示例
对于注销后停止的主机,记录 CLI 版本、Gateway 状态、服务所有者与登录状态,并对照所选发行版的服务文档;应恢复受支持的每用户服务,而不是新增第二个 root 管理进程。确认只有一个进程占用配置端口,并在获批的维护窗口内测试重启。
限制
本文档未实际执行任何 CLI、宿主安装或提供商请求。硬件规格取决于工作负载与所选本地模型。该目录仅含指导内容,不包含安装器或生产 Compose 模板。渠道配对、远程访问、持久化与付费模型请求均需针对具体目标获得明确授权。