用途:gateway 守护进程是常驻的 pi 会话,接收来自 Inngest 函数、Telegram 和 webhook 的事件,充当系统的通知与通信层。规则是始终使用 joelclaw gateway CLI,不要直接用 launchctl、curl 或 grep 日志文件。
主要能力:提供 doctor(检查进程、源码树、Redis、适配器与轮询器,--live 走完整通知路径且需真实 Telegram platformMessageId)、status(守护进程可用性、运行模式、会话压力、Redis 健康)、restart(规范重启,清理 Redis 状态并重新启用 launchd 服务后打印 doctor 摘要)、enable(launchd 漂移禁用后的直接恢复路径)、test(推送测试事件验证 Redis 桥接路径)、push、events、drain、stream(NDJSON 事件流)、channel(list/status/enable/disable)、behavior(add/list/promote/remove/apply/stats)等命令。
使用方式:重启用 joelclaw gateway restart,恢复用 joelclaw gateway enable,不要直接使用 launchctl bootout/bootstrap。频道启停通过 CLI 完成,例如 joelclaw gateway channel disable discord --restart;Telegram 禁用需 --force。行为控制面写入权限仅限 CLI,操作员指令可用 KEEP/MORE/LESS/STOP/START 语法。
适用场景:守护进程诊断与排障、频道启停、事件推送与队列查看、行为契约管理、会话压力与中断/取代状态检查、操作员确认与超时追踪、频道健康与自愈策略查看。
限制:doctor --live 与 gateway test 会发送真实流量,仅在获得目标与内容授权时使用;队列确认不等于投递证明。redis_degraded 模式不代表网关宕机,除非进程/会话健康同时失败。实时守护进程执行主工作树源码,勿在其中保留涉及 gateway 的未完成改动。部分跨频道所有权强制与原生修复自动化尚未完成。