一张安装页，把环境检查、命令执行、通道接入完整闭环做完
这里先检查电脑配置，再按 Windows、macOS、Linux 三条路线执行安装。安装完不是结束，后面还会继续把 Telegram 和飞书接入，保证你能真正把 OpenClaw 用起来。
安装前先把电脑条件检查完
先确认 Node、系统环境、工作目录和聊天入口准备好了，再执行安装命令会顺很多。
- • Node 24 推荐
- • Node 22.16+ 兼容
- • 稳定网络环境
- • 终端 / Shell 基础能力
官方安装脚本会检测 Node；如缺失会自动安装推荐版本。
- • macOS
- • Linux
- • Windows via WSL2
- • 本地电脑或 VPS
Windows 官方目前仍优先推荐 WSL2 + Ubuntu 路线。
- • 预留可写工作目录
- • 确认全局 npm PATH
- • 准备 Telegram 或飞书账号
- • 避免把状态目录放到云同步盘
macOS 官方文档明确提醒状态目录避免放在 iCloud 或云同步目录中。
确认 CLI、Gateway、PATH 与基础配置都没有明显异常。
openclaw doctor
openclaw status本地打开 Dashboard，观察服务状态、令牌与通道配置是否正常。
openclaw dashboard如果你希望开机自启，确认 Gateway 已安装为守护服务。
openclaw gateway status先只看你当前正在用的系统，别同时打开三条路线
下面先选一条路线。选中后，环境检测和安装步骤会同步切到同一个系统，普通用户照着当前这一列执行就够了。
先检测当前电脑里有没有必需环境，没有就先补齐
这一步先看系统、Node、npm、curl、WSL2 或 Homebrew 是否可用。缺了哪一项，就先把环境装好，再继续 OpenClaw 安装。
先检查 Windows 主机里有没有 WSL2，再进入 Ubuntu 检查 Node、npm、curl 和 systemd。
- 1. 先执行“检测命令”，确认缺了什么。
- 2. 对照“补齐命令”安装缺失环境。
- 3. 环境准备完毕后，再进入系统安装步骤。
- • Windows 路线优先推荐 WSL2 + Ubuntu；OpenClaw 官方目前仍把它作为更稳的方式。
- • 第三条命令会先自动补 Node 24，再继续 OpenClaw 安装；如果你只想先装 Node，也可以改用 Node 官网安装包。
把下面的命令逐条执行，看哪些环境已经存在，哪些还缺失。
看到默认发行版为 Ubuntu，且版本为 2，就说明 WSL2 已就绪。
wsl --status
wsl --list --verbose如果命令输出了 missing，就代表这个环境还没补齐。
cat /etc/os-release
node -v || echo "node missing"
npm -v || echo "npm missing"
curl --version
systemctl --version推荐路径更省事，手动路径适合想单独先补环境的用户。
最省事的方式：先装 WSL2，再用 OpenClaw 官方脚本自动补 Node 并继续安装。
缺什么补什么，环境补齐后再继续 OpenClaw。
wsl --install缺什么补什么，环境补齐后再继续 OpenClaw。
sudo apt update && sudo apt install -y curl ca-certificates缺什么补什么，环境补齐后再继续 OpenClaw。
curl -fsSL https://openclaw.ai/install.sh | bashWindows 推荐使用 WSL2 运行 OpenClaw，CLI 与 Gateway 都在 Ubuntu 中执行。
- • Windows 10/11 可安装 WSL2
- • 建议 Ubuntu 发行版
- • 在 WSL 中开启 systemd，便于安装 Gateway 服务
- • 官方文档仍把 WSL2 作为首选路线；原生 Windows CLI 正在完善，但兼容性不如 WSL2 稳。
- • 若 PATH 不正确，可用 `npm prefix -g` 检查全局安装位置。
下面这些命令按上到下执行，不要跳步。
wsl --installcurl -fsSL https://openclaw.ai/install.sh | bashopenclaw onboard --install-daemon- $ openclaw doctor
- $ openclaw status
- $ openclaw dashboard
安装完成后，把 Telegram 和飞书真正接进来
这部分不使用任何私人密钥。示例配置仅展示字段结构，真正部署时请把凭证写进本机环境或受控配置文件。
Telegram 接入步骤
适合个人远程控制和 Bot 场景。顺着下面四步做完后，你就能直接在 Telegram 里给 OpenClaw 发任务。
在 Telegram 中找到 `@BotFather`，执行 `/newbot`，按提示完成机器人名称和用户名创建。
在 OpenClaw 配置里启用 `channels.telegram`，写入 `botToken`，默认 `dmPolicy` 可保持为 `pairing`。
执行 `openclaw gateway` 后，用 `openclaw pairing list telegram` 查看配对，再用 `openclaw pairing approve telegram <CODE>` 放行。
如果机器人需要读取群消息，可在 BotFather 用 `/setprivacy` 关闭隐私模式，或把机器人设为群管理员，然后重新拉入群聊。
群聊模式下通常保留 mention 限制，避免在群里被无差别触发。
{
channels: {
telegram: {
enabled: true,
botToken: "123:abc",
dmPolicy: "pairing",
groups: { "*": { requireMention: true } },
},
},
}Feishu 接入步骤
适合团队通知、日报推送和协作场景。把应用开好、事件订阅配好，再完成配对后就能正式使用。
在飞书开放平台创建企业自建应用，记录 App ID（`cli_xxx`）与 App Secret，敏感信息不要写进公开仓库。
在应用能力中启用 Bot，在事件订阅中选择长连接（WebSocket）接收事件，并添加 `im.message.receive_v1`。
OpenClaw 当前版本通常已自带 Feishu 插件，可通过 `openclaw channels add` 或配置文件写入 App ID / Secret。
启动后先给机器人发消息，OpenClaw 默认会返回 pairing code，再用 `openclaw pairing approve feishu <CODE>` 完成授权。
推荐优先使用 WebSocket 长连接收事件，减少公网回调配置复杂度。
{
channels: {
feishu: {
enabled: true,
dmPolicy: "pairing",
accounts: {
main: {
appId: "cli_xxx",
appSecret: "xxx",
botName: "My AI assistant",
},
},
},
},
}安装过程中卡住了？
如果你在环境检查、命令执行、WSL2、Node、Telegram 或飞书配置过程中卡住了，可以直接扫码联系我。
最后把高频问题收口，减少用户卡在安装中段
这里优先覆盖 PATH、WSL2、飞书回调方式等高频问题；更细的报错后续可以继续补充到 FAQ。