快速入门

安装 OpenClaw、运行 onboarding，然后和你的 AI 助手对话——全程大约 5 分钟。完成后你将拥有一个运行中的 Gateway、已配置的认证，以及一个可用的对话会话。

前置要求

• Node.js — 推荐 Node 24（也支持 Node 22.14+）
• 模型提供商的 API Key（Anthropic、OpenAI、Google 等）— onboarding 会引导你填写

用 node --version 检查你的 Node 版本。

Windows 用户： 原生 Windows 和 WSL2 均支持。WSL2 更稳定，推荐体验完整功能。参见 Windows 安装指南。 需要安装 Node？参见 Node 安装说明。

快速安装步骤

第一步：安装 OpenClaw

macOS / Linux：

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

Windows（PowerShell）：

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

其他安装方式（Docker、Nix、npm）：参见 安装文档。

第二步：运行 onboarding

openclaw onboard --install-daemon

引导向导会带你选择模型提供商、设置 API Key 并配置 Gateway，大约需要 2 分钟。

完整参考文档：Onboarding（CLI）

第三步：验证 Gateway 是否运行

openclaw gateway status

你应该能看到 Gateway 正在监听 18789 端口——这说明你的"龙虾"已经活了。

第四步：打开仪表盘

openclaw dashboard

这会在浏览器中打开 Control UI。如果加载成功，说明一切正常。

第五步：发送第一条消息

在 Control UI 的对话框中输入一条消息，你应该能收到 AI 回复。

想从手机发消息？最快的频道是 Telegram（只需一个 bot token）。查看 所有频道选项。

下一步做什么

• 连接频道 — WhatsApp、Telegram、Discord、iMessage 等
• 配对与安全 — 控制谁能给你的智能体发消息
• 配置 Gateway — 模型、工具、沙箱等高级设置
• 浏览工具 — 浏览器控制、命令执行、网络搜索、技能插件

高级：环境变量

如果你以服务账户运行 OpenClaw 或需要自定义路径：

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

完整参考：环境变量