本文档描述当前<\/strong>的首次运行新手引导流程。目标是流畅的”第 0 天”体验：选择 Gateway 网关运行位置、连接认证、运行向导，然后让智能体自行引导。<\/p>\n 阅读显示的安全提示并相应决定。<\/p>\n Gateway 网关<\/strong>在哪里运行？<\/p>\n Gateway 网关认证提示：<\/p>\n macOS 应用支持 Anthropic OAuth（Claude Pro\/Max）。流程：<\/p>\n 其他提供商（OpenAI、自定义 API）目前通过环境变量或配置文件配置。<\/p>\n 应用可以运行与 CLI 相同的设置向导。这使新手引导与 Gateway 网关端行为保持同步，避免在 SwiftUI 中重复逻辑。<\/p>\n 新手引导请求以下所需的 TCC 权限：<\/p>\n 应用可以通过 npm\/pnpm 安装全局 设置完成后，应用会打开一个专用的新手引导聊天会话，让智能体可以自我介绍并指导后续步骤。这使首次运行指导与你的正常对话分开。<\/p>\n 在首次智能体运行时，OpenClaw 会引导一个工作区（默认 Gmail Pub\/Sub 设置目前是手动步骤。使用：<\/p>\n页面顺序（当前）<\/h2>\n
\n
1) 欢迎 + 安全提示<\/h2>\n
2) 本地 vs 远程<\/h2>\n
\n
\n
3) 仅限本地的认证（Anthropic OAuth）<\/h2>\n
\n
code#state<\/code> 值<\/li>\n~\/.openclaw\/credentials\/oauth.json<\/code><\/li>\n<\/ul>\n4) 设置向导（Gateway 网关驱动）<\/h2>\n
5) 权限<\/h2>\n
\n
6) CLI（可选）<\/h2>\n
openclaw<\/code> CLI，以便终端工作流和 launchd 任务开箱即用。<\/p>\n7) 新手引导聊天（专用会话）<\/h2>\n
智能体引导仪式<\/h2>\n
~\/.openclaw\/workspace<\/code>）：<\/p>\n\n
AGENTS.md<\/code>、BOOTSTRAP.md<\/code>、IDENTITY.md<\/code>、USER.md<\/code><\/li>\nIDENTITY.md<\/code>、USER.md<\/code>、SOUL.md<\/code><\/li>\nBOOTSTRAP.md<\/code>，使其只运行一次<\/li>\n<\/ul>\n可选：Gmail 钩子（手动）<\/h2>\n