🦞ClawTips
← Back to library

Doctor 误报规避：launchd 下避免误杀正在运行的 gateway

场景：macOS launchd 中非 gateway 服务若引用 ~/.openclaw 路径，doctor 可能误判为 gateway-like，并给出会中断服务的清理建议。

GITHUBDiscovered 2026-02-14Author jeades
Prerequisites
  • You run OpenClaw on macOS with launchd service management.
  • You can inspect launchd labels/plists before executing cleanup hints.
Steps
  1. Run openclaw doctor and collect all services reported as gateway-like without executing cleanup commands yet.
  2. For each flagged service, inspect launchd label and ProgramArguments to confirm whether it actually launches gateway.
  3. If service is unrelated, keep it and only clean obsolete ai.openclaw.gateway entries that are provably inactive.
  4. After any cleanup, verify gateway is still online and reachable from your normal chat channel.
Commands
openclaw doctor
openclaw gateway status
launchctl list | grep -i openclaw
openclaw logs --local-time
Verify

Doctor output is reviewed without accidental gateway shutdown, and gateway remains healthy after cleanup decisions.

Caveats
  • Blindly executing autogenerated cleanup hints can break remote/headless access.
  • Exact doctor detection behavior may change in later patches; re-check release notes before standardizing SOP（需验证）.
Source attribution

This tip is aggregated from community/public sources and preserved with attribution.

Open original source ↗
Visit original post