第一步

入门指南

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

你需要准备

  • Node.js — 推荐 Node 24(也支持 Node 22.16+)
  • 来自模型提供商的 API key(Anthropic、OpenAI、Google 等)— 新手引导会提示你输入

快速设置

  • 安装 OpenClaw

    macOS / Linux

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

    安装脚本流程

    Windows (PowerShell)

    powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
  • 运行新手引导

    bash
    openclaw onboard --install-daemon

    向导会引导你选择模型提供商、设置 API key, 并配置 Gateway 网关。大约需要 2 分钟。

    完整参考见 新手引导(CLI)

  • 验证 Gateway 网关正在运行

    bash
    openclaw gateway status

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

  • 打开仪表板

    bash
    openclaw dashboard

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

  • 发送你的第一条消息

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

    想改用手机聊天?最快可设置的渠道是 Telegram(只需要一个 bot token)。所有选项见 渠道

  • 高级:挂载自定义 Control UI 构建

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

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

    然后设置:

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

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

    bash
    openclaw gateway restartopenclaw dashboard

    下一步

    高级:环境变量

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

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

    完整参考:环境变量

    相关内容

    Was this useful?