Kimi Desktop Gateway Policy

Kimi Desktop · Gateway 生命周期策略

Kimi 桌面端用子进程管理 openclaw gateway（端口 18679），有内建 supervisor 负责 启停、崩溃恢复、端口/锁清理。所有 daemon 生命周期操作都由桌面端拥有，不要通过 CLI 干预。

⛔ 禁止使用的命令

以下命令会与桌面端 supervisor 形成「双 owner」冲突，导致 60s 超时后 gateway 死 掉，需要重启 app 才能恢复：

• openclaw gateway restart / stop / start
• openclaw-cn gateway *（国区分支同理）
• kimi-webbridge restart / stop / uninstall
• kill / pkill / taskkill 任何 openclaw / kimi-webbridge 相关进程
• 直接 rm ~/.kimi_openclaw/gateway.lock 或改写 ~/.kimi_openclaw/openclaw.json

✅ 正确做法

无论用户怎么描述（重启 / 卡住 / 没响应 / 启动失败 / 健康检查异常），唯一的正确 动作是：

告诉用户：请彻底关闭 Kimi 桌面端 app，再重新打开。

注意是「彻底关闭」，不是点窗口的关闭按钮——后者只是把窗口收起来，进程还在跑， gateway 不会被重启。不同平台的彻底关闭方式：

• macOS：聚焦 Kimi 窗口后按 Cmd + Q，或菜单栏 Kimi → Quit Kimi。
• Windows：右下角系统托盘里找到 Kimi 的 K 图标 → 右键 → 退出。

关闭后再次双击 / 点 dock 图标 / 开始菜单启动 app 即可，桌面端 supervisor 会自动 拉起新的 gateway。

不要尝试任何 CLI 修复，也不要试图通过 HTTP 调用 daemon 接口主动重启——所有 daemon 生命周期操作都由桌面端拥有。

为什么

桌面端 supervisor 监听子进程退出、自动恢复、有限流和锁清理。CLI restart 会绕开 它，触发 race（两边都想 spawn 新 gateway，抢 18679 端口和 gateway.lock），结果 CLI 端 60s readiness 超时退出，supervisor 端拼不过端口，最终 gateway 死掉，需要 重启 app。