入门指南

目标：从零开始设置并运行第一个聊天，使用最少的配置。

Fastest chat: open the Control UI (no channel setup needed). Run __CODE_BLOCK_0__ and chat in the browser, or open __CODE_BLOCK_1__ on the gateway host. Docs: [Dashboard](/web/dashboard) and [Control UI](/web/control-ui).

前提条件

Node 22 或更高版本

Check your Node version with __CODE_BLOCK_2__ if you are unsure.

快速设置 (CLI)

__CODE_BLOCK_3__ __CODE_BLOCK_4__ Other install methods and requirements: [Install](/install). __CODE_BLOCK_5__ The wizard configures auth, gateway settings, and optional channels. See [Onboarding Wizard](/start/wizard) for details. If you installed the service, it should already be running: __CODE_BLOCK_6__ __CODE_BLOCK_7__ If the Control UI loads, your Gateway is ready for use.

可选检查和额外功能

Useful for quick tests or troubleshooting. __CODE_BLOCK_8__ Requires a configured channel. __CODE_BLOCK_9__

有用的环境变量

如果您以服务账户身份运行 OpenClaw 或希望自定义配置/状态文件的位置：

OPENCLAW_HOME 设置用于内部路径解析的主目录。
OPENCLAW_STATE_DIR 覆盖状态目录。
OPENCLAW_CONFIG_PATH 覆盖配置文件路径。

完整的环境变量参考：环境变量。

深入了解

Full CLI wizard reference and advanced options. First run flow for the macOS app.

您将拥有

正在运行的网关
配置好的认证
控制界面访问或连接的频道

下一步

直接消息安全性和批准：配对
连接更多频道：频道
高级工作流和从源代码设置：设置