跳转到内容
OpenClaw Docs

入门指南

安装 OpenClaw，运行新手引导，并与您的 AI 助手聊天 — 全程大约只需 5 分钟。完成后，您将拥有一个运行中的 Gateway(网关)、已配置的身份验证以及一个可用的聊天会话。

准备工作

Section titled “准备工作”
  • Node.js — 推荐 Node 24（也支持 Node 22.19+）
  • 来自模型提供商的 API 密钥（Anthropic、OpenAI、Google 等）— 新手引导会提示您输入

快速设置

Section titled “快速设置”

  1. 安装 OpenClaw

    Terminal window
    curl -fsSL https://openclaw.ai/install.sh | bash
    Install Script Process

  2. 运行新手引导

    Terminal window
    openclaw onboard --install-daemon

    向导将引导您选择模型提供商、设置 API 密钥以及配置 Gateway(网关)。大约需要 2 分钟。

    完整信息请参阅 新手引导 (CLI)。

  3. 验证 Gateway(网关) 是否正在运行

    Terminal window
    openclaw gateway status

    您应该看到 Gateway(网关) 正在监听 18789 端口。

  4. 打开控制面板

    Terminal window
    openclaw dashboard

    这将在您的浏览器中打开控制 UI。如果加载成功，说明一切正常。

  5. 发送您的第一条消息

    在控制 UI 聊天中输入一条消息，您应该会收到 AI 的回复。

    想改用手机聊天吗？设置最快的渠道是 Telegram（只需一个 bot token）。请参阅 渠道 了解所有选项。

高级：挂载自定义控制 UI 构建

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

Terminal window
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"
    }
  }
}

重启网关并重新打开仪表板：

Terminal window
openclaw gateway restart
openclaw dashboard

接下来做什么

Section titled “接下来做什么”
连接渠道

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

配对与安全

控制谁可以向您的代理发送消息。

配置Gateway(网关)

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

浏览工具

浏览器、执行、网络搜索、技能和插件。
Advanced: 环境变量

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

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

完整参考：环境变量。

相关

Section titled “相关”