PHPackages                             bangbangda/wecomaibot - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP & Networking](/categories/http)
4. /
5. bangbangda/wecomaibot

ActiveLibrary[HTTP & Networking](/categories/http)

bangbangda/wecomaibot
=====================

企业微信 AI 机器人 PHP SDK — 基于 WebSocket 长连接，免回调地址配置

v1.2.0(1mo ago)1213↓100%MITPHPPHP >=8.1

Since Mar 15Pushed 1mo agoCompare

[ Source](https://github.com/bangbangda/wecomaibot)[ Packagist](https://packagist.org/packages/bangbangda/wecomaibot)[ Docs](https://github.com/bangbangda/wecomaibot)[ RSS](/packages/bangbangda-wecomaibot/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (2)Versions (4)Used By (0)

WeComAiBot
==========

[](#wecomaibot)

**企业微信 AI 机器人 PHP SDK** — 基于 WebSocket 长连接，免回调地址配置。

[![PHP Version](https://camo.githubusercontent.com/1a5e13126d38c1d05f712dae30e7f60ae0444a9c882e9e526349ccba27facb8d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253345253344382e312d626c7565)](https://php.net)[![License](https://camo.githubusercontent.com/5caa455d8debc46fb23abbadb45a733a937f3910a73fc875c2f7820468e1bb54/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e)](LICENSE)

> PHP 是世界上最好的语言。Node.js 有的 SDK，PHP 必须也得有。
>
> 别人用回调地址、公网 IP、SSL 证书搞得焦头烂额的时候，我们 PHP 开发者只需要一行 `composer require`，三行代码，原地起飞。

---

这是什么？
-----

[](#这是什么)

企业微信官方提供了 AI 机器人的 WebSocket 长连接通道（`wss://openws.work.weixin.qq.com`），Node.js 有官方 SDK（`@wecom/aibot-node-sdk`），但 PHP 生态一片空白。

**WeComAiBot** 填补了这个空白。它是企业微信 AI 机器人的 PHP SDK，基于 [Workerman](https://www.workerman.net/) 实现 WebSocket 客户端长连接。

**翻译成人话就是：**

- 不用配置回调地址（不需要公网 IP、域名、SSL 证书）
- 不用处理 5 秒超时（WebSocket 没有这个限制）
- 不用搞消息队列（长连接天然异步）
- 在内网、本地、开发机上都能跑
- `composer require` 装完就能用

特性
--

[](#特性)

- **零门槛接入** — 免回调地址，免 SSL，免公网 IP，内网也能跑
- **三行代码启动** — 配置 bot\_id + secret，注册回调，`start()`，完事
- **流式回复** — 支持"思考中"加载动画 → 逐步更新 → 最终回复，就像 ChatGPT 那样
- **主动推送** — 不用等用户说话，机器人可以主动找人聊天
- **模板卡片** — 推送交互式卡片，监听按钮点击，实时更新卡片状态
- **全消息类型** — 文本、语音(转文字)、图片、文件、图文混排、引用消息，全都支持
- **断线自动重连** — 指数退避 + 随机抖动，心跳保活，网不好也不怕
- **串行发送队列** — 帧发送后等 ack 再发下一帧，超时自动跳过，告别消息丢失和乱序
- **多机器人管理** — 一个进程跑多个 bot，各自独立连接、独立重连，数据完全隔离
- **Laravel 深度集成** — Service Provider 自动注册，`php artisan wecom:serve` 一键启动
- **纯 PHP 实现** — 基于 Workerman，不需要装 Swoole 扩展，`composer require` 就行

安装
--

[](#安装)

```
composer require bangbangda/wecomaibot
```

就这么简单。没有第二步。

快速开始
----

[](#快速开始)

### 纯 PHP（任何项目都能用）

[](#纯-php任何项目都能用)

```