逆向 WebChat 协议：为 OpenClaw 打造零侵入接入方案

极简代码示例

以下是一个最小化的实现。你可以把它看作是一个 Headless WebChat。

""" OpenClaw 通用适配器示例
目标：将终端 (Console) 变成 OpenClaw 的聊天窗口
"""
import sys
from openclaw_webchat_adapter.ws_adapter import OpenClawChatWsAdapter as adapter

def main() -> int:
    # 1. 一键连接：自动读取环境变量，完成复杂的握手协议
    print("正在连接 OpenClaw Gateway...")
    try:
        connect = adapter.create_connected_from_env()
        print("✅ 连接成功！(伪装 WebChat 模式)")
    except Exception as e:
        print(f"❌ 连接失败：{e}")
        return 1

    # 2. 交互循环
    try:
        while True:
            # 获取用户输入
            query = input("\n[我] > ").strip()
            if not query:
                continue
            if query.lower() in ("/exit", "/quit"):
                break

            print("[Agent] > ", end="")
            # 3. 流式透传：SDK 帮你处理了所有分包逻辑
            # 这里返回的 chunk 已经是清洗过的纯文本
            for chunk in connect.stream_chat(query):
                print(chunk, end="", flush=True)
            print("") # 换行
    except KeyboardInterrupt:
        print("\n再见！")
    finally:
        # 释放连接资源
        connect.stop()
    return 0

if __name__ == "__main__":
    sys.exit(main())

总结与思考

方案价值：通用性与一致性

• 无缝嵌入：因为接口极其简单（stream_chat），你可以把它嵌入到 Django/FastAPI 后端、Qt 桌面应用、甚至是树莓派的自动化脚本中。
• 历史漫游：这是一个巨大的隐形优势。因为 Gateway 认为你是 WebChat 用户，所以你在 CLI 里的所有聊天记录，打开浏览器登录 OpenClaw 官网时，全部都在。这对于调试 Agent Prompt 或回溯对话非常有用。

局限性

• 依赖稳定性：这本质上是一种 Protocol Reverse Engineering。如果 OpenClaw 官方大幅修改了 WebSocket 的通信 Payload 结构，适配器代码需要随之更新（虽然 WebChat 协议通常为了兼容性会保持稳定）。
• 并发模型：Python 的 WebSocket 依赖 threading 或 asyncio，在高并发场景下作为中间件转发时，需要注意连接池的管理。

开源地址

• GitHub: tangdeyx2333-beep/openclaw-webchat-adapter
• Gitee: ha-big-brother/openclaw-webchat-adapter

协议细节详见仓库 README 文档。