OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

第一步

入门指南

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

你需要准备

  • Node.js 22.19+、23.11+ 或 24+（推荐默认使用 24）
  • 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 网关。快速开始通常只需几分钟，但提供商登录、渠道配对、守护进程安装、网络下载、Skills 或可选插件可能会使完整的新手引导耗时更长。你可以跳过可选步骤，稍后使用 openclaw configure 返回配置。

    完整参考请参阅新手引导（CLI）。

  • 验证 Gateway 网关正在运行

    bash
    openclaw gateway status

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

  • 打开仪表板

    bash
    openclaw dashboard

    这会在浏览器中打开 Control UI。如果能够加载，则表示一切运行正常。

  • 发送第一条消息

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

    想改用手机聊天？设置最快的渠道是 Telegram（只需一个 Bot 令牌）。所有选项请参阅渠道。

    • 高级：挂载自定义 Control UI 构建版本

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

    bash
    mkdir -p "$HOME/.openclaw/control-ui-custom"# 将构建好的静态文件复制到该目录中。

    然后设置：

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

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

    bash
    openclaw gateway restartopenclaw dashboard

    后续操作

    连接渠道

    Discord、Feishu、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等。
    配对与安全

    控制谁可以向你的智能体发送消息。
    配置 Gateway 网关

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

    浏览器、Exec、Web 搜索、Skills 和插件。
    高级：环境变量

    如果你使用服务账号运行 OpenClaw，或希望使用自定义路径：

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

    完整参考：环境变量。

    相关内容

    Was this useful?
    On this page

    On this page