跳转到内容
OpenClaw Docs

新手引导 (macOS app)

本文档描述了当前的首次运行设置流程。目标是提供流畅的“第 0 天”体验：选择 Gateway(网关) 的运行位置，连接身份验证，运行向导，然后让代理自行引导。 有关新手引导路径的总体概述，请参阅 新手引导 Overview。

  1. 批准 macOS 警告

  2. Approve find local networks

  3. 欢迎与安全提示

    安全信任模型：

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

  4. 本地与远程

    Gateway(网关) 在哪里运行？

    • 此 Mac (仅本地)： 新手引导可以配置身份验证并在本地写入凭据。
    • 远程 (通过 SSH/Tailnet)： 新手引导不会配置本地身份验证；凭据必须存在于 gateway 主机上。
    • 稍后配置： 跳过设置并保持应用未配置状态。

  5. 权限

    新手引导将请求以下所需的 TCC 权限：

    • 自动化
    • 通知
    • 辅助功能
    • 屏幕录制
    • 麦克风
    • 语音识别
    • 摄像头
    • 位置

  6. CLI

    该应用程序可以通过 npm、pnpm 或 bun 安装全局 openclaw CLI。 它优先选择 npm，然后是 pnpm，如果 bun 是唯一检测到的包管理器，则选择 bun。对于 Gateway(网关) 运行时，Node 仍然是推荐的路径。

  7. 新手引导聊天 (专用会话)

    设置完成后，应用会打开一个专用的新手引导聊天会话，以便代理可以自我介绍并指导后续步骤。这使首次运行指导与您的正常对话保持分开。有关第一次运行代理期间在 gateway 主机上发生的情况，请参阅 Bootstrapping。

相关

Section titled “相关”