Ubuntu 服务器部署 OpenClaw + 飞书插件完全指南

场景：你正在一台全新的 Ubuntu 服务器上部署 OpenClaw，并希望集成飞书（Feishu）作为 IM 界面。挑战：服务器网络环境可能会导致 GitHub SSH 连接失败，且 OpenClaw 的插件安装需要特定的 Node.js 环境。

本文将整理一份经过验证的“避坑”指南，涵盖从环境准备、Git 配置技巧到插件安装的完整流程。

1. 系统更新与 Node.js 环境准备

首先，确保系统软件包是最新的，并安装基础工具。

# 更新系统
sudo apt update
sudo apt -y full-upgrade

# 安装基础依赖
sudo apt -y install npm curl

安装 Node.js (使用 n 管理器)

OpenClaw 依赖较新的 Node.js 版本。我们推荐使用 n 来管理 Node 版本，简单且不易出错。

# 安装 n 版本管理器
sudo npm i -g n

# 切换到稳定版 (Stable)
sudo n stable

# 刷新环境变量并验证
hash -r
node -v
# 预期输出：v18.x 或 v20.x 等最新稳定版

2. 关键步骤：强制 Git 使用 HTTPS (解决 SSH 权限问题)

这是部署过程中最容易卡住的一步。

问题现象：在安装 openclaw 或其依赖时，某些包可能会尝试通过 SSH 协议 (git@github.com:...) 下载代码。如果你的新服务器没有配置 GitHub SSH Key，就会报错 Permission denied (publickey)。

解决方案：我们不需要生成 SSH Key，而是通过 Git 全局配置，强制将所有 SSH 请求转换为 HTTPS 请求。

执行以下两条命令：

# 规则 1：处理 ssh://git@github.com/ 格式
git config --global url."https://github.com/".insteadOf ssh://git@github.com/

# 规则 2：处理 git@github.com: 格式 (更常见)
git config --global url."https://github.com/".insteadOf git@github.com:

验证配置：

git config --global --list
# 你应该看到类似如下输出：
# url.https://github.com/.insteadof=ssh://git@github.com/
# url.https://github.com/.insteadof=git@github.com:

3. 安装 OpenClaw

配置好 Git 后，安装 OpenClaw 就非常顺畅了：

npm i -g openclaw@latest

(可选) 恢复 Git 配置

安装完成后，如果你不喜欢保留全局重定向规则，可以将其删除：

git config --global --unset-all url."https://github.com/".insteadOf

# 再次检查，确认无关配置已清除
git config --global --list

4. 安装飞书 (Feishu) 插件

OpenClaw 的强大之处在于其插件生态。通过以下命令安装官方飞书插件：

npx openclaw plugins install @m1heng-clawd/feishu

⚠️ 重要：清理重复文件

根据社区反馈，安装插件后可能会在日志中频繁看到重复文件的警告。运行以下命令清理多余文件：

# 删除导致警告的重复目录
rm -r /usr/local/lib/node_modules/openclaw/extensions/feishu

如果不执行此步骤，后续运行 npx openclaw logs --follow 时可能会被警告信息刷屏。

5. 初始化与服务管理

初始化配置 (Onboard)

配置 Docker、数据库连接等基础信息：

npx openclaw onboard

服务管理

OpenClaw 提供了方便的 Gateway 管理命令：

# 重启服务 (应用新插件或配置)
npx openclaw gateway restart

# 停止服务
npx openclaw gateway stop

# 查看实时日志
npx openclaw logs --follow

总结

通过以上 5 步，你已经成功在 Ubuntu 上搭建了一个支持飞书集成的 OpenClaw 环境。

核心知识点回顾：

使用 n 快速管理 Node.js 版本。
利用 git config insteadOf 巧妙绕过服务器 SSH Key 配置难题。
安装插件后记得清理重复文件以保持日志干净。

Enjoy your AI Agent journey! 🚀