6. 启动、守护进程与开机自启

本节目标：搞懂前台运行和守护进程（daemon）差在哪，知道开机自启是怎么来的，学会确认网关是否真的在跑。读完你能自己重启、查状态、排查”没起来”。

两种跑法

OpenClaw 网关有两种启动方式。

前台运行：你盯着终端，日志哗哗刷。关掉终端，网关跟着停。适合调试、看实时报错。

守护进程（daemon）：网关在后台默默跑，不占终端，也不因你关窗口而停。重启电脑后还能自动起来。日常使用就靠它。

Note

守护进程在命令上对应 openclaw daemon ...，它是 openclaw gateway ... 的别名。官方文档更推荐写 gateway，两者干的事一样。

还记得第 5 章那条命令吗：

openclaw onboard --install-daemon

末尾的 --install-daemon 就是关键。它把网关注册成系统服务，由操作系统的服务管理器接管。

各系统的落点不同：

你不用手动往启动项里塞东西。装服务这一步，开机自启的思路就落实了。

装好守护进程后，常用这几条：

openclaw gateway status   # 看在不在跑、健康检查
openclaw gateway start    # 启动
openclaw gateway stop     # 停止
openclaw gateway restart  # 重启（改配置后常用）

用 daemon 写法也行，效果相同：

openclaw daemon status
openclaw daemon restart

Tip

改了配置文件，第一反应不是重装，而是 openclaw gateway restart。多数改动重启后即生效。

最简单：

openclaw gateway status

它会报服务安装状态（launchd / systemd / schtasks），并探测网关健康。

想看更细，加 --deep：

openclaw gateway status --deep

这会额外扫一遍系统里有没有别的网关在抢端口，并做插件感知的配置校验。一台机器只该有一个网关，--deep 帮你发现冲突。

Note

健康检查依赖网关认证。若状态报认证解析警告，用 openclaw gateway status --token <你的令牌> 显式带上，或先把密钥源配好再查。

普通重启直接来：

openclaw gateway restart

如果网关正忙着重要任务，想等它干完再重启，用安全模式：

openclaw gateway restart --safe

它会先问网关”手头活干完没”，合并成一次重启，最多等五分钟。到点还没空，就强制重启。

有时你不想它开机就跑。先停服务，再视系统卸载：

openclaw gateway stop
openclaw gateway uninstall

macOS 上 stop 还能加 --disable，让这次停止在重启前一直生效，不被守护逻辑拉起。

完全没反应。先 gateway status 看服务装没装、活没活。多半是 --install-daemon 那步没跑。

端口被占。默认 18789。另一程序占了，网关起不来。查占用，或换端口后重启。

认证不过。状态报 auth 警告，核对 gateway.auth.token 或密码是否配置。配错模式，安装阶段都会拦你。

Tip

排错顺序：先 status，再 doctor，最后看日志。别一上来就重装，绝大多数问题重启能解。

下一章拆开配置文件本身：它长什么样，常改哪些字段，改完怎么生效。