跳转到内容
OpenClaw Docs

新手引导 (macOS app)

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

  1. 批准 macOS 警告

  2. Approve find local networks

  3. 欢迎和安全提示

    安全信任模型：

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

  4. 本地与远程

    Gateway(网关) 在哪里运行？

    • 此 Mac（仅本地）： 新手引导可以配置身份验证并在本地写入凭据。
    • 远程（通过 SSH/Tailnet）： 新手引导不会配置本地身份验证；凭据必须存在于网关主机上。远程网关令牌字段存储 macOS 应用用于连接到该 Gateway(网关) 的令牌；现有的非纯文本 gateway.remote.tokenGateway(网关) 值将被保留，直到您替换它们。
    • 稍后配置： 跳过设置并将应用保持为未配置状态。

  5. 权限

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

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

  6. CLICLI

    该应用可以通过 npm、pnpm 或 bun 安装全局 openclawCLInpmnpmGateway(网关) CLI。 它优先选择 npm，其次是 pnpm，最后是 bun（如果检测到的包管理器只有 bun）。对于 Gateway(网关) 运行时，Node 仍然是推荐路径。

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

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

相关

Section titled “相关”