跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

本文档描述了当前首次运行设置流程。目标是提供顺畅的“第 0 天”体验：选择 Gateway 网关运行位置、连接凭证、运行向导，并让智能体完成自举。 有关新手引导路径的总体概览，请参阅新手引导概览。
1

批准 macOS 警告

2

批准查找本地网络

3

欢迎和安全提示

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

本地与远程

Gateway 网关在哪里运行？
  • 这台 Mac（仅本地）： 新手引导可以在本地配置凭证并写入凭证。
  • 远程（通过 SSH/Tailnet）： 新手引导不会配置本地凭证；凭证必须已存在于 Gateway 网关主机上。
  • 稍后配置： 跳过设置，并让应用保持未配置状态。
Gateway 网关凭证提示：
  • 向导现在即使对 loopback 也会生成一个 token，因此本地 WS 客户端必须进行身份验证。
  • 如果你禁用凭证，任何本地进程都可以连接；仅在完全受信任的机器上这样做。
  • 对多机器访问或非 loopback 绑定使用 token。
5

权限

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

CLI

此步骤为可选
应用可以通过 npm、pnpm 或 bun 安装全局 openclaw CLI。 它会优先使用 npm，然后是 pnpm；只有在检测到 bun 是唯一的 包管理器时才会使用 bun。对于 Gateway 网关运行时，Node 仍然是推荐路径。
7

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

设置完成后，应用会打开一个专用的新手引导聊天会话，让智能体可以 介绍自己并指导后续步骤。这会将首次运行指导与你的常规对话分开。 有关首次智能体运行期间 Gateway 网关主机上发生的事情，请参阅自举。

​
相关