ClawHub

Mikrotik

v1.8.5

通过 API 连接和管理 MikroTik RouterOS 设备。支持查看设备状态、防火墙规则、网络配置，执行自定义 RouterOS 命令。

0· 547· 5 versions· 4 current· 4 all-time· Updated 12h ago· MIT-0
bywukefenggao@2944721178

Security Scans

VirusTotalBenignClawScanBenignStatic analysisBenign

Install

openclaw skills install mikrotik

MikroTik RouterOS Skill

通过 API 连接和管理 MikroTik RouterOS 设备。

功能

  • 查看设备状态（系统信息、CPU、内存、存储）
  • 查看防火墙规则（filter、NAT、mangle）
  • 查看网络配置（接口、IP 地址、路由、DNS）
  • 执行自定义 RouterOS 命令
  • 支持多设备连接

配置

方式一：TOOLS.md（推荐）

在 ~/.openclaw/workspace/TOOLS.md 中添加设备信息：

### MikroTik 设备

- **office**: 192.168.1.1, admin, 空密码
- **home**: 192.168.88.1, admin, yourpassword
- **branch**: 192.168.2.1, admin, complex_password_123

密码格式说明：

  • 空密码：写 空密码、无密码、none 或留空
  • 有密码：直接写密码字符串

方式二：环境变量

export MIKROTIK_HOST=192.168.1.1
export MIKROTIK_USER=admin
export MIKROTIK_PASS=        # 空密码
# 或
export MIKROTIK_PASS=yourpassword  # 有密码

优先级：环境变量 > TOOLS.md > 默认值

用法

📊 设备状态

查看 mikrotik 设备状态
查看 office mikrotik 状态
检查路由器运行情况

🔥 防火墙

查看防火墙规则
mikrotik 防火墙配置
显示 NAT 规则
查看 office 防火墙

🔌 网络接口

查看网络接口
mikrotik 接口列表
显示 IP 地址配置

📋 DHCP

查看 DHCP 配置
显示 DHCP 租约
mikrotik dhcp

📡 ARP 表

查看 ARP 表
mikrotik arp
显示 ARP 缓存

🔐 WireGuard

查看 WireGuard 配置
mikrotik wireguard
显示 VPN 对等体

👤 用户

查看用户配置
mikrotik users
显示 PPP 用户

📝 日志

查看系统日志
mikrotik logs
显示最近日志

🔧 服务

查看系统服务
mikrotik services
显示 API/SSH 端口

💾 备份配置

备份配置
mikrotik backup
备份路由器配置

🧹 清理存储

清理存储
mikrotik cleanup
检查可删除的文件

🔐 API 配置

配置 api 访问
mikrotik api
查看 API 服务配置

📈 流量统计

查看接口流量
mikrotik traffic
显示流量统计

🔌 接口详情

查看接口详细信息
mikrotik interface detail
查看 ether1 接口详情

🏷️ VLAN

查看 VLAN 配置
mikrotik vlan
显示 VLAN 列表

🌉 桥接

查看桥接配置
mikrotik bridge
显示桥接端口

📊 队列/带宽

查看队列配置
mikrotik queue
显示带宽限制
查看限速规则

🌐 路由

查看路由配置
mikrotik route
显示 OSPF 状态
查看 BGP 对等体

🌡️ 系统健康

查看系统健康
mikrotik health
显示温度/电压/风扇

📅 计划任务

查看计划任务
mikrotik scheduler
显示定时任务

📡 邻居设备

查看邻居设备
mikrotik neighbors
显示网络设备发现

🔗 活动连接

查看活动连接
mikrotik connections
显示连接统计

🏓 Ping 测试

ping 8.8.8.8
mikrotik ping 1.1.1.1

📡 网络扫描

扫描局域网
mikrotik scan
扫描 192.168.1.0/24
查找 MikroTik 设备

🎯 自定义命令

在 mikrotik 上执行 /system/resource/print
运行 routeros 命令 /ip/address/print
在 office 设备上执行 /interface/print

🖥️ 多设备支持

如果配置了多个设备，可以在命令中指定设备名称：

查看机房 mikrotik 状态
查看 home 防火墙规则

依赖

  • Python 3.6+
  • 设备 API 已启用（默认端口 8728）
  • 网络可达

文件结构

skills/mikrotik/
├── SKILL.md           # 技能说明（本文件）
├── handler.py         # 命令处理器
└── mikrotik-api/      # API 客户端库
    ├── __init__.py
    ├── client.py      # API 客户端
    ├── commands.py    # 快捷命令封装
    ├── cli.py         # 命令行工具
    └── scanner.py     # 网络扫描器（端口扫描）

示例响应

设备状态

📡 MikroTik RouterOS 设备状态
==================================================
  设备名：OFFICE
  版本：7.21.2 (stable)
  运行时间：1w2d9h9m39s
  CPU: MIPS 1004Kc V2.15 @ 880MHz
  CPU 负载：1%
  内存：61.6MB / 256.0MB
  存储：3.6MB / 16.0MB
==================================================

网络扫描

✅ MikroTik 设备 (2):

  [1] OFFICE
      IP: ■■■.■■■.■■■.■:8728
      MAC: ■■:■■:■■:■■:■■:■■
      RouterOS: 7.21.3 (stable)

  [2] MikroTik
      IP: ■■■.■■■.■■■.■:8728
      MAC: ■■:■■:■■:■■:■■:■■
      RouterOS: 7.21.1 (stable)

共发现 2 个设备

注意事项

⚠️ 安全警告

  1. 网络扫描风险

    • mikrotik scan 会主动扫描本地子网，产生网络探测流量
    • 可能在生产网络中触发安全告警
    • 建议：在隔离/测试网络中运行，或事先征得网络管理员许可

  2. 凭据安全

    • ❌ 不要将路由器管理员密码以明文保存在公共或未加密的 TOOLS.md
    • ✅ 推荐：使用环境变量（MIKROTIK_HOST/MIKROTIK_USER/MIKROTIK_PASS）
    • ✅ 推荐：在短期会话中使用临时凭据，用后删除
    • ✅ 推荐：在生产环境中使用安全凭据存储（如 Vault、AWS Secrets Manager）

  3. 本地命令与权限

    • scanner.py 使用 subprocess 调用系统命令（ip/hostname）
    • 需要打开 UDP sockets 进行网络扫描
    • 确保：运行环境允许这些操作，建议在隔离容器或受控机器上测试

📋 使用建议

  1. API 服务必须启用 - 扫描功能依赖 8728/8729 端口开放

    • 启用命令：/ip/service enable api
    • 查看状态：/ip/service/print

  2. 默认端口 - 8728（普通 API），8729（SSL API）

  3. 空密码设备注意安全风险 - 建议设置强密码

  4. 部分命令需要管理员权限 - 如防火墙、用户管理等

  5. 响应解析优化 - 支持多条目返回（接口列表、路由表、ARP 表等）

  6. 扫描性能 - 默认 50 并发线程，约 5 秒扫描/254 IP

🔧 部署前检查清单

  • 已在隔离网络或测试环境中测试
  • 已审阅代码并符合凭据安全策略
  • 已取得运维/网络管理员批准（生产网络）
  • 已设置适当的防火墙规则限制 API 访问
  • 已启用日志记录和监控

更新日志

v1.8.5 (2026-03-09) 🚀

  • 🔍 重构网络扫描功能 - 改用 API 端口扫描方式
    • 扫描 TCP 8728/8729 端口（MikroTik API）
    • 自动获取设备名称、MAC 地址、RouterOS 版本
    • 并发扫描，支持 50 个线程同时探测
    • 只显示已启用 API 的设备（更实用）
  • 📊 优化扫描结果展示
    • 显示设备名、IP、端口、MAC、版本信息
    • 排除未启用 API 的设备（减少干扰）
    • 扫描速度：约 5 秒/254 IP
  • 🔧 更新 scanner.py
    • 删除 MNDP 广播发现方式（兼容性问题）
    • 删除纯 ARP 表扫描方式（信息有限）
    • 新增端口扫描 + ARP 补充 MAC 地址

v1.8.4 (2026-03-08) 🔧

  • 💾 新增备份配置功能 - 创建系统备份、列出备份文件
  • 🧹 新增存储清理功能 - 扫描可删除文件、显示存储建议
  • 🔐 新增 API 配置查看 - 显示 API 服务状态、提供安全建议
  • 📝 整合临时脚本功能到 skill（删除 15 个冗余脚本）

v1.8.2 (2026-03-06) 🔥

  • 🔧 修复固件显示错误
    • 正确解读 RouterBOARD 固件字段
    • upgrade-firmware → 当前运行的固件 ✅
    • current-firmware → 出厂预装版本
  • 📋 添加设备型号和序列号显示
  • 📊 优化状态输出格式

v1.8.1 (2026-03-06)

  • 📶 新增无线客户端查询（CAPsMAN）
    • 查看已连接的无线客户端
    • 显示 MAC、SSID、信号强度、速率
    • 显示连接时间、IP 地址、流量统计
    • 信号强度星级评级（⭐⭐⭐⭐⭐）
  • 🔍 支持命令：客户端/无线/wifi/client

v1.8.0 (2026-03-06)

  • 🎯 新用户开局优化
    • 交互式配置流程
    • 扫描 → 选择 → 测试 → 保存 → 验证
    • 修复设备名称匹配正则
    • 扫描功能完全独立
  • 📝 更新 README.md 开局示例

v1.7.0 (2026-03-06)

  • 🔍 优化网络扫描功能
    • 完全独立扫描，不依赖 API 配置
    • 自动排除本机 IP
    • 支持多网段扫描

v1.6.0 (2026-03-06)

  • 🆕 新增网络扫描功能（类似 Winbox）
  • 🆕 支持广播报文监听发现设备
  • 🆕 支持邻居发现、ARP 表、网关多来源扫描
  • 🆕 显示设备 MAC、IP、型号、版本信息
  • 🆕 智能去重（基于 MAC 地址）

v1.5.0 (2026-03-06) [已推送]

  • 🆕 新增高级路由功能查看（OSPF、BGP）
  • 🆕 新增系统健康监控（温度、电压、风扇）
  • 🆕 新增计划任务查看
  • 🆕 新增邻居设备发现
  • 🆕 新增活动连接统计
  • 🆕 新增 Ping 测试功能
  • 🆕 智能温度告警（>70°C🔥, >50°C⚠️）

v1.4.0 (2026-03-06)

  • 🆕 新增队列/带宽限制查看（Simple Queues）
  • 🆕 新增队列树配置查看
  • 🆕 新增队列类型显示
  • 🆕 带宽单位自动转换（Mbps/Gbps）

v1.3.0 (2026-03-06)

  • 🆕 新增接口流量统计（接收/发送字节数、包数、错误/丢弃）
  • 🆕 新增接口详细信息查看
  • 🆕 新增 VLAN 配置查看
  • 🆕 新增桥接配置和端口列表
  • 🆕 流量单位自动转换（B/KB/MB/GB）

v1.2.0 (2026-03-06)

  • 🆕 新增 DHCP 配置查看（租约、服务器）
  • 🆕 新增 ARP 表查看
  • 🆕 新增 WireGuard 对等体状态
  • 🆕 新增用户配置（系统用户、PPP 用户）
  • 🆕 新增系统日志查看
  • 🆕 新增系统服务查看（API、SSH、WWW 等）

v1.1.0 (2026-03-06)

  • ✅ 修复凭证配置：支持 TOOLS.md 和环境变量
  • ✅ 修复响应解析：完整支持多条目返回
  • ✅ 改进连接可靠性：改用非阻塞模式 + select 超时
  • ✅ 增强错误提示：友好的配置缺失提示

v1.0.0 (2026-03-05)

  • 初始版本

作者

虾哥 🤖

Version tags

latestvk97btwzf61pf64v7et0gf7ywmn82k9wk