跳转到主要内容

入门(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): 新手引导 不会 配置本地身份认证; 凭据必须存在于网关主机上。
  • 稍后配置: 跳过设置并将应用保持为未配置状态。
Gateway(网关) 网关身份认证提示:
  • 向导现在即使对于回环也会生成一个 token,因此本地 WS 客户端必须进行身份验证。
  • 如果您禁用身份认证,任何本地进程都可以连接;请仅在完全受信任的计算机上使用此功能。
  • 对于多机器访问或非回环绑定,请使用 token
5

权限

新手引导将请求以下所需的 TCC 权限:
  • 自动化
  • 通知
  • 辅助功能
  • 屏幕录制
  • 麦克风
  • 语音识别
  • 摄像头
  • 位置
6

CLI

此步骤是可选的
应用程序可以通过 npm/pnpm 安装全局 openclaw CLI,以便终端工作流和 launchd 任务能够开箱即用。
7

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

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

本页面源自 openclaw/openclaw,由 BeaversLab 翻译,遵循 MIT 协议 发布。
Last modified on March 27, 2026