本文是一份从零开始的 macOS 本地安装指南,包含:
- 安装 OpenClaw CLI
- 编写配置文件
- 启动 Gateway(前台 / 后台)
- 访问控制台
- 接入 Telegram(可选)
- 授权 macOS 系统能力(可选)
- Node.js 22+(仅 CLI + Gateway 即可)
- macOS 终端(Terminal)
- 如果需要 macOS 系统能力(系统命令/屏幕/相机/通知),需安装 OpenClaw.app(菜单栏应用)
Node.js 官方下载:https://nodejs.org/(建议 LTS 版本)
如果你已经把 npm 的全局目录改成了用户可写路径,可去掉 :
验证安装:
提示:不要用 sudo 启动 OpenClaw。否则配置会写到 ,并且无法正常使用 macOS 权限。
先设置两个环境变量:
OpenClaw 默认读取:
下面这份是当前推荐的 接法:
要点:
- + 是 OpenClaw 官方支持的自定义 provider 结构。
- 不需要额外添加 ;保持 provider 配置最小即可。
- 会优先走 HTTP ;如果你想 WebSocket-first,可改成 。
- 这里把 设为 ,避免局部 或内置目录合并造成的覆盖歧义。
- OpenClaw 内置 OAuth 是直连 OpenAI 的路线,不会经过 XAI Router。
- 与 都建议通过环境变量注入。
先做一次最小验证:
启动后访问控制台:
如果配置了 ,控制台会要求输入 token。
如果你希望开机后自动运行:
常用维护命令:
日志位置:
如果你安装了 OpenClaw.app 并使用 Local 模式,Gateway 由 App 管理,不建议再手动 install。
最简方式(CLI 写配置):
或者直接写到配置文件:
首次私聊会生成配对码,需要批准:
要使用 、屏幕录制、相机、通知等能力,需要安装 OpenClaw.app 并完成授权:
- 安装并启动 OpenClaw.app(菜单栏)
- 按提示授予权限(通知、辅助功能、屏幕录制、麦克风、语音识别、自动化/AppleScript)
- 在 App 中配置 Exec approvals
Exec approvals 文件位置:
推荐使用 allowlist(只放开必要命令):
如果你明确知道风险并希望完全放开,可将 设为 , 设为 。
完全放开示例(高风险):
- CLI + Gateway:即可在本机跑通 OpenClaw
- OpenClaw.app:赋予系统能力 + 更完整的 macOS 控制
- Gateway install:让它后台常驻、开机自启
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/213895.html