Onboarding（macOS 应用）

流程概览

• 欢迎 + 安全提示
• 网关选择（Local / Remote / Configure later）
• 本地认证（Anthropic OAuth）
• 向导（Gateway 驱动）
• 权限（TCC）
• CLI（可选）
• Onboarding chat（独立会话）
• Ready

Local vs Remote

• Local：可在本机进行 OAuth，凭据写入本地
• Remote（SSH/Tailnet）：不在本机执行 OAuth；凭据必须在网关主机
• Configure later：跳过配置
• 网关认证：向导会生成 token，即便 loopback；关闭认证仅适用于完全可信的本机

本地认证（Anthropic OAuth）

• 打开浏览器执行 OAuth（PKCE）
• 用户粘贴 code#state
• 写入 ~/.clawdbot/credentials/oauth.json
• 其他提供方暂用 env/config 方式配置

Setup Wizard（Gateway 驱动）

macOS 应用复用 CLI 向导逻辑，保持一致性。

权限请求

• 通知
• 辅助功能
• 屏幕录制
• 麦克风/语音识别
• 自动化（AppleScript）

Onboarding chat

使用 onboarding 会话，运行 BOOTSTRAP/ SOUL 的仪式性引导，完成首次人格与偏好写入。

可选：Gmail hooks

clawdbot hooks gmail setup --account you@example.com

完成后重启网关以启动 Gmail watcher。

远程模式补充

远程网关的 OAuth 与工作区文件都在远端主机；需要在远端准备 oauth.json 与 auth-profiles.json。