官方教程12 分钟初级
入职流程
本文档描述当前的首次运行入职流程。目标是实现平滑的「第 0 天」体验：选择网关运行位置、连接身份验证、运行向导，并让智能体自行引导。
页面顺序（当前）
欢迎 + 安全提示
网关选择
身份验证（Anthropic OAuth）
设置向导
权限
CLI（可选）
入职聊天
准备就绪
1本地 vs 远程
网关运行在哪里？
- 本地（这台 Mac）
入职流程可以运行 OAuth 流程并在本地写入凭据。
- 远程（通过 SSH/Tailnet）
入职流程不会在本地运行 OAuth；凭据必须存在于网关主机上。
- 稍后配置
跳过设置并将应用程序保持未配置状态。
网关身份验证提示
- 向导现在即使对于回环也会生成令牌，因此本地 WS 客户端必须进行身份验证。
- 如果你禁用身份验证，任何本地进程都可以连接；请仅在完全受信任的机器上使用。
- 对于多机器访问或非回环绑定，使用令牌。
2本地专用身份验证（Anthropic OAuth）
macOS 应用支持 Anthropic OAuth（Claude Pro/Max）。流程如下：
- 1打开浏览器进行 OAuth（PKCE）
- 2要求用户粘贴 code#state 值
- 3将凭据写入 ~/.openclaw/credentials/oauth.json
其他提供商（OpenAI、自定义 API）目前通过环境变量或配置文件进行配置。
3设置向导（网关驱动）
应用可以运行与 CLI 相同的设置向导。这使入职流程与网关端行为保持同步，并避免在 SwiftUI 中重复逻辑。
4权限
入职流程请求所需的 TCC 权限：
- 通知
- 辅助功能
- 屏幕录制
- 麦克风 / 语音识别
- 自动化（AppleScript）
5CLI（可选）
应用可以通过 npm/pnpm 安装全局 openclaw CLI，以便终端工作流和 launchd 任务开箱即用。
6入职聊天（专用会话）
设置完成后，应用会打开一个专用的入职聊天会话，以便智能体可以介绍自己并指导后续步骤。这将首次运行指导与正常对话分开。
7准备就绪
🎉 恭喜！你已经完成了 OpenClaw 的入职流程。现在可以开始使用你的个人 AI 助手了。
智能体引导仪式
在首次智能体运行时，OpenClaw 会引导一个工作区（默认 ~/.openclaw/workspace）：
- 播种 AGENTS.md、BOOTSTRAP.md、IDENTITY.md、USER.md
- 运行简短的问答仪式（一次一个问题）
- 将身份 + 偏好写入 IDENTITY.md、USER.md、SOUL.md
- 完成后删除 BOOTSTRAP.md，使其只运行一次
可选：Gmail 钩子（手动）
Gmail Pub/Sub 设置目前是一个手动步骤。使用：
openclaw webhooks gmail setup --account you@gmail.com详见 /automation/gmail-pubsub
远程模式说明
当网关在另一台机器上运行时，凭据和工作区文件位于该主机上。如果需要在远程模式下使用 OAuth，请创建：
~/.openclaw/credentials/oauth.json~/.openclaw/agents/<agentId>/agent/auth-profiles.json在网关主机上。
下一步
现在你已经完成了入职流程，探索更多 OpenClaw 功能和配置选项。