mikrotik

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

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "mikrotik" with this command: npx skills add 2944721178/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)

  • 初始版本

作者

虾哥 🤖

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open Registry RecordOpen in ClawHub

Related Skills

Related by shared tags or category signals.

General

Zip

Zip - command-line tool for everyday use

Registry SourceRecently Updated
210xueyetianya
General

Youtube Script

YouTube视频脚本、标题A/B测试、缩略图文案、SEO优化、开头Hook、章节标记。YouTube script writer with title testing, thumbnail copy, SEO optimization, hooks, chapter markers. Use when you...

Registry SourceRecently Updated
1760ckchzh
General

Topmediai AI Music Generator

Generate AI music, BGM, or lyrics via TopMediai API. Supports auto polling and two-stage output (preview first, then final full audio) for generation tasks.

Registry SourceRecently Updated
00Topmediai
General

Yamlcheck

YAML validator and formatter. Validate YAML syntax, pretty-print with proper indentation, convert between YAML and JSON, and lint YAML files for common issues.

Registry SourceRecently Updated
770bytesagain1