OpenClaw AI需启用WebSocket支持以实现低延迟双向实时会话。具体包括：一、确认版本≥0.12且ws库为^8.19.0；二、检查Gateway是否监听ws端口（如8081）；三、确保飞书等通道配置ws协议地址并显示active (ws)；四、Android客户端须使用ws://且TLS/域名正常；五、在gateway.yaml中设prewarm: true并重启服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在OpenClaw AI中建立低延迟、双向实时的AI会话连接，但发现消息响应卡顿或状态同步异常，则可能是由于通信协议未正确启用WebSocket支持。以下是验证与启用OpenClaw AI WebSocket通信的具体步骤：
一、确认OpenClaw版本及核心依赖支持
OpenClaw自v0.12起正式将WebSocket作为默认通信底层协议之一，其核心依赖ws库（^8.19.0）已深度集成于Gateway控制平面，用于承载Protobuf序列化消息流。该机制确保客户端与服务端维持长连接，避免HTTP轮询开销。
1、打开终端，进入OpenClaw项目根目录。
2、执行命令 cat package.json | grep ws，确认输出包含 "ws": "^8.19.0"。
3、运行 openclaw --version，核对版本号是否 ≥ 0.12。
二、检查Gateway服务WebSocket端口监听状态
Gateway作为OpenClaw的统一通信入口，必须在指定端口上主动监听WebSocket升级请求。若端口被占用或配置关闭，将导致客户端无法建立ws://连接。
1、查看当前运行中的OpenClaw服务进程：ps aux | grep gateway。
2、定位其启动参数，确认是否含 --ws-port=8081 或类似配置项。
3、执行 lsof -i :8081（macOS/Linux）或 netstat -ano | findstr :8081（Windows），验证该端口是否处于LISTEN状态。
三、验证飞书/Telegram等通道的WebSocket接入配置
飞书、Telegram等第三方通道模块均通过OpenClaw的通道层（Channels）抽象接入，其内部使用WebSocket协议与Gateway通信。若通道未启用WebSocket模式，将回退至HTTP webhook，丧失实时性。
1、进入飞书开发者后台，访问对应应用的“机器人”设置页。
2、检查“事件订阅”地址是否为 ws://your-server:8081/v1/channels/feishu 格式（而非https://）。
3、在OpenClaw CLI中执行 openclaw channel list，确认feishu通道状态显示为 active (ws)。
四、调试Android客户端WebSocket连接行为
Android端基于Kotlin + Jetpack Compose实现，内置WebSocket客户端组件，负责与Gateway维持心跳与消息收发。连接失败常源于TLS握手异常或域名解析问题。
1、在Android Studio中启用Logcat，筛选关键字 WebSocketConnection。
2、观察日志中是否出现 Upgrade request sent 及后续 Connected to ws://...。
3、若提示 Failed to upgrade to websocket，检查APP内配置的Gateway地址是否使用 ws://（非http://）且端口开放。
五、强制启用WebSocket预热机制
OpenClaw提供WebSocket预热（WebSocket Pre-warming）功能，可在服务启动时主动发起连接测试并缓存连接池，避免首次交互延迟。该机制需显式开启，否则默认不激活。
1、编辑 config/gateway.yaml 文件。
2、在 websocket: 节点下添加字段：prewarm: true。
3、重启服务：openclaw gateway restart，观察日志中是否输出 [WS] Pre-warmed 3 connections for feishu, telegram, discord。
