一、环境准备

1. 服务器要求

• 系统：CentOS Stream 10
• 配置：建议 2核4G 以上
• 网络条件：可访问公网（用于对接飞书 API、下载依赖与模型服务）

2. 防火墙设置与 SELinux 关闭

# 停止并禁用防火墙
systemctl stop firewalld
systemctl disable firewalld

# 临时关闭SELinux
setenforce 0
# 永久关闭SELinux
sed -i 's/SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config

二、依赖工具安装

1. 安装 nvm（Node 版本管理）

# 下载并安装NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
# 重新加载环境变量
source ~/.bashrc

2. 安装node.js

# 安装Node.js 22版本
nvm install 22
# 切换使用该版本
nvm use 22

3. 版本验证

node --version  # 预期输出：v22.x.x
npm --version

4. 安装 pnpm

npm install -g pnpm

5. 安装 wget、zip 和 unzip

yum install wget zip unzip -y

三、安装 OpenClaw v2026.4.5

1. 安装指定版本源码压缩包

wget https://github.com/openclaw/openclaw/archive/refs/tags/v2026.4.5.zip

# 解压
unzip v2026.4.5.zip

2. 安装依赖、编译、注册命令

cd openclaw-2026.4.5/
pnpm install
pnpm build
npm install -g .

3. 运行配置向导

openclaw onboard

4. 基础配置（QuickStart 模式）

1.安装模式选择：QuickStart

2.模型 / 认证提供商：Z.AI

3.认证方式：Z.AI API key

4.输入你的 Z.AI API Key

5.默认模型选择：zai/glm-4.5-air

6.其余选项均选择：Skip for now / No

至此，openclaw基础配置已完成

5. 访问方式

方式一：Linux终端TUI访问

openclaw tui

方式二：浏览器本地访问

# Windows的cmd窗口运行（需输入Linux登录密码）
ssh -N -L 18789:127.0.0.1:18789 root@<LinuxIP>

浏览器打开：http://localhost:18789

四、对接飞书渠道（Feishu/Lark）

1. 创建并配置飞书机器人

要让 OpenLLM 接入飞书，我们需要先在飞书开放平台创建专属的机器人应用：

1. 创建应用并获取凭证：

• 登录 飞书开放平台，点击「创建企业自建应用」，新建机器人，添加机器人功能。

• 创建成功后，进入应用管理页面，点击左侧「凭证与基础信息」。

• 复制并保存：App ID、App Secret，后续配置会用到。

2. 开通核心权限（仅需 3 个）

• 点击左侧「权限管理」→「开通权限」。
• 搜索并勾选以下 3 个权限（其他权限无需开启）：
  • im:message（收发单聊 / 群聊消息）
  • im:chat（获取会话信息）
  • contact:base:read（读取用户信息）
• 点击「确认开通权限」，等待约 1 分钟生效。

3. 配置事件订阅（关键步骤）

• 点击左侧「事件与回调」，将「订阅方式」选择为「使用长连接接收事件（推荐）」，点击「保存」。
• 点击「添加事件」，搜索并添加 im.message.receive_v1（接收消息事件），确保该事件状态为「已开启」。

4. 发布应用并添加可用范围

• 点击左侧「版本管理与发布」→「创建版本」，填写版本号（如：1.0.0）和更新说明，点击「发布」。
• 确认发布后，在「可用范围」中添加你的飞书账号，确保状态为「已通过」。

完成以上步骤后，飞书机器人就配置好了。

2. 进入配置向导

openclaw onboard

3. 飞书渠道配置步骤

1. 跳过模型配置，频道选择：Feishu/Lark（飞书）

2. 密钥提供方式：Enter App Secret

3. 输入飞书自建应用的 App ID 与 App Secret

4. 连接模式：WebSocket（默认）

5. 飞书域名：Feishu (feishu.cn) - China

6. 群聊策略：Open - respond in all groups (requires mention)

7. 搜索提供商、技能、钩子均选择：Skip for now

4. 飞书身份认证绑定

打开飞书，搜索创建的机器人，发送一条消息。

首次对话会提示access not configured，执行系统返回的绑定命令：

openclaw pairing approve feishu 你的绑定编码

执行完成后，即可在飞书中与 OpenClaw 智能体正常对话。