MikroTik RouterOS 技能

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

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

功能

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

配置

选项 1：TOOLS.md（推荐）

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

MikroTik 设备

• office: 192.168.88.1, admin, 空密码

密码格式说明：

• 空密码：可填写 empty password、no password、none，或留空
• 非空密码：直接写入密码字符串

选项 2：环境变量

export MIKROTIK_HOST=192.168.88.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 租约

📡 ARP 表

• 显示 ARP 表
• 显示 ARP 缓存

🔐 WireGuard

• 显示 WireGuard 配置
• 显示 VPN 对等体（peers）

👤 用户

• 显示用户配置
• 显示 PPP 用户

📝 日志

• 显示系统日志
• 显示最近日志

🔧 服务

• 显示系统服务
• 显示 API/SSH 端口

💾 备份配置

• 备份配置
• 备份路由器配置

🧹 清理存储

• 清理存储
• 检查可删除文件

🔐 API 配置

• 配置 API 访问权限
• 显示 API 服务配置

📈 流量统计

• 显示接口流量
• 显示流量统计信息

🔌 接口详情

• 显示接口详情
• 显示 ether1 详情

🏷️ VLAN

• 显示 VLAN 配置
• 显示 VLAN 列表

🌉 Bridge（桥接）

• 显示桥接配置
• 显示桥接端口

📊 队列 / 带宽

• 显示队列配置
• 显示带宽限制
• 显示速率限制规则

🌐 路由

• 显示路由配置
• 显示 OSPF 状态
• 显示 BGP 对等体（peers）

🌡️ 系统健康状态

• 显示系统健康状态
• 显示温度 / 电压 / 风扇状态

📅 计划任务

• 显示计划任务
• 显示 cron 任务

📡 邻居发现

• 显示邻居设备
• 显示网络设备发现结果

🔗 活跃连接

• 显示活跃连接
• 显示连接统计信息

🏓 Ping 测试

• 在 mikrotik 上 ping 8.8.8.8

📡 网络扫描

• 扫描本地网络
• 扫描 192.168.1.0/24
• 查找 MikroTik 设备

🎯 自定义命令

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

🖥️ 多设备支持

若已配置多个设备，可在命令中指定设备名称：

• 显示 server-room mikrotik 状态
• 显示 home 防火墙规则

依赖项

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

文件结构

├── SKILL.md # 技能描述（本文件）
├── handler.py # 命令处理器
└── mikrotik-api/ # API 客户端库
├── init.py
├── client.py # API 客户端
├── commands.py # 命令封装器
├── cli.py # CLI 工具
└── scanner.py # 网络扫描器

注意事项

⚠️ 安全警告

1. 网络扫描风险

   • mikrotik scan 将主动扫描本地子网，生成网络发现流量。
   • 可能在生产网络中触发安全告警。
   • 建议：仅在隔离/测试网络中运行，或事先获得网络管理员授权。

2. 凭据安全

   • ❌ 切勿 在公开或未加密的 TOOLS.md 文件中以明文形式保存路由器管理员密码。
   • ✅ 推荐方式：使用环境变量（MIKROTIK_HOST/MIKROTIK_USER/MIKROTIK_PASS）。
   • ✅ 推荐方式：为短期会话使用临时凭据，并在使用后立即删除。

3. 本地命令与权限

   • scanner.py 使用 subprocess 调用系统命令（ip/hostname）。
   • 需打开 UDP 套接字以执行网络扫描。
   • 请确保：当前运行环境允许执行上述操作。

更新日志

v1.8.6（2026-03-30）

• 将整个技能完整翻译为英文（原始作者：Xiage）。
• 更新署名及维护者信息。

v1.8.5（2026-03-09）

• 🔍 重构网络扫描逻辑 —— 改为基于 API 端口的扫描方式。
• 📊 优化扫描结果输出。
• 🔧 更新 scanner.py。

v1.8.4（2026-03-08）

• 💾 新增配置备份功能。
• 🧹 新增存储清理功能。
• 🔐 新增 API 配置查看功能。

v1.8.2（2026-03-06）

• 🔧 修复固件版本显示异常问题。
• 📋 新增设备型号与序列号显示。
• 📶 新增无线客户端查询功能（CAPsMAN）。
• 🎯 优化新用户入门体验。
• 🔍 优化网络扫描性能。
• 🆕 新增 Winbox 风格的网络扫描功能。