入门指南

几分钟内安装好 OpenClaw 并开始第一次聊天。

安装 OpenClaw，运行新手引导，并在大约 5 分钟内与你的 AI 助手聊天。完成后，你将拥有一个正在运行的 Gateway 网关、已配置的身份验证，以及一个可用的聊天会话。

所需条件

使用 node --version 检查 Node 版本。 **Windows 用户：**原生 Windows Hub 应用是最便捷的桌面端方案。也支持 PowerShell 安装程序和 WSL2 Gateway 网关方案。请参阅 Windows。需要安装 Node？请参阅 Node 设置。

安装 OpenClaw

macOS / Linux

    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
    <img

src="/official-assets/openclaw/docs/assets/install-script.svg" alt="安装脚本流程" class="rounded-lg" />

Windows (PowerShell)

iwr -useb https://openclaw.ai/install.ps1 | iex

其他安装方式（Docker、Nix、npm）：安装。

运行新手引导

openclaw onboard --install-daemon

向导将引导你选择模型提供商、设置 API key 并配置 Gateway 网关。快速开始通常只需几分钟，但提供商登录、渠道配对、守护进程安装、网络下载、Skills 或可选插件可能会延长完整新手引导所需的时间。你可以跳过可选步骤，稍后使用 openclaw configure 返回继续配置。

完整参考请参阅新手引导（CLI）。

验证 Gateway 网关正在运行

openclaw gateway status

你应该会看到 Gateway 网关正在监听端口 18789。

打开仪表板

openclaw dashboard

这会在浏览器中打开 Control UI。如果页面可以加载，则表示一切运行正常。

发送第一条消息

在 Control UI 聊天中输入一条消息，你应该会收到 AI 回复。

想改用手机聊天？设置最快的渠道是 Telegram（只需一个机器人令牌）。所有选项请参阅渠道。

高级：挂载自定义 Control UI 构建

如果你维护本地化或自定义的仪表板构建，请将 gateway.controlUi.root 指向包含已构建静态资源和 index.html 的目录。

mkdir -p "$HOME/.openclaw/control-ui-custom"
# 将已构建的静态文件复制到该目录中。

然后设置：

{
  "gateway": {
    "controlUi": {
      "enabled": true,
      "root": "$HOME/.openclaw/control-ui-custom"
    }
  }
}

重启 Gateway 网关并重新打开仪表板：

openclaw gateway restart
openclaw dashboard

连接渠道：Discord、Feishu、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等。
配对和安全：控制谁可以向你的智能体发送消息。
配置 Gateway 网关：模型、工具、沙箱和高级设置。
浏览工具：浏览器、Exec、Web 搜索、Skills 和插件。

高级：环境变量

如果你以服务账户运行 OpenClaw，或希望使用自定义路径：

完整参考：环境变量。