入门指南

​

入门指南

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

​

所需条件

• Node.js — 推荐 Node 24（也支持 Node 22.14+）
• 来自模型提供商（API、Anthropic、Google 等）的 OpenAI 密钥 — 新手引导将会提示您

使用 node --version 检查您的 Node 版本。Windows 用户： 原生 Windows 和 WSL2 均 受支持。WSL2 更稳定，推荐用于完整体验。请参阅 Windows。需要安装 Node？请参阅 Node 设置。

​

快速设置

1. 安装 OpenClaw

   macOS / Linux

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

   

   Windows (PowerShell)

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

   其他安装方法（Docker、Nix、npm）：安装。

2. 运行新手引导

   openclaw onboard --install-daemon
   

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

   请参阅 新手引导 (CLI) 获取完整参考。

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

   openclaw gateway status
   

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

4. 打开仪表板

   openclaw dashboard
   

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

5. Send your first message

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

   想改用手机聊天吗？设置最快的渠道是 Telegram（只需一个 bot 令牌）。查看 Channels 了解所有选项。

​

What to do next

Connect a 渠道

WhatsApp、Telegram、Discord、iMessage 等。

Pairing and safety

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

Configure the Gateway(网关)

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

Browse tools

浏览器、执行、网络搜索、技能和插件。

Advanced: 环境变量

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

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

完整参考：Environment variables。

---

本页面源自 openclaw/openclaw，由 BeaversLab 翻译，遵循 MIT 协议 发布。