mikrotik

# MikroTik RouterOS Skill

通过 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, complex_password_123
```

**密码格式说明**：
- 空密码：写 `空密码`、`无密码`、`none` 或留空
- 有密码：直接写密码字符串

### 方式二：环境变量

```bash
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 RouterOS Skill for OpenClaw

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

## 功能

- ✅ 查看设备状态（系统信息、CPU、内存、存储）
- ✅ 查看防火墙规则（filter、NAT、mangle）
- ✅ 查看网络配置（接口、IP 地址、路由、DNS）
- ✅ 执行自定义 RouterOS 命令
- ✅ 支持多设备连接
- ✅ 网络扫描（类似 Winbox，无需配置）
- ✅ 交互式开局流程

## 🚀 快速开始（新用户开局）

### 方式一：交互式开局（推荐）

**1. 说出口令**：
```
mikrotik 开局
```

**2. AI 自动扫描**：
```
📡 扫描完成！发现 3 个设备:

[1] 192.168.1.10 (00:0C:42:AA:BB:CC)
[2] 192.168.1.20 (4C:5E:0C:DD:EE:FF)
[3] 192.168.1.1 (D4:CA:6D:11:22:33)
```

**3. 告诉 AI 账号密码**：
```
全部使用 admin/空密码
```

**4. AI 测试连接并保存**：
```
✅ 连接成功！配置已保存到 TOOLS.md
```

**5. 开始使用**：
```
查看 device1 状态
mikrotik office firewall
```

### 方式二：手动配置

在 `~/.openclaw/workspace/TOOLS.md` 中添加：

```markdown
### MikroTik 设备
- **office**: 192.168.1.1, admin, 空密码
- **home**: 192.168.88.1, admin, yourpassword
```

## 安装

### 方法 1: 手动安装（当前可用）

```bash
# 克隆仓库
git clone https://github.com/YOUR_USERNAME/openclaw-mikrotik-skill.git
cd openclaw-mikrotik-skill

# 复制到 OpenClaw skills 目录
cp -r mikrotik /usr/lib/node_modules/openclaw/skills/

# 重启 OpenClaw Gateway
openclaw gateway restart
```

### 方法 2: 通过 ClawHub（即将上线）

```bash
# 待发布到 ClawHub 后可用
npx clawhub install mikrotik
```



## 配置

在 `TOOLS.md` 中添加 MikroTik 设备信息：

```markdown
### MikroTik 设备

- **office**: 192.168.1.1, admin, 空密码
- **home**: 192.168.88.1, admin, yourpassword
```

## 用法

### 自然语言命令

```
查看 mikrotik 设备状态
mikrotik 防火墙配置
检查路由器运行情况
查看网络接口
查看无线客户端
mikrotik office 客户端
mikrotik ap wifi
在 mikrotik 上执行 /system/resource/print
```

### 可用命令

| 命令 | 说明 |
|------|------|
| `状态` / `status` | 查看设备状态（CPU、内存、运行时间） |
| `防火墙` / `firewall` | 查看防火墙规则（filter、NAT） |
| `接口` / `interface` | 查...