Gateway Guard 是一个专为 OpenClaw 网关设计的守护工具，核心功能是确保网关认证配置与 `openclaw.json` 文件中的设置保持一致。当出现设备令牌不匹配（device_token_mismatch）、网关授权错误或运行中断等问题时，该工具可自动检测并修复配置差异，防止因认证不一致导致的连接失败或服务异常。它不仅支持手动检查与修复，还能在检测到特定运行时错误时自动向代理发送“继续”指令，帮助系统从意外中断中恢复。此外，Gateway Guard 提供了灵活的部署选项，包括一次性命令执行和后台持久化监控（通过 LaunchAgent），适用于需要高可用性和自动化运维的 OpenClaw 环境。
核心功能特点
- 自动同步网关认证信息，确保运行中的网关进程与 openclaw.json 中的 token/password 一致
- 支持检测并修复 device_token_mismatch 等认证错误，避免因配置不匹配导致的服务中断
- 可在网关日志中出现 ‘Unhandled stop reason: error’ 时自动发送 continue 消息，恢复代理运行状态
- 提供 status/ensure/continue-on-error/watch 等多种操作模式，适配不同运维需求
- 可选安装后台守护进程（LaunchAgent），每30秒自动检查网关状态并在必要时重启或触发恢复动作
适用场景
Gateway Guard 特别适用于那些依赖 OpenClaw 网关稳定运行且对认证一致性要求较高的场景。例如，在多代理协作或子代理委派流程中，若主网关因 token 不匹配而无法启动子进程，使用 ensure 命令可快速验证并修正配置，确保后续任务正常执行。对于长期运行的自动化服务，安装 watcher 守护进程后，系统将定期监控网关状态，一旦发现认证失效立即重启网关，极大提升服务的可用性。此外，在开发或测试环境中，开发者可通过 continue-on-error 功能快速响应运行错误，减少人工干预，加快问题排查与恢复速度。无论是日常维护、故障排查还是生产环境的高可用保障，Gateway Guard 都能显著降低因配置漂移或临时错误引发的停机风险。