OpenClaw 怎么安装？从零开始的完整部署教程

本文所有命令和配置均来自 OpenClaw 官方文档，不添加未经核实的内容。

安装前的准备

OpenClaw 只有一个硬性依赖：Node.js 22 或更高版本。先确认本机版本：

node --version

输出需要是 v22.x.x 或更高。版本不对的话按下面方式升级。

macOS / Linux 安装 Node.js

推荐用 nvm 管理版本，方便日后切换：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 22
nvm use 22

Windows 安装 Node.js

去 nodejs.org 下载 22.x LTS 安装包，按提示安装即可。官方推荐 Windows 用户通过 WSL2 运行 OpenClaw，兼容性更好。

Linux（Ubuntu / Debian）

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

安装 OpenClaw

方式一：官方一键脚本（推荐）

macOS / Linux：

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

Windows PowerShell：

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

方式二：npm 全局安装（三端通用）

npm install -g openclaw

安装完验证：

openclaw --version

能输出版本号说明安装成功。

准备 API Key

OpenClaw 不内置模型，需要你自己提供 LLM 的访问凭证。支持以下方式：

Claude Pro / Max 订阅用户说明：订阅账户没有 API Key，可以用 setup-token 方式认证。需要先安装 Claude Code CLI，然后运行：

claude setup-token

复制生成的 token，在后续 onboarding 步骤中选择「Anthropic token (paste setup-token)」粘贴即可。

初始化配置

官方推荐加上 --install-daemon 参数，引导完成后会自动安装后台服务，不需要手动保持终端窗口：

openclaw onboard --install-daemon

引导流程会依次配置以下内容：

1. 模型和认证：选择 AI 提供商，输入 API Key 或完成 OAuth 登录
2. 选择默认模型：从检测到的可用模型中选择
3. Gateway 配置：选择本地模式或连接远程 Gateway
4. 健康检查：自动启动 Gateway 并验证运行状态
5. 安装 Skills：可选，安装推荐的扩展能力，也可以跳过

配置完成后，所有设置保存在 ~/.openclaw/openclaw.json。

验证是否正常运行

查看 Gateway 状态：

openclaw gateway status

打开控制面板：

openclaw dashboard

浏览器会打开 http://127.0.0.1:18789，可以在这里直接和 AI 对话，不需要配置任何消息渠道。能收到回复说明部署成功。

接入 Telegram（可选）

接入 Telegram 后可以随时用手机触发任务，是最常见的使用方式。

第一步：创建 Telegram Bot

打开 Telegram，搜索 @BotFather，发送 /newbot，按提示填写 Bot 名称和用户名，最后复制生成的 Bot Token（格式类似 123456789:AAHxxxxxxx）。

第二步：添加 Telegram 渠道

openclaw channels add --channel telegram --token 你的BotToken

或者手动编辑 ~/.openclaw/openclaw.json：

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "你的BotToken",
      dmPolicy: "pairing",
    },
  },
}

配置文件支持热加载，保存后 Gateway 会自动应用，无需重启。

第三步：完成配对

在 Telegram 里找到你的 Bot 发一条消息，Bot 会回复一个配对码。然后在终端里审批：

openclaw pairing list telegram
openclaw pairing approve telegram <配对码>

⚠️ 配对码有效期 1 小时，超时需重新发起。

常见问题排查

先跑这一条，解决大部分问题

openclaw doctor
openclaw doctor --fix

openclaw doctor 能自动检测并修复配置错误、遗留文件、版本兼容问题，遇到任何异常先跑它。

Gateway 没有自动启动

如果 onboarding 时没有加 --install-daemon，可以事后补装后台服务：

openclaw gateway install
openclaw gateway start

Telegram Bot 没有响应

1. 确认 botToken 格式正确，没有多余空格
2. 确认已完成配对流程（openclaw pairing list telegram 查看状态）
3. 运行 openclaw doctor 检查配置是否合法

npm 全局安装报权限错误（macOS / Linux）

不要用 sudo npm install -g，改用 nvm 管理的 npm 不需要 sudo：

nvm install 22
nvm use 22
npm install -g openclaw

安装完成后的下一步

• 安装 Skills：在 ClawHub 浏览社区扩展，给 AI 增加新能力
• 接入更多渠道：WhatsApp、Slack、Discord、Signal、iMessage 等都支持
• 安全审计：运行 openclaw security audit 检查权限配置是否合理
• 查阅完整文档：docs.openclaw.ai

一张表总结整个流程