内部预览版，诚邀体验

把想法变成 QQ 机器人的功能

FuxstoBot 是一个基于 OneBot 11 的 PHP 框架。让您用模块化的方式，像搭积木一样构建应用。框架处理复杂，开发者处理简单。

探索核心功能快速启动部署

// 您的想法，只需三行代码即可响应
if ($command === '你好') {
    ApiClient::send('世界你好！');
}

为什么选择 FuxstoBot？

工程化设计，让开发重心回归功能逻辑本身。

模块化架构

每个功能独立成模块，互不干扰。启用、禁用、卸载，随时调整，无需改动框架核心。

开箱即用的工具集

事件分发、权限控制、API 调用、命令解析已为您准备就绪。专注业务逻辑，不重复造轮子。

标准协议兼容

完美兼容 OneBot 11 标准。支持 NapCat、Lagrange。底层切换不影响模块代码。

高可用数据处理流

从收到连接到任务分发，一切井然有序

连接客户端

拦截与路由层

各业务模块

Scripts/ —— 优雅简约的设计

不需要继承类、不需要注册事件。打开文件，直接编写业务逻辑。

Scripts/message.php

// 所有的前置环境已由框架解析完毕
switch ($command) {
    case '天气':
        $city = $params[0] ?? '北京';
        $weather = getWeather($city);
        ApiClient::send("天气：{$weather}");
        break;
}

文件即入口

零配置，按约保存即可生效。

变量即上下文

常用参数已在前置拦截中完成切片提取。

关注点分离

网络通信层与业务逻辑层完全剥离。

渐进式学习

从 if-else 平滑过渡到高级模块化开发。

清晰的文件结构

Scripts/

message.php // 专门处理普通消息流

notice.php // 专门处理加群/退群通知

request.php // 专门处理好友请求验证

模块开发：两个文件搞定一个功能

一个模块，一个文件夹，一个纯净的沙盒环境。

完整而独立的生命周期

1 框架扫描加载 Config

2 注册命名空间与自动加载

3 进入 Main 挂载运行层

Modules/MyFeature/

// config.php 模块注册信息
return [
    'name' => '自定义功能',
    'version' => '1.0.0',
    'autoload' => true,
];

// Main.php 独立执行入口
class MyFeature
{
    public static function handle($context)
    {
        // 面向对象处理您的复杂业务逻辑
    }
}

即插即用

隔离执行

独立存储

动态重载

不只是机器人，更是 Hook 网关

处理任何标准 HTTP 请求，QQ 只是您的推送终端之一。

Incoming POST /webhook/github

{
  "ref": "refs/heads/main",
  "repository": {
    "name": "fuxstobot",
    "full_name": "user/fuxstobot"
  }
}

将 GitHub 提交接入群聊

if ($_SERVER['REQUEST_URI'] === '/webhook/github') {
    $payload = json_decode(file_get_contents('php://input'), true);
    
    // 直接调用封装发送至开发群
    ApiClient::sendGroup(
        $dev_group_id, 
        "项目有新提交，请注意查收。"
    );
}

AutoReplyAIMax · 像真人一样聊天

完全自主决策 · 智能参与群聊 · 自然对话体验

上下文理解

自主决策

防刷屏拦截

自然对话体验

有人能推荐一下好用的 PHP 机器人框架吗？

可以试试 FuxstoBot 噢！它是专为 PHP 设计的，模块化开发特别方便，而且兼容 OneBot 11。

释放您的创造力

你想加什么，就写一个模块。

趣味互动

自定义指令回执
群组抽签掷骰
成语接龙游戏
随机运势卡片

实用工具

多源天气查询
文本快捷翻译
公共待办清单
二维码快速生成

群组管理

智能入群欢迎
重要事务定时播报
违规敏感词过滤
群组活跃度统计

进阶集成

大模型对话
新闻源 RSS 订阅
Webhook 接收
第三方业务对接

// 轻松接入天气

Weather::get($city);

// 轻松拦截敏感词

Filter::check($msg);

// 轻松请求外部接口

Http::post($url, $data);

三步跑起你的第一个模块

快速部署，即插即用。

Step 1: 获取框架

Step 2: 配置连接

Step 3: 编写模块

响应逻辑

// 当触发「你好」时，机器人进行回复：
if ($command === '你好') {
    ApiClient::send('Hello World.');
}

[2026-07-04 00:52:30] [INFO] API调用成功: group->713047275

[2026-07-04 00:52:30] [INFO] UptimeHook: 已发送 - warning - USA-1

[2026-07-04 00:52:30] [DEBUG] 收到请求: message_sent

[2026-07-04 00:52:30] [DEBUG] 处理事件: message_sent

Waiting for incoming events...

框架基础能力全览

丰富的底层封装机制，为您护航。

事件分发系统

底层 API 客户端

命令解析系统

群成员识别

权限等级验证

内置数据存储

沙盒模块管理

结构化日志

队列与异步处理