一、环境准备（必须先做）

1. 安装基础依赖

yum install -y git curl wget gcc gcc-c++ make

2. 安装 Node.js 20（必须这个版本）

curl -fsSL https://rpm.nodesource.com/setup_20.x | bash -
yum install -y nodejs

3. 验证版本

node -v  # 必须 >= v20.x
npm -v

二、从 GitHub 拉取 OpenClaw 源码（国内版）

cd /root
git clone https://github.com/yesmore/openclaw-cn.git
cd openclaw-cn

安装项目依赖

npm install

编译构建（关键）

npm run build

看到类似：

compiled successfully

就是成功。

三、全局安装 OpenClaw（让系统能识别命令）

npm link

执行完后，你就可以在任何目录使用：

plaintext

openclaw

---

四、第一次配置 OpenClaw

1. 启动配置向导

openclaw configure

2. 配置步骤（照着选）

✅ 1 Model → 选择

plaintext

Moonshot AI (Kimi K2.5)

输入你的 Kimi API Key（以 sk- 开头）

✅ 2 Channels → 选择

plaintext

Feishu/Lark

输入：

• Feishu App ID
• Feishu App Secret

✅ 3 其他所有选项

• Skills：No
• Hooks：Skip for now
• 全部一路回车跳过

✅ 最后选择

plaintext

Continue

---

五、安装飞书插件（必须执行）

openclaw plugins install @openclaw/feishu

六、启动 OpenClaw 网关（唯一正确命令）

openclaw gateway

看到以下输出 = 飞书连接成功

plaintext

[feishu] connected
[gateway] running

---

七、飞书后台必须配置的 3 个点（不配置无法收消息）

1. 事件订阅 → 订阅方式

选择：

plaintext

使用长连接接收事件

2. 添加事件

plaintext

im.message.receive_v1

3. 权限管理 → 开启

plaintext

以应用的身份发消息
im:message:readonly

---

八、常见报错 100% 解决

报错 1：feishu plugin 加载失败

rm -rf /root/.openclaw
openclaw configure

报错 2：unknown command: hatch /start/init

openclaw configure   # 配置
openclaw gateway     # 启动
openclaw plugins install 插件名  # 安装插件

报错 3：Kimi 401 认证失败

重新配置 API Key：

openclaw configure

进入 Model 重新输入 sk-xxxx

报错 4：飞书收不到消息

检查 3 点：

1. 飞书后台是否开启长连接
2. 是否添加 im.message.receive_v1
3. 是否开启发消息权限

---

九、最终效果

启动后：

plaintext

[feishu] connected
[moonshot] ready
[gateway] running

打开飞书，给机器人发消息，立刻收到 Kimi 回复！

---

十、后台运行（关闭终端不掉线）

nohup openclaw gateway > openclaw.log 2>&1 &

查看日志：

tail -f openclaw.log

📌 总结（本文核心）

1. 从源码安装 = git clone + npm install + npm run build + npm link
2. 必须用 Node.js 20
3. 唯一启动命令：openclaw gateway
4. 飞书必须开：长连接 + 事件 + 发消息权限
5. 全程无报错、无玄学