timbot-ws - Tencent Cloud IM WebSocket Channel Plugin

OpenClaw 腾讯云 IM 通道插件（WebSocket 版）— 通过 WebSocket SDK 实现腾讯云即时通信 IM 智能机器人。

Maintainer: leochliu@tencent.com

---

• English: README.en.md
• 中文： README.zh-CN.md

---

与 timbot（Webhook 版）的区别

特性	timbot-ws (WebSocket)	timbot (Webhook)
部署要求	无需公网 IP	需要公网 IP + HTTPS
连接方式	长连接，主动连接腾讯 IM	被动接收 Webhook 回调
适用场景	本地开发、内网部署、快速原型	生产环境、高并发、多实例
Multi-Agent	🚧 暂不支持单机器人多 Agent	✅ 支持
流式消息	⚠️ 部分支持（text_modify/custom_modify）	✅ 完整支持（含原生 TIMStreamElem）

⚠️ 注意：timbot-ws 当前不支持单机器人的 multi-agent 模式，如需此功能请使用 timbot（Webhook 版）。详见 限制说明。

---

Web Demo — 腾讯云 IM TIMBot 插件支持全平台，本页面仅供 Web 测试，请勿用于正式环境。

Full integration guide / 完整对外接入教程 — OpenClaw：微信小程序快速接入指南

---

Quick Start

# Install from npm
openclaw plugins install timbot-ws

# Or local development
git clone https://github.com/Tencent-RTC/TIMBot-WS.git && cd TIMBot-WS
pnpm install && pnpm build
bash install-timbot-ws.sh

---

Changelog

2026.4.2

• feat: 支持图片/文件消息

2026.4.1

• feat: C2C 私聊与群聊支持

---

限制说明

tim_stream 模式不支持

timbot-ws 的 tim_stream 模式（原生 TIMStreamElem 流式消息）不可用。

原因：腾讯 IM Node SDK 目前不支持发送流式消息（TIMStreamElem），该功能只能通过服务端 REST API 实现。

可用的流式模式：

模式	可用性	说明
off	✅	关闭流式，一次性发送最终消息
text_modify	✅	通过修改文本消息实现打字机效果
custom_modify	✅	通过修改自定义消息实现，前端自行渲染
tim_stream	❌	SDK 不支持，请使用 timbot（Webhook 版）

单机器人 Multi-Agent 不支持

timbot-ws 当前不支持单机器人的 multi-agent 模式。