记一次排查 Gateway 端口被旧进程占用的完整流程

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

# 输出显示
tcp    0    0 0.0.0.0:18789    0.0.0.0:*    LISTEN    2756798/openclaw-ga

# 查看进程详情
ps aux | grep 2756798

# 输出显示
root  2756798  0.0  0.4 1234567 89012 ?  Ss  Mar23  ?  1:30 /opt/openclaw/openclaw-gateway --config=/etc/openclaw/config.yml

# 查看 systemd 服务状态
systemctl status openclaw-gateway

# 输出显示
● openclaw-gateway.service - OpenClaw Gateway
   Loaded: loaded (/etc/systemd/system/openclaw-gateway.service; enabled)
   Active: inactive (dead) since Sun 20:00:00 CST 2026; 30min ago

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

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

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

# 通过 systemd 启动服务
systemctl start openclaw-gateway

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

# 验证端口监听
ss -tlnp | grep 18789

# 确保服务开机自启
systemctl enable openclaw-gateway

# 查看当前是否 enabled
systemctl is-enabled openclaw-gateway

#!/bin/bash

# 端口冲突快速排查脚本
PORT=${1:-18789}
SERVICE_NAME="openclaw-gateway"

echo "=== 端口 ${PORT} 冲突排查 ==="
echo ""

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

# 2. 检查进程详情
echo "2. 检查占用进程的详细信息..."
PID=$(ss -tlnp | grep ":${PORT} " | grep -oP 'pid=\K\d+')
if [ -n "$PID" ]; then
    ps -p $PID -o pid,ppid,etime,cmd
    echo ""
    echo "进程运行时间: $(ps -p $PID -o etime --no-headers)"
else
    echo "端口未被占用"
fi
echo ""

# 3. 检查 systemd 服务状态
echo "3. 检查 systemd 服务状态..."
systemctl status $SERVICE_NAME --no-pager
echo ""

# 4. 提供解决方案
echo "=== 解决方案 ==="
if [ -n "$PID" ]; then
    echo "发现旧进程 PID=$PID 占用了端口"
    echo ""
    echo "执行以下命令清理旧进程并重启服务:"
    echo "  kill $PID"
    echo "  sleep 2"
    echo "  systemctl restart $SERVICE_NAME"
    echo ""
    echo "是否现在执行? (y/n)"
    read -r answer
    if [ "$answer" = "y" ]; then
        kill $PID
        sleep 2
        systemctl restart $SERVICE_NAME
        echo "服务已重启"
        systemctl status $SERVICE_NAME --no-pager
    fi
else
    echo "端口未被占用，服务可能正常"
fi

# 禁止直接运行的方式
# 使用 systemctl start 而不是 ./openclaw-gateway

#!/bin/bash

# 升级脚本示例

# 1. 检查是否有旧进程在运行
OLD_PID=$(ps aux | grep 'openclaw-gateway' | grep -v grep | awk '{print $2}')
if [ -n "$OLD_PID" ]; then
    echo "发现旧进程 PID=$OLD_PID，正在停止..."
    kill $OLD_PID
    sleep 3
fi

# 2. 执行升级
echo "开始升级..."

# 3. 启动新服务
systemctl restart openclaw-gateway

# 在启动命令中加入 --pidfile 参数
/opt/openclaw/openclaw-gateway --config=/etc/openclaw/config.yml --pidfile=/var/run/openclaw-gateway.pid

# 添加到 crontab
*/5 * * * * /opt/scripts/check-gateway.sh