跳转至

入门指南

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

你需要什么

  • Node.js 24.16+ 或 26.1+（Node 26 是推荐的运行时）
  • 已有的 Claude Code 或 Codex CLI 登录，或提供商 API 密钥 —— 引导可以直接复用

Tip

使用 node --version 检查你的 Node 版本。 Windows 用户： 原生 Windows Hub 应用是桌面端最便捷的路径。也支持 PowerShell 安装器和 WSL2 Gateway 路径。参见 Windows。 需要安装 Node？参见 Node 安装。

一行命令试用

npx openclaw@latest

全新安装时，在一行指向安全指南的提示后选择快速开始。当已有可用的 AI 访问时，这就是唯一的引导提示：OpenClaw 会找到现有的 Claude Code 或 Codex CLI 登录或 API 密钥，通过一次真实的补全进行验证，保存配置，然后打开 Web 仪表盘。

Gateway 会在此终端中一直运行，直到你按下 Ctrl+C；你的配置会一直保留。如果所有检测到的路径都不可用，引导会打开手动提供商设置。也可以选择自定义设置来逐步查看所有引导选项。

如果之后想让 Gateway 在后台持续运行，请安装下面的 CLI，并运行 openclaw gateway install。运行 openclaw 可打开 TUI，运行 openclaw dashboard 可重新打开 Web UI。

快速设置

1. 安装 OpenClaw

    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
    <img src="https://raw.atomgit.com/GitHub_Trending/cl/openclaw/raw/df97da27f07f6655d5678bdbf1f6f9e460678013/docs/assets/install-script.svg" alt="Install Script Process" class="rounded-lg" />

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

Note

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

2. 完成引导

安装程序会自动启动引导式设置向导。选择快速开始以复用检测到的 AI 访问并打开仪表盘，或选择自定义设置以体验完整的引导流程。提供商登录和可选设置可能需要更长时间。之后可随时运行 openclaw configure 进行额外设置。openclaw onboard --classic 可打开经典的分步向导。

完整参考见引导流程（CLI）。

3. 安装 Gateway 服务

快速开始会让 Gateway 保持在此终端的前台运行。接下来的步骤需要它在后台运行。按 Ctrl+C 停止前台 Gateway，然后安装服务：

openclaw gateway install

这会在 macOS 上安装 LaunchAgent，在 Linux 和 WSL2 上安装 systemd 用户单元，或在原生 Windows 上安装计划任务（如果任务创建被拒绝，则回退到每用户启动文件夹登录项）。在停止和安装的过程中，你的配置会一直保留。

4. 验证 Gateway 正在运行

openclaw gateway status

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

5. 打开仪表盘

openclaw dashboard

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

6. 发送你的第一条消息

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

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

高级：挂载自定义 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

如果设置不生效

一条命令即可将当前安装状态转化为可操作的诊断信息：

openclaw triage

它会运行只读健康检查，生成一份经过脱敏的提示词来描述所发现的问题，然后主动提出将该提示词交给它在你机器上检测到的编码智能体——Claude Code、Codex CLI 或内置的 OpenClaw 智能体——这样智能体启动时就已经载入了诊断信息。如果你更愿意自己执行交接，请选择“仅打印命令”。

在你选择智能体之前，不会有任何数据离开你的机器；密钥、令牌、原始聊天负载和原始日志都会被排除在提示词之外。

如果想自己查看诊断结果，请运行 openclaw doctor。如需按症状优先的排查路径，参见故障排查。

后续步骤

连接渠道

Discord、飞书、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等。

配对与安全

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

配置 Gateway

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

浏览工具

浏览器、执行、网络搜索、技能和插件。

高级：环境变量

如果你以服务账户身份运行 OpenClaw，或想要自定义路径：

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

完整参考：环境变量。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw