初始化（macOS 应用）

本页介绍 macOS 应用版 OpenClaw 的首次运行引导流程。macOS 应用提供图形化界面，引导你一步步完成安全授权、Gateway（网关）配置和初始对话。

CLI 用户

如果你使用命令行版本，请参阅引导向导（CLI）。

首次启动流程

1. 批准 macOS 安全警告

首次打开 OpenClaw 应用时，macOS 会弹出未验证开发者的警告。

操作步骤：

在弹出的对话框中点击 "取消"
打开 系统设置 → 隐私与安全性
在底部找到 OpenClaw 的提示，点击 "仍要打开"
在确认对话框中输入密码或使用 Touch ID

为什么会有这个警告？

OpenClaw 使用开源签名而非 Apple Developer Program 签名。这不影响安全性，只是 macOS 的 Gatekeeper 机制要求你手动批准。

2. 批准网络发现请求

macOS 会询问是否允许 OpenClaw 查找本地网络设备。

"OpenClaw" 想要查找并连接到你本地网络上的设备。

点击 "允许" — 这是 Gateway（网关）监听本地端口所必需的权限。

3. 欢迎页面与安全须知

应用会显示欢迎页面，其中包含重要的**信任模型（Trust Model）**说明：

安全须知

OpenClaw 是一个拥有系统级操作权限的 AI 助手。在授予权限前，请务必理解：

Agent 可以执行系统命令：包括读写文件、运行脚本、操作剪贴板等
你是最终责任人：Agent 的所有操作都在你的用户权限下执行
审批机制：你可以配置操作审批策略，控制哪些操作需要人工确认

确认你已阅读并理解安全须知后，点击 "继续" 进入下一步。

4. 选择 Gateway（网关）模式

选择 Gateway（网关）的运行位置：

模式	说明	适合场景
Local（本地）	Gateway 运行在本机	个人使用，单设备
Remote（远程）	连接到远程 Gateway	多设备共享，服务器部署

大多数用户选择 Local

如果你只在一台 Mac 上使用 OpenClaw，选择 Local 即可。Remote 模式适合将 Gateway 部署在服务器上，从多台设备连接。

5. 系统权限授权（TCC）

macOS 应用需要一系列系统权限才能发挥全部能力。应用会依次引导你授权以下 TCC（Transparency, Consent, and Control）权限：

权限	用途	是否必需
Automation（自动化）	控制其他应用（如 Finder、Mail、Calendar）	⭐ 强烈推荐
Notifications（通知）	发送系统通知提醒	⭐ 强烈推荐
Accessibility（辅助功能）	模拟键盘和鼠标操作	可选
Screen Recording（屏幕录制）	读取屏幕内容用于视觉理解	可选
Microphone（麦克风）	语音输入	可选
Speech Recognition（语音识别）	语音转文字	可选
Camera（摄像头）	视觉输入	可选
Location（位置）	获取地理位置信息	可选

如何手动管理权限

你可以随时在 macOS 系统设置中管理这些权限：

打开 系统设置 → 隐私与安全性
在左侧列表中选择对应的权限类别
找到 OpenClaw 并切换开关

如果你之前拒绝了某个权限，需要在系统设置中手动开启。

权限提示

每个权限弹窗只会出现一次。如果你不小心点了"不允许"，需要去系统设置中手动开启。建议在引导过程中仔细阅读每个权限的说明后再做决定。

6. CLI 安装选项

应用会询问是否安装命令行工具（CLI）：

Install OpenClaw CLI to /usr/local/bin?

安装 CLI 后，你可以在终端中使用 openclaw 命令。推荐安装，方便终端操作和脚本集成。

7. Onboarding Chat（引导对话）

所有配置完成后，应用会自动打开一个引导对话会话。这是你与 Agent 的第一次对话，Agent 会通过 Bootstrapping 流程认识你：

Agent 会询问你的名字和偏好
你可以定义 Agent 的名称和行为风格
对话内容会被写入身份文件

完成 Onboarding Chat 后，你的 OpenClaw 就正式准备就绪了！

完成后你将获得

✅ 已授权的系统权限
✅ 本地运行的 Gateway（网关）
✅ 已配置的模型认证
✅ 初始化的 Agent 身份
✅ 可选的 CLI 命令行工具

流程总结

启动 macOS 应用
      │
      ▼
  批准安全警告 → 批准网络发现
      │
      ▼
  阅读安全须知 (Trust Model)
      │
      ▼
  选择 Local / Remote Gateway
      │
      ▼
  授权系统权限 (TCC)
  ├─ Automation
  ├─ Notifications
  ├─ Accessibility
  ├─ Screen Recording
  ├─ Microphone
  ├─ Speech Recognition
  ├─ Camera
  └─ Location
      │
      ▼
  安装 CLI (可选)
      │
      ▼
  Onboarding Chat (引导对话)
      │
      ▼
  完成 ✅