入门指南 - OpenClaw

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

你需要准备

使用 node --version 检查你的 Node 版本。 Windows 用户： 支持原生 Windows 和 WSL2。WSL2 更稳定，推荐用于完整体验。参见 Windows。需要安装 Node？参见 Node 设置。

安装 OpenClaw

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

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

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

运行新手引导

openclaw onboard --install-daemon

向导会引导你选择模型提供商、设置 API key，并配置 Gateway 网关。大约需要 2 分钟。完整参考见新手引导（CLI）。

验证 Gateway 网关正在运行

openclaw gateway status

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

打开仪表板

openclaw dashboard

这会在你的浏览器中打开 Control UI。如果它能加载，说明一切正常。

发送你的第一条消息

在 Control UI 聊天中输入一条消息，你应该会收到 AI 回复。想改用手机聊天？最快可设置的渠道是 Telegram（只需要一个 bot token）。所有选项见渠道。

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

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

mkdir -p "$HOME/.openclaw/control-ui-custom"
# Copy your built static files into that directory.

然后设置：

{
  "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 等。

控制谁可以给你的智能体发消息。

模型、工具、沙箱和高级设置。

浏览器、exec、Web 搜索、skills 和插件。

高级：环境变量

如果你将 OpenClaw 作为服务账号运行，或想使用自定义路径：

完整参考：环境变量。