ClawCN - OpenClaw 中文版

主题

引导流程 (macOS 应用) ​

本文档描述当前的首次运行引导流程。目标是提供流畅的"第 0 天"体验：选择 Gateway 运行位置、连接身份验证、运行向导,并让代理自我引导启动。

页面顺序(当前) ​

  1. 欢迎 + 安全提示
  2. Gateway 选择(本地 / 远程 / 稍后配置)
  3. 身份验证(Anthropic OAuth) — 仅限本地
  4. 设置向导(Gateway 驱动)
  5. 权限(TCC 提示)
  6. CLI(可选)
  7. 引导对话(专用会话)
  8. 就绪

1) 欢迎 + 安全提示 ​

阅读显示的安全提示并据此决定。

2) 本地 vs 远程 ​

Gateway 在哪里运行?

  • 本地(此 Mac): 引导流程可以运行 OAuth 流程并在本地写入凭据。
  • 远程(通过 SSH/Tailnet): 引导流程不在本地运行 OAuth;凭据必须存在于 Gateway 主机上。
  • 稍后配置: 跳过设置,保持应用未配置状态。

Gateway 身份验证提示:

  • 向导现在即使对于环回也会生成令牌,因此本地 WS 客户端必须进行身份验证。
  • 如果禁用身份验证,任何本地进程都可以连接;仅在完全受信任的机器上使用。
  • 对于多机器访问或非环回绑定,请使用令牌。

3) 仅限本地的身份验证(Anthropic OAuth) ​

macOS 应用支持 Anthropic OAuth(Claude Pro/Max)。流程如下:

  • 打开浏览器进行 OAuth(PKCE)
  • 要求用户粘贴 code#state 值
  • 将凭据写入 ~/.openclaw/credentials/oauth.json

其他提供商(OpenAI、自定义 API)目前通过环境变量或配置文件进行配置。

4) 设置向导(Gateway 驱动) ​

应用可以运行与 CLI 相同的设置向导。这使引导流程与 Gateway 端行为保持同步,避免在 SwiftUI 中重复逻辑。

5) 权限 ​

引导流程请求所需的 TCC 权限:

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

6) CLI(可选) ​

应用可以通过 npm/pnpm 安装全局 openclaw CLI,使终端工作流和 launchd 任务开箱即用。

7) 引导对话(专用会话) ​

设置完成后,应用打开一个专用的引导对话会话,以便代理可以介绍自己并指导后续步骤。这使首次运行指导与正常对话分开。

代理引导仪式 ​

在首次代理运行时,OpenClaw 引导一个工作空间(默认为 ~/.openclaw/workspace):

  • 植入 AGENTS.md、BOOTSTRAP.md、IDENTITY.md、USER.md
  • 运行简短的问答仪式(一次一个问题)
  • 将身份 + 偏好写入 IDENTITY.md、USER.md、SOUL.md
  • 完成后删除 BOOTSTRAP.md,使其仅运行一次

可选: Gmail 钩子(手动) ​

Gmail Pub/Sub 设置目前是手动步骤。使用:

bash
openclaw webhooks gmail setup --account you@gmail.com

详见 /automation/gmail-pubsub。

远程模式说明 ​

当 Gateway 在另一台机器上运行时,凭据和工作空间文件位于该主机上。如果在远程模式下需要 OAuth,请创建:

  • ~/.openclaw/credentials/oauth.json
  • ~/.openclaw/agents/<agentId>/agent/auth-profiles.json

在 Gateway 主机上。