MikroTik RouterOS 技能

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

功能

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

配置

方式一：TOOLS.md（推荐）

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

markdown

MikroTik 设备

• - office: 192.168.1.1, admin, 空密码
• home: 192.168.88.1, admin, yourpassword
• branch: 192.168.2.1, admin, complexpassword123

密码格式说明：

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

方式二：环境变量

bash
export MIKROTIK_HOST=192.168.1.1
export MIKROTIK_USER=admin
export MIKROTIK_PASS= # 空密码

或

优先级：环境变量 > 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. 1. 网络扫描风险

1. 2. 凭据安全

1. 3. 本地命令与权限

📋 使用建议

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

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

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

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

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

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

🔧 部署前检查清单

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

更新日志

v1.8.5 (2026-03-09) 🚀

• - 🔍 重构网络扫描功能 - 改用 API 端口扫描方式