跳转到主要内容
macOS 应用的首次运行流程：选择 Gateway 网关运行位置，连接一个 已验证的 AI 后端，授予权限，并交接给智能体自己的 引导流程。 如需了解 CLI 新手引导以及两种路径的对比，请参阅新手引导概览。
1

批准 macOS 警告

2

批准查找本地网络

3

欢迎和安全提示

安全信任模型：
  • 默认情况下，OpenClaw 是个人智能体：一个受信任的操作员边界。
  • 共享/多用户设置需要锁定：拆分信任边界，保持工具访问最小化，并遵循安全。
  • 本地新手引导会将新配置默认设置为 tools.profile: "coding"，因此全新设置会保留文件系统/运行时工具，而不会使用不受限制的 full 配置文件。
  • 如果启用了 hooks/webhooks 或其他不受信任的内容源，请使用强大的现代模型层级，并保持严格的工具策略/沙箱隔离。
4

本地 vs 远程

Gateway 网关在哪里运行？
  • 这台 Mac（仅本地）： 新手引导会在本地配置凭证并写入凭据。
  • 远程（通过 SSH/Tailnet）： 新手引导不会配置本地凭证； 凭据必须已存在于网关主机上。远程网关令牌 字段会存储 macOS 应用用于连接该 Gateway 网关的令牌； 现有的 gateway.remote.token SecretRef 值会被保留，直到你 替换它们。
  • 稍后配置： 跳过设置并让应用保持未配置状态。
Gateway 网关凭证提示：
  • Gateway 网关凭证模式默认是 token，即使是 loopback 绑定也是如此，因此本地 WS 客户端必须进行身份验证。
  • 设置 gateway.auth.mode: "none" 会允许任何本地进程连接；仅在完全受信任的机器上使用。
  • 对于多机器访问或非 loopback 绑定，请使用令牌。
5

CLI

本地设置会通过 npm、pnpm 或 bun 安装全局 openclaw CLI， 优先使用 npm。Node 仍然是 Gateway 网关 本身的推荐运行时。会复用现有的兼容安装。
6

连接你的 AI

Gateway 网关就绪后，新手引导会查找你已有的 AI 访问方式： Claude Code、Codex 或 Gemini CLI 登录，或 OPENAI_API_KEY / ANTHROPIC_API_KEY。最佳选项会通过真实补全进行测试，并且 只有在它成功应答后才会保存；当测试失败时，应用会自动尝试 下一个选项，并显示上一个选项失败的原因。如果找到多个选项， 你可以在继续之前切换它们。如果未找到任何选项（或没有任何选项可用），手动密钥/令牌选择器会加载 Gateway 网关的当前文本推理提供商插件，而不是使用固定的应用 列表。所选提供商会提供其入门模型和配置；OpenClaw 会在存储其凭证配置文件之前，使用同样的实时测试验证凭据。下一步 会保持锁定，直到有一个后端通过测试，因此第一次智能体聊天无法 在推理不可用时开始。Crestodian 聊天仍可从此 页面使用（之后也可在设置 → Crestodian 下使用），以便用自然语言获得帮助。稍后配置会跳过此步骤。
7

权限

新手引导会请求以下 TCC 权限：自动化（AppleScript）、通知、辅助功能、屏幕录制、麦克风、语音识别、摄像头和位置。
8

新手引导聊天（专用会话）

设置完成后，应用会打开一个单独的智能体新手引导聊天，让智能体可以 介绍自己并引导后续步骤，而不会把这次交流混入 正常对话历史。这会接在 Crestodian 设置对话之后； 它不会替代该对话。请参阅引导启动，了解 智能体第一次真实轮次期间网关主机上会发生什么。

​
相关