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

​
你需要准备

  • Node.js 22.19+、23.11+ 或 24+（24 是推荐默认版本）
  • 一个 API key，来自模型提供商（Anthropic、OpenAI、Google 等）——新手引导会提示你输入
使用 node --version 检查你的 Node 版本。 **Windows 用户：**原生 Windows Hub 应用是最简单的桌面路径。也支持 PowerShell 安装器和 WSL2 Gateway 网关路径。参见 Windows。 需要安装 Node？参见 Node 设置。

​
快速设置

1

安装 OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash
安装脚本流程
其他安装方法（Docker、Nix、npm）：安装。
2

运行新手引导

openclaw onboard --install-daemon
向导会引导你选择模型提供商、设置 API key，并配置 Gateway 网关。QuickStart 通常只需几分钟，但提供商登录、渠道配对、守护进程安装、网络下载、Skills 或可选插件可能会让完整新手引导耗时更久。跳过可选步骤，之后可使用 openclaw configure 返回继续配置。完整参考见 新手引导（CLI）。
3

验证 Gateway 网关正在运行

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

打开仪表盘

openclaw dashboard
这会在浏览器中打开 Control UI。如果页面加载成功，则一切正常。
5

发送你的第一条消息

在 Control UI 聊天中输入一条消息，你应该会收到 AI 回复。想改用手机聊天？最快能完成设置的渠道是 Telegram（只需要一个 Bot token）。查看 渠道 了解所有选项。
如果你维护本地化或自定义的仪表盘构建，请将 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 等。

配对与安全

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

配置 Gateway 网关

Models、工具、沙箱和高级设置。

浏览工具

浏览器、exec、Web 搜索、技能和插件。
如果你以服务账号运行 OpenClaw，或想使用自定义路径：
  • OPENCLAW_HOME — 用于内部路径解析的主目录
  • OPENCLAW_STATE_DIR — 覆盖状态目录
  • OPENCLAW_CONFIG_PATH — 覆盖配置文件路径
完整参考：环境变量。

​
相关内容