记一次 OpenClaw 飞书插件安装：Node版本不匹配与端口占用问题排查全记录

# 检查当前 Node.js 版本
node --version

# 输出
v18.17.0

# 检查是否有 nvm
command -v nvm

# 或者
ls -la ~/.nvm/nvm.sh

# 加载 nvm
source ~/.nvm/nvm.sh

# 安装 Node.js 22
nvm install 22

# 切换到 Node.js 22
nvm use 22

# 确认版本
node --version
# 应该输出 v22.x.x

# 下载并安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

# 重新加载 shell 配置
exec $SHELL

# 安装 Node.js 22
nvm install 22

# 设置默认版本
nvm alias default 22

# 下载 Node.js 22
cd /tmp
wget https://nodejs.org/dist/v22.14.0/node-v22.14.0-linux-x64.tar.xz

# 解压到 /usr/local
sudo tar -xf node-v22.14.0-linux-x64.tar.xz -C /usr/local --strip-components=1

# 确认版本
node --version

# 在 Node.js 22 环境下重新安装插件
source ~/.nvm/nvm.sh && nvm use 22
openclaw plugin add @openclaw/feishu

# 如果安装成功，重启 Gateway
systemctl restart openclaw-gateway

# 检查日志
journalctl -u openclaw-gateway -n 50

# 检查端口 18789 是否被占用
ss -tlnp | grep 18789

# 输出示例
tcp  0  0  0.0.0.0:18789  0.0.0.0:*  LISTEN  123456/openclaw-ga

# 查看进程详细信息
ps -p 123456 -o pid,ppid,etime,cmd,user

# 示例输出
PID   PPID  ELAPSED   CMD                          USER
123456  1    15-00:00:00  /opt/openclaw/openclaw-gateway  root

# 检查 Gateway 服务状态
systemctl status openclaw-gateway

# 示例输出
● openclaw-gateway.service - OpenClaw Gateway
   Loaded: loaded (/etc/systemd/system/openclaw-gateway.service; enabled; vendor preset: enabled)
   Active: inactive (dead) since Mon 10:30:00 2026; 2h ago

# 先确认这个进程是否可以安全杀掉
ps -p 123456 -o pid,etime,cmd

# 如果确认是旧进程，杀掉它
kill 123456

# 等待几秒，确认进程已退出
sleep 2
ss -tlnp | grep 18789

# 检查服务是否 enabled
systemctl is-enabled openclaw-gateway

# 如果不是 enabled，启用它
systemctl enable openclaw-gateway

# 重启服务
systemctl restart openclaw-gateway

# 检查服务状态
systemctl status openclaw-gateway

# 验证端口现在由 systemd 服务监听
ss -tlnp | grep 18789

# 确认是 systemd 启动的进程
ps aux | grep openclaw-gateway | grep -v grep

#!/bin/bash
# openclaw-gateway-port-fix.sh
# 用于清理占用 18789 端口的旧进程并重启服务

PORT=${1:-18789}
SERVICE_NAME="openclaw-gateway"

echo "=== OpenClaw Gateway 端口冲突修复脚本 ==="
echo ""

# 1. 检查端口占用
echo "1. 检查端口 ${PORT} 占用情况..."
 ss -tlnp | grep ":${PORT} " || echo "端口未被占用"
echo ""

# 2. 找到占用进程
echo "2. 分析占用进程..."
PID=$(ss -tlnp | grep ":${PORT} " | grep -oP 'pid=\K\d+' | head -1)
if [ -n "$PID" ]; then
    ps -p $PID -o pid,ppid,etime,user,cmd
    echo ""
    
    # 3. 检查是否是 systemd 管理的进程
    echo "3. 检查进程来源..."
    SYSTEMD_PID=$(systemctl show --property=MainPID --value ${SERVICE_NAME} 2>/dev/null)
    if [ "$PID" = "$SYSTEMD_PID" ]; then
        echo "进程由 systemd 管理 (PID=$PID)，可能是服务启动失败"
        echo "检查日志：journalctl -u ${SERVICE_NAME} -n 50"
        systemctl status ${SERVICE_NAME}
    else
        echo "进程 $PID 不是由 systemd 管理（systemd 认为 MainPID=$SYSTEMD_PID）"
        echo "这是旧进程残留，正在清理..."
        
        # 4. 清理旧进程
        echo "4. 清理旧进程..."
        kill $PID
        sleep 2
        
        # 5. 确认清理成功
        if ss -tlnp | grep -q ":${PORT} "; then
            echo "警告：端口仍被占用，尝试强制杀掉"
            kill -9 $PID
            sleep 1
        fi
    fi
else
    echo "端口未被占用"
fi
echo ""

# 6. 重启服务
echo "5. 重启 ${SERVICE_NAME} 服务..."
systemctl restart ${SERVICE_NAME}
sleep 2

# 7. 验证结果
echo "6. 验证结果..."
if systemctl is-active ${SERVICE_NAME}; then
    echo "✅ 服务运行正常"
    ss -tlnp | grep ":${PORT} "
else
    echo "❌ 服务启动失败，检查日志："
    systemctl status ${SERVICE_NAME} --no-pager
    journalctl -u ${SERVICE_NAME} -n 20 --no-pager
fi

# 保存脚本
sudo tee /usr/local/bin/openclaw-gateway-port-fix.sh << 'EOF'
# (粘贴上面的脚本内容)
EOF

# 添加执行权限
sudo chmod +x /usr/local/bin/openclaw-gateway-port-fix.sh

# 执行脚本
sudo /usr/local/bin/openclaw-gateway-port-fix.sh

# 在配置管理工具中添加 Node.js 版本检查
# 或者使用 Docker 容器来隔离 Node.js 环境

# 在 /etc/openclaw/config.yml 中添加限制
gateway:
  # 只允许通过 systemd 启动
  allow_manual_start: false

#!/bin/bash
# openclaw-upgrade.sh

# 1. 检查并停止旧服务
echo "停止旧服务..."
systemctl stop openclaw-gateway || true

# 2. 等待端口释放
echo "等待端口释放..."
sleep 3

# 3. 检查是否有残留进程
PID=$(ss -tlnp | grep ":18789 " | grep -oP 'pid=\K\d+' | head -1)
if [ -n "$PID" ]; then
    echo "发现残留进程 PID=$PID，正在清理..."
    kill $PID || true
    sleep 2
fi

# 4. 执行升级
echo "执行升级..."
npm install -g openclaw-gateway

# 5. 启动新服务
echo "启动新服务..."
systemctl start openclaw-gateway

# 添加到 crontab
*/5 * * * * /usr/local/bin/check-gateway-port.sh

# 查看服务状态和最新日志
systemctl status openclaw-gateway
journalctl -u openclaw-gateway -n 50

# 检查是否有崩溃
journalctl --system --priority=3 -n 20