跳转到内容

入门(macOS 应用)

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

  1. Approve macOS warning

  2. Approve find local networks

  3. 欢迎与安全提示

    安全信任模型:

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

    Gateway(网关) 网关 在哪里运行?

    • 本机 (仅本地): 新手引导可以配置身份认证并在本地写入凭据。
    • 远程 (通过 SSH/Tailnet): 新手引导 不会 配置本地身份认证; 凭据必须存在于网关主机上。
    • 稍后配置: 跳过设置并将应用保持为未配置状态。
  5. 权限

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

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

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

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

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