First-Run Flow
新手引导
这页描述 macOS 应用侧的首次运行体验：先决定 Gateway 在哪里跑，再完成认证、权限、CLI 与专用 onboarding chat，把第一次使用从“堆设置”变成一条连续流程。
首次运行顺序
1. 欢迎与安全提示
先让用户知道这是一套能操作真实文件、命令和聊天渠道的系统，而不是纯聊天玩具。
2. 选择 Gateway 位置
本地模式可以直接在当前 Mac 上完成 OAuth 和凭证写入；远程模式只做连接，不会在本地代替远端创建认证状态。
3. 模型认证
当前文档重点描述的是本地 Anthropic OAuth；其他 provider 更常见的路径仍是环境变量或配置文件。
4. 运行设置向导
应用侧可以直接复用 CLI 同款设置向导，避免 UI 和 Gateway 逻辑出现双份分叉。
5. 权限与 CLI
依次处理通知、辅助功能、屏幕录制、麦克风 / 语音识别、自动化等权限，并可选安装全局 CLI。
6. Onboarding Chat
最后进入独立的新手引导会话，让智能体在单独上下文里介绍下一步，而不污染日常对话。
关键注意事项
远程模式不在本地造凭证
如果 Gateway 在另一台机器上，凭证与工作区都在那台机器上。你需要在远程主机上准备 OAuth / auth-profiles 文件。
首次智能体运行会引导工作区
OpenClaw 会初始化 AGENTS.md、BOOTSTRAP.md、IDENTITY.md、USER.md 等文件，并通过一轮问答完成身份设置。