← Back to Skills Marketplace
2944721178

Mikrotik

by wukefenggao · GitHub ↗ · v1.8.5 · MIT-0
cross-platform ✓ Security Clean
539
Downloads
0
Stars
4
Active Installs
5
Versions
Install in OpenClaw
/install mikrotik
Description
通过 API 连接和管理 MikroTik RouterOS 设备。支持查看设备状态、防火墙规则、网络配置,执行自定义 RouterOS 命令。
Usage Guidance
This skill appears to do what it claims (manage MikroTik devices and scan the local network), but it performs active network scanning and may attempt default/empty-password logins and write device info to ~/.openclaw/workspace/TOOLS.md. Before installing or running it: (1) get explicit permission from your network administrator; (2) avoid saving plaintext credentials in TOOLS.md — use environment variables or a secrets manager; (3) test in an isolated lab network first to see scanning behavior and resource use; (4) review the code that may perform writes to your workspace if you need to prevent credential persistence. If you need, I can point to the exact places in the code that perform scans, subprocess calls, login attempts, and any file writes so you can audit or modify them.
Capability Analysis
Type: OpenClaw Skill Name: mikrotik Version: 1.8.5 The MikroTik skill bundle is a comprehensive administrative tool for managing RouterOS devices via the MikroTik API. It includes functionality for monitoring system health, managing firewall rules, and performing network discovery. While the skill utilizes high-risk capabilities such as local network scanning via `subprocess` (in `scanner.py`) and credential retrieval from `TOOLS.md` (in `handler.py`), these behaviors are explicitly documented, aligned with the stated purpose, and include appropriate security warnings for the user. No evidence of intentional data exfiltration, unauthorized remote access, or malicious prompt injection was found.
Capability Assessment
Purpose & Capability
Name and description match the code and instructions: the package implements a MikroTik RouterOS API client, common command wrappers, CLI, and a network scanner. The requested capabilities (reading TOOLS.md, optional env vars, opening sockets to devices, and issuing RouterOS commands including admin-level operations) are coherent with a router management skill.
Instruction Scope
SKILL.md and the code direct the agent to perform active LAN operations: enumerate local subnets, run system commands ('ip', 'hostname', 'ip neigh'), scan many IPs for open API ports (8728/8729), and attempt connections (including trying empty-password 'admin' logins for info). The instructions also describe interactive flows that save credentials to ~/.openclaw/workspace/TOOLS.md. These behaviors are within the skill's purpose but are intrusive on a network and can trigger security alerts; they require explicit operator approval and careful credential handling.
Install Mechanism
No install spec is present (no external downloads or installers). The package is delivered as code files in the skill bundle; nothing in the manifest indicates fetching arbitrary third-party archives or running remote installers. This is lower-risk from an install-mechanism perspective.
Credentials
The registry metadata lists no required env vars, but the code and SKILL.md read and recommend MIKROTIK_HOST / MIKROTIK_USER / MIKROTIK_PASS and also parse ~/.openclaw/workspace/TOOLS.md for credentials. Those environment variables are appropriate and expected for the stated purpose, but the mismatch with the declared registry requirements is an inconsistency. The skill also recommends storing credentials in TOOLS.md (plaintext) which is insecure — the doc warns about it but still promotes that option.
Persistence & Privilege
always:false and normal autonomous invocation apply. The skill can persist device info/credentials into the user's workspace TOOLS.md (per SKILL.md/README statements), which is a modest persistence within the user's OpenClaw workspace and not a system-wide privilege escalation. Users should be aware credentials may be written locally if they follow the interactive setup.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install mikrotik
  3. After installation, invoke the skill by name or use /mikrotik
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.8.5
v1.8.5 (2026-03-09) 🚀 - 🔍 重构网络扫描:改用 API 端口扫描 - ⚡ 50 线程并发,自动获取设备信息 - 🔧 修复 login() 逻辑错误 - ⚠️ 添加安全警告和使用建议
v1.8.4
v1.8.4: 新增备份配置、存储清理、API 配置查看功能,整合临时脚本
v1.8.3
修复 RouterBOARD 固件显示错误
v1.8.2
v1.8.2 - 更新 handler.py,优化功能或修复细节 - 其它文档和功能保持不变
v1.8.1
Version 1.8.1 - 完善 SKILL.md 文档,详细说明所有核心功能及用法,覆盖设备状态、防火墙、接口、流量、DHCP、ARP、VLAN、桥接、路由、日志等多项管理与查询能力 - 明确配置方法,支持 TOOLS.md 和环境变量双重配置,详述优先级与密码格式 - 增加多设备管理说明,覆盖命令场景、依赖和常见注意事项 - 优化示例响应和常见问题补充,提升易用性和上手体验 - 该版本为文档完善与用法梳理,未涉及核心功能更新
Metadata
Slug mikrotik
Version 1.8.5
License MIT-0
All-time Installs 4
Active Installs 4
Total Versions 5
Frequently Asked Questions

What is Mikrotik?

通过 API 连接和管理 MikroTik RouterOS 设备。支持查看设备状态、防火墙规则、网络配置,执行自定义 RouterOS 命令。 It is an AI Agent Skill for Claude Code / OpenClaw, with 539 downloads so far.

How do I install Mikrotik?

Run "/install mikrotik" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Mikrotik free?

Yes, Mikrotik is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Mikrotik support?

Mikrotik is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Mikrotik?

It is built and maintained by wukefenggao (@2944721178); the current version is v1.8.5.

💬 Comments