乐于分享
好东西不私藏

OpenClaw本地部署后发生的奇妙情况

OpenClaw本地部署后发生的奇妙情况

    本地部署 OpenClaw 第二天“失联又恢复”?一次真实排障复盘

    最近在本地用 WSL 部署 OpenClaw,并接入飞书做 Agent 测试时,出现了一个非常典型但又容易误判的问题:

第一天正常对话,第二天完全不回复,过一会儿又自己恢复了。


一、现象复盘

你的实际情况可以总结为三点:

  • ✅ OpenClaw Gateway 一直是 running 状态

  • ❌ 飞书侧“完全无响应”(不是报错,是没回)

  • 🔄 未修改配置,后续又自动恢复

这类问题,本质不是“服务挂了”,而是:

请求链路不稳定(间歇性中断)


二、从部署过程看潜在风险点

你这套部署流程是典型的:

nvm + node 22npm 全局安装 openclawsystemd 管理 gatewayWSL 环境运行

重点关注你这几条命令:

nvm install 22npm i -g openclaw@2026.3.28openclaw doctor --fixopenclaw gatewaytmux new -s openclaw

以及状态提示:

Gateway: bind=127.0.0.1Service: systemdNode path: ~/.nvm/...

这里已经埋了几个“隐患”。


三、问题本质拆解(按概率排序)

1️⃣ WSL 网络链路不稳定(最核心原因)

你当前架构:

飞书(公网)
   ↓
WSL 内 OpenClaw(127.0.0.1)
👉 问题点:
  • WSL 是 NAT 网络

  • IP 会变化

  • Windows 网络唤醒/休眠会影响端口映射

现象解释:

时间
状态
第一天
NAT 映射正常 → 飞书能访问
第二天
映射失效 → 飞书请求进不来
后来恢复
网络重新建立 → 又通了

👉 所以你“啥也没改但恢复了”是合理的


2️⃣ systemd + nvm 冲突(高风险)

你日志里已经提示:

Service uses Node from a version manager
👉 本质问题:
  • systemd 启动时不会加载 .bashrc

  • nvm 环境变量可能缺失

  • Node 路径可能失效

可能导致:

  • Gateway 实际运行异常

  • 子进程(如 webhook handler)偶发失败

  • 请求处理不稳定


3️⃣ 监听地址限制(127.0.0.1)

bind=loopback (127.0.0.1)

👉 含义:

  • 只允许本机访问

  • 飞书无法直接访问

但为什么“有时能用”?

👉 因为:

  • 某些阶段存在临时代理 / 端口转发

  • 或 WSL 网络桥接偶然打通

👉 这是非稳定行为


4️⃣ pairing / session 机制(低概率)

你执行过:

openclaw pairing approve feishu ...

👉 如果 token / session 过期:

  • 飞书会继续发消息

  • OpenClaw 不处理(静默失败)

但你“自动恢复”,说明不是主因。


5️⃣ tmux 与 systemd 混用(隐性问题)

你同时使用:

tmux + systemd

👉 风险:

  • 多实例 gateway

  • 端口竞争

  • 状态混乱


四、为什么“不是模型问题”

你可以用一个方法快速验证:

tail -f /tmp/openclaw/*.log

然后在飞书发消息:

  • ❌ 没日志 → 请求没进来(网络问题)

  • ✅ 有日志但没回复 → 模型问题

你这次属于:

完全没日志 = 网络链路问题

五、工程级优化建议(重点)

✅ 方案一:解决公网访问(核心)

推荐使用内网穿透:

ngrok http 18789

或:

  • frp(推荐长期使用)

  • cloudflare tunnel(更稳定)

👉 本质:

让飞书可以稳定访问你本地服务

✅ 方案二:放弃 nvm,使用系统 Node(强烈建议)

sudo apt install nodejs

然后:

npm i -g openclaw

👉 避免:

  • systemd 找不到 node

  • 环境变量不一致


✅ 方案三:统一运行方式(不要混用)

二选一:

✔ 方案 A(开发环境)

tmux + openclaw gateway

✔ 方案 B(生产环境)

systemd 管理

👉 不要同时用


✅ 方案四:修改监听地址

openclaw gateway --host 0.0.0.0

👉 允许外部访问(配合端口映射)


✅ 方案五:增加稳定性检测

可以加一个简单健康检查:

curl http://127.0.0.1:18789

或写一个 watchdog:

  • 检测端口

  • 自动重启 gateway


六、推荐最终架构(稳定版)

飞书(公网)
   ↓
frp / ngrok
   ↓
Windows
   ↓
WSL(OpenClaw)
   ↓
本地模型 / API

七、总结

这次问题的本质不是:

  • ❌ OpenClaw 不稳定

  • ❌ 模型出问题

  • ❌ 配置错误

而是:

本地服务缺少稳定公网入口 + WSL 网络不稳定

八、一句话建议

本地开发可以用 ngrok  
长期使用必须上 frp 或云服务器

如果你后面准备:

  • 接 vLLM

  • 做 RAG

  • 接企业飞书

建议直接升级到:

👉 云服务器 + GPU + OpenClaw + 内网穿透消失

可以少踩 80% 的坑。