Shallow API是基于RouterOS的API接口搭建的一个管理平台，主要用于本地网络的RouterOS设备管理（也可以通过隧道远程管理）。支持多台RouterOS同时管理，支持分组区域管。目前具备实时监控功能、通知报警和命令执行等。

由于个人的开发经验非常的浅薄，所以使用shallow这个名称来定义项目！

从v1.0.1版本开始接入智能体 Agent 功能，支持接入不通的 LLM 大语言模型，这样实现 Agent 管理RouterOS。其他功能还在开发中...

功能概述

设备管理：RouterOS 设备增删改查、设备分组、单设备状态页

运行监控：Dashboard、网络流量、连接统计、Sankey 图、系统指标图

自动化执行：

 - API 脚本库

 - 设备组批量执行

 - 定时任务

告警体系：

  - 监控规则、通知规则、Webhook/QQ 机器人联动

系统能力：

 - SQLite/MySQL 双数据库支持

 - 数据备份/恢复与上传下载

 - 证书管理（HTTPS 模式自动检查/生成证书）

Agent 能力：

 - LLM Provider 管理

 - 风险策略（高/中风险路径拦截）

 - 只读查询意图优先直查（RouterOS 只读路由）+ LLM 解释

 - 变更草案、确认、回滚流程

QQ 机器人（WS 长连接）：

 - 基于 `botgo` 主动连接 QQ 网关（无需回调服务器）

 - 支持 C2C 私聊与群 @ 消息对话智能体

 - 支持在通知规则中选择 QQ 机器人发送告警

视频介绍：


界面展示


RouterOS设备状态：

智能体

Shallow API v1.0.1beta1版本开始引入智能体功能，该功能和小龙虾Openclaw类似，支持接入不同语言模型进行对话和执行命令

运行建议

1、API对接主要适配RouterOS v7，建议v7.18+以上版本，读取的参数更兼容；

2、在RouterOS的container运行，已经测试在基于RouterOS v7.17+的hAP ax3，RB5009，RB450x4，CHR，x86等硬件。也可以通过docker import命令导入在Linux 容器运行；

3、在RouterOS的RB、CRS和CCR设备运行时，API获取数据CPU消耗较低，主要是前端页面刷新时CPU消耗较高，如RB450Gx4（IPQ-4019 arm32 4核心）在刷新页面时CPU消耗在40%左右，仅停留在仪表盘或设备状态观察页面时CPU消耗在7-10%左右。

具体使用：手册说明

当前版本：Shallow API 1.0.4 下载

版本：Changelog