1、概述

什么是长连接

• 长连接（WebSocket）是指由开发者服务器主动向企业微信发起并保持的持久化双向通信通道。
• 如果你想以长连接的方式快速接入OpenClaw，可参考：以长连接方式接入OpenClaw

技术核心机制

1. 安全握手：基于 wss:// 协议建立连接，底层自带加密，业务层无需再处理复杂的消息加解密。
2. 凭证订阅：建连后必须发送 aibot_subscribe 指令，通过机器人专属的 BotID 和 Secret 完成身份校验。
3. 心跳保活：由于是持久连接，开发者需定期（建议每 30秒）发送心跳（ping），防止连接被网关切断。
4. 原生流式响应：完美契合大模型（LLM）的打字机输出效果。开发者可分段推送内容，直至设置 finish=true 结束流式输出，无需频繁刷新。

适用场景

• 内网部署：无需固定的公网 IP 和对外暴露 URL。由内网主动向外建连，完美穿透防火墙，企业数据更安全。
• 极低延迟：省去了每次通信的握手开销，实时性极高，非常适合 AI 实时对话助手。

• 简化开发：免去了传统 Webhook 模式下配置 URL、验证 Token 及消息解密的繁琐步骤。

  请妥善保管你的Bot ID、Secret，切勿轻易透露给他人。

2、开发者文档

如果你是开发者，可参考：企业微信开发者文档