openclaw 网盘下载
OpenClaw
Ctrl K

文档

首页 > 文档 > 入门指南

入门指南

目标：以最少的设置，从零开始到完成第一次可用聊天。

最快的聊天方式：打开 Control UI（无需设置渠道）。运行 openclaw dashboard
并在浏览器中聊天，或在
网关主机
上打开 http://127.0.0.1:18789/。
文档：Dashboard 和 Control UI。

前置条件

  • 推荐使用 Node 24（Node 22 LTS，目前为 22.16+，仍因兼容性而受支持）

如果你不确定，请使用 node --version 检查你的 Node 版本。

快速设置（CLI）

bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
curl -fsSL https://openclaw.ai/install.sh | bash

    <img src="https://mintcdn.com/clawdhub/U8jr7qEbUc9OU9YR/assets/install-script.svg?fit=max&auto=format&n=U8jr7qEbUc9OU9YR&q=85&s=50706f81e3210a610262f14facb11f65" alt="安装脚本流程" className="rounded-lg" width="1370" height="581" data-path="assets/install-script.svg" />
  </Tab>

  <Tab title="Windows（PowerShell）">
    ```powershell  theme={"theme":{"light":"min-light","dark":"min-dark"}}
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```
  </Tab>
</Tabs>

<Note>
  其他安装方式和要求： [Install](/install)。
</Note>

bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --install-daemon

新手引导会配置认证、Gateway 网关设置和可选渠道。
详情请参见 [CLI 新手引导](/start/wizard)。

如果你已安装服务，它应该已经在运行：

```bash  theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway status
```

bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw dashboard

如果 Control UI 能加载，你的 Gateway 网关就已准备就绪，可以使用。

可选检查和附加内容

适合快速测试或故障排除。

```bash  theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway --port 18789
```

需要已配置的渠道。

```bash  theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw message send --target +15555550123 --message "Hello from OpenClaw"
```

常用环境变量

如果你将 OpenClaw 作为服务账户运行，或想使用自定义配置/状态位置：

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

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

深入了解

完整的 CLI 新手引导参考和高级选项。

macOS 应用的首次运行流程。

你将获得什么

  • 一个正在运行的 Gateway 网关
  • 已配置好的认证
  • Control UI 访问权限或一个已连接的渠道

后续步骤