OpenClaw 自动安装

概述

OpenClaw Manager 是一个可视化管理工具，帮助你快速安装、配置和管理 OpenClaw 实例。无需手动编辑配置文件，只需 3 步即可完成部署。支持两种消息通道：

	Telegram	飞书（Feishu）
连接方式	Bot API（长轮询）	WebSocket 长连接
需要的凭证	Bot Token + 你的 User ID	App ID + App Secret
平台侧配置	仅创建 Bot	创建应用 + 开启 WebSocket 订阅
用户鉴权	通过 User ID 绑定，仅授权用户可对话	所有能给 Bot 发消息的用户均可对话
适合场景	个人使用、海外用户	团队协作、国内用户

系统环境检查

在开始安装之前，建议先运行环境检查工具，确保你的系统满足 OpenClaw 的运行要求。

下载检查工具

从 GitHub Releases 下载对应平台的检查工具：

平台	文件名
Windows	`openclaw-checker-win-x64.exe`
macOS (Intel)	`openclaw-checker-macos-x64`
macOS (Apple Silicon)	`openclaw-checker-macos-arm64`
Linux	`openclaw-checker-linux-x64`

检查项目

工具会自动检查以下条件：

✅ Node.js 版本（需要 >= 22.12.0）
✅ npm 可用
✅ Git 可用
✅ 网络连通性（github.com、npmjs.org、evolink.ai）

如果检查未通过，工具会给出具体的修复建议。

前置准备

1. 安装 Node.js

OpenClaw Manager 需要 Node.js 22 或更高版本。

Windows
macOS

访问 Node.js 官网,下载 Windows 安装包(.msi 文件),双击运行安装程序。安装完成后,打开 PowerShell 验证:

node --version
npm --version

建议以管理员身份运行 PowerShell,避免后续安装时出现权限问题。

方式 1: 使用安装包访问 Node.js 官网,下载 macOS 安装包(.pkg 文件),双击运行安装程序。方式 2: 使用 Homebrew

brew install node

安装完成后,打开终端验证:

node --version
npm --version

如果后续安装时遇到权限问题,可能需要在命令前加 sudo。

2. 安装 Git

OpenClaw 依赖 Git 进行版本管理和插件安装。

Windows
macOS

访问 Git 官网,下载 Windows 版本安装包,双击运行安装程序,按默认选项完成安装。安装完成后,打开 PowerShell 验证:

git --version

方式 1: 使用 Homebrew(推荐)

brew install git

方式 2: 使用 Xcode Command Line Tools

xcode-select --install

安装完成后,打开终端验证:

git --version

3. 获取 EvoLink API Key

登录 EvoLink 控制台
在控制台中找到 API Keys，点击”创建新Key”按钮，然后复制生成的 Key
API Key 通常以 sk- 开头，请妥善保存

4. 获取通道凭证

Telegram / 飞书凭证获取指引

Telegram
飞书

在 Telegram 中搜索 @BotFather，点击 START BOT 开始对话
发送 /newbot，按提示设置 Bot 名称，获得 Bot Token（格式：123456789:ABCdef...）
获取你的 Telegram User ID：向 @userinfobot 发送 /start，记下返回的数字 ID

前往飞书开放平台，创建一个企业自建应用
在应用的「凭证与基础信息」页面获取 App ID 和 App Secret
在「权限管理」页面，点击 批量导入，粘贴以下 JSON 一键导入所需权限：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:contact.base:readonly",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

在「应用能力 > 机器人」页面，开启机器人能力并配置机器人名称

到此为止，飞书应用的基础配置已完成。接下来的事件订阅和版本发布需要在网关部署完成后再操作，否则长连接设置将保存失败。请先完成下方第一步和第二步的部署，再回到飞书开放平台继续配置。

第一步：下载并运行

从 Releases 下载对应平台的可执行文件：

平台	文件名
Windows	`openclaw-manager-win-x64.exe`
macOS (Intel)	`openclaw-manager-macos-x64`
macOS (Apple Silicon)	`openclaw-manager-macos-arm64`
Linux	`openclaw-manager-linux-x64`

运行前请确保已安装 Node.js 22+。

Windows 用户右键以管理员身份运行。macOS / Linux 用户在终端中使用 sudo 执行：

chmod +x ./openclaw-manager && sudo ./openclaw-manager

脚本会自动检查并安装 OpenClaw，然后启动本地 Web 管理界面并打开浏览器。

第二步：创建实例

2.1 — 基本信息

字段	说明
Instance Name	实例名称（如 `mybot`），同一台机器上不可重复
Model	选择模型：Haiku 4.5 / Sonnet 4.5 / Opus 4.5 / Opus 4.6
Channel	选择通道：Telegram 或 Feishu

2.2 — 填写凭证并部署

所有通道都需要填写 EvoLink API Key。

Telegram
飞书

填写从 @BotFather 获取的 Bot Token，点击 Deploy。脚本会自动完成：

创建 OpenClaw 配置文件
写入模型和 API Key 配置
配置 Telegram 插件并启用
安装并启动网关服务

等待进度条完成后自动进入下一步。

2.3 — 连接

Telegram
飞书

填写你的 Telegram User ID（从 @userinfobot 获取的数字 ID），点击 Connect。脚本会将该 ID 写入配置的 allowedUsers，只有该用户可以与 Bot 对话。连接完成后自动跳转到主页。

部署已完成，现在回到飞书开放平台配置事件订阅。

在配置事件订阅前，请确保已完成以下步骤：

已完成飞书渠道配置（见第二步部署）
网关处于启动状态（可通过 openclaw gateway status 检查）

在 事件订阅 页面：

选择 使用长连接接收事件（WebSocket 模式）
添加事件：im.message.receive_v1（接收消息）

如果网关未启动或渠道未添加，长连接设置将保存失败。

在「版本管理与发布」页面创建版本，提交审核并发布

飞书应用需要管理员审批发布后才能正常使用。企业自建应用通常自动通过审批。

确认后点击 Done，脚本会重启网关以加载飞书 WebSocket 连接。跳转到主页后即可在飞书中给 Bot 发消息。

管理实例

部署完成后，主页会显示所有实例：

状态	说明
🟢 绿点	网关运行中
🔴 红点	网关已停止

每个实例卡片会显示使用的模型和通道，可用操作：

Start / Stop：启动或停止网关服务
Delete：删除实例（停止网关并清理所有配置文件）

点击 + New Instance 可创建多个实例，每个实例独立运行在不同端口上。

​概述

​系统环境检查

​下载检查工具

​检查项目

​前置准备

​1. 安装 Node.js

​2. 安装 Git

​3. 获取 EvoLink API Key

​4. 获取通道凭证

​第一步：下载并运行

​第二步：创建实例

​2.1 — 基本信息

​2.2 — 填写凭证并部署

​2.3 — 连接

​管理实例

概述

系统环境检查

下载检查工具

检查项目

前置准备

1. 安装 Node.js

2. 安装 Git

3. 获取 EvoLink API Key

4. 获取通道凭证

第一步：下载并运行

第二步：创建实例

2.1 — 基本信息

2.2 — 填写凭证并部署

2.3 — 连接

管理实例