⚡️ 最佳实践：Ubuntu 部署 OpenClaw + MiniMax Coding Plan + 飞书机器人

标签：#OpenClaw #AIAgent #MiniMax #飞书 #运维
版本：2026.2 (Validated)
核心痛点解决：内网穿透(Socket Mode)、Coding Plan 国内鉴权(401/404)、WebUI 安全访问。

1. 环境准备 (Prerequisites)

确保服务器环境干净，避免 Node 版本过低或依赖缺失。

# 1. 安装 Node.js 22 (推荐版本)
curl -fsSL [https://deb.nodesource.com/setup_22.x](https://deb.nodesource.com/setup_22.x) | sudo -E bash -
sudo apt-get install -y nodejs

# 2. 安装 PM2 进程守护
sudo npm install -g pm2

# 3. 拉取 OpenClaw 代码并安装依赖
git clone [https://github.com/openclaw/openclaw.git](https://github.com/openclaw/openclaw.git) ~/openclaw
cd ~/openclaw
npm install

2. 核心安装与初始化 (不要跳过)

OpenClaw 的飞书插件默认不包含在核心包中，必须手动安装，否则机器人会“已读不回”。

cd ~/openclaw

# 1. 基础初始化
node dist/index.js setup

# 2. 📦 关键：安装飞书插件 (解决无响应问题的核心)
node dist/index.js install @openclaw/feishu

3. 关键配置 (踩坑避雷区)

3.1 MiniMax Coding Plan 专用配置

⚠️ 注意：Coding Plan 必须使用国内专用兼容接口，且路径不能带 /v1 (系统会自动补全)。

# 1. 设置 Base URL (必须是 /anthropic 结尾，不要加 /v1，否则报 404)
node dist/index.js config set models.providers.minimax.baseUrl "[https://api.minimaxi.com/anthropic](https://api.minimaxi.com/anthropic)"

# 2. 锁定模型 ID (必须精确匹配，否则无法抵扣套餐)
node dist/index.js config set agents.defaults.model.id "MiniMax-M2.5"
node dist/index.js config set agents.defaults.model.provider "minimax"

# 3. 写入 API Key (sk-cp- 开头的专用 Key)
node dist/index.js config set models.providers.minimax.apiKey "你的_Coding_Plan_Key"

🛡️ 防冲突贴士：请检查根目录下的 .env 文件，确保没有 MINIMAX_API_KEY 变量。OpenClaw 优先读取环境变量，会导致你配置的新 Key 不生效（报 401 错误）。

3.2 飞书 Socket 模式 (免公网 IP)

配置长连接模式，跳过防火墙和内网穿透工具（如 cpolar）。

1. 修改环境变量 (nano .env)：

   # 填入飞书后台获取的凭证
   FEISHU_APP_ID="cli_xxxxxxxx"
   FEISHU_APP_SECRET="xxxxxxxxxxxxxxxx"
   # 🚀 强制开启 Socket 模式
   FEISHU_BOT_TYPE="socket"
   

2. 启用插件开关：

   node dist/index.js config set plugins.enabled true
   node dist/index.js config set plugins.entries.feishu.enabled true
   

4. 启动与进程守护

使用 PM2 启动，确保崩溃自动重启，并清除旧的环境变量缓存。

# 1. 清理旧进程 (防止 PM2 记住错误的配置)
pm2 delete openclaw 2>/dev/null

# 2. 启动网关 (Gateway 模式)
pm2 start dist/index.js --name "openclaw" -- gateway --port 18789

# 3. 保存当前状态 (开机自启)
pm2 save

✅ 验证成功的标志

输入 pm2 logs openclaw --lines 50，看到以下两行即为绝对成功：

1. [gateway] agent model: minimax/MiniMax-M2.5 (模型加载成功)

2. [Feishu] Socket mode connected (飞书连接成功)

(此时飞书后台显示“红色报错”可忽略，直接去飞书发消息测试即可)

5. 高级：如何安全访问 Web 后台

OpenClaw 禁止非 Localhost 访问后台（为了安全）。在 Windows/Mac 电脑上，使用 SSH 隧道进行端口映射。

在你的本地电脑终端执行：

# 将服务器的 18789 映射到本地的 9999 (避免本地端口冲突)
# 格式: ssh -L 本地端口:127.0.0.1:远程端口 用户@IP
ssh -L 9999:127.0.0.1:18789 lieri@你的服务器IP

访问地址：👉 http://localhost:9999

6. 排错速查表 (Cheat Sheet)