返回顶部
F

Fritz ConnectionFritz连接

Dieser Skill ermöglicht die Abfrage von Statusinformationen und die Steuerung einer AVM FRITZ!Box über die TR-064 Schnittstelle. Er bietet Funktionen für Status (Modell, Uptime), Traffic (Bandbreite, Volumen), Host-Listen, WLAN-Steuerung, Anruflisten sowie Reconnect und Reboot.

作者: admin | 来源: ClawHub
源自
ClawHub
版本
V 1.0.0
安全检测
已通过
153
下载量
免费
免费
0
收藏
概述
安装方式
版本历史

Fritz Connection

Fritz Connection

通过 fritzconnection 库,利用 TR-064 API 获取 FritzBox 路由器状态。

⚠️ 安全提示

以下命令在执行前必须征得用户确认:

  • - reconnect – 短暂中断所有设备的互联网连接(10-30 秒)
  • reboot – 重启路由器,所有服务中断(互联网、WLAN、电话)2-5 分钟
  • wlan on/off – 系统级影响所有设备
  • 修改路由器配置 – 可能影响所有设备

例外情况: 仅在获得明确许可时(开始吧、好的,请等)

这些命令不仅影响当前用户,还会影响网络中的所有设备和人员。

前提条件

bash
cd ~/.openclaw/workspace/skills/fritz-status
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

配置

在 ~/.openclaw/skills/.env 文件中:

FRITZBOX_HOST=192.168.178.1
FRITZBOX_PASSWORD=你的密码

注意:FritzBox 仅使用密码认证,无需用户名。

使用方法

bash
cd ~/.openclaw/workspace/skills/fritz-status

路由器状态(型号、运行时间、WAN IP)

.venv/bin/python scripts/fritz_status.py status

流量统计(接收/发送字节数、下行/上行速率)

.venv/bin/python scripts/fritz_status.py traffic

已连接设备(名称、IP、MAC、状态)

.venv/bin/python scripts/fritz_status.py hosts -v

WLAN 状态(2.4GHz、5GHz、访客网络)

.venv/bin/python scripts/fritz_status.py wlan

通话记录(最近 10 条)

.venv/bin/python scripts/fritz_status.py calls

通话记录(最近 20 条)

.venv/bin/python scripts/fritz_status.py calls -n 20

重新连接(获取新 IP)⚠️ 需要确认!

.venv/bin/python scripts/fritz_status.py reconnect

重启(重启路由器)⚠️ 需要确认!

.venv/bin/python scripts/fritz_status.py reboot

可用命令

status

路由器状态和连接信息。

输出:

🖥️ AVM FRITZ!Box 6660 Cable
📍 主机:192.168.178.1
🔌 连接状态:已连接
⏱️ 运行时间:456789 秒(126 小时 49 分钟)
🌐 外部 IP:203.0.113.42

traffic

带宽和数据流量。

输出:

📥 最大下行速率:274 Mbit/s
📤 最大上行速率:52 Mbit/s
📊 总接收数据:299.68 GB
📊 总发送数据:20.34 GB

hosts

所有已知设备及其状态。

输出:

📱 已连接设备:5 台

✅ 智能手机 (192.168.178.10, AA:BB:CC:DD:EE:01)
✅ 笔记本电脑 (192.168.178.20, AA:BB:CC:DD:EE:02)
✅ fritz.box (192.168.178.1, AA:BB:CC:DD:EE:03)
⏸️ 平板电脑 (192.168.178.30, AA:BB:CC:DD:EE:04)
⏸️ 智能电视 (192.168.178.40, AA:BB:CC:DD:EE:05)

图例: ✅ = 在线,⏸️ = 离线/未激活

wlan

所有网络的 WLAN 状态(2.4 GHz、5 GHz、访客网络)。

输出:

📡 WLAN 状态

📶 2.4 GHz:
状态:✅ 已启用
SSID:MeinWLAN
信道:6
标准:ax

📡 5 GHz:
状态:✅ 已启用
SSID:MeinWLAN
信道:36
标准:ax

🏠 访客网络:
状态:❌ 已禁用
SSID:MeinWLAN Gast

📡 WLAN 已开启

WLAN 网络:

  • - 📶 2.4 GHz – 主网络(WLANConfiguration:1)
  • 📡 5 GHz – 主网络(WLANConfiguration:2)
  • 🏠 访客网络 – 访客 WLAN(WLANConfiguration:3)

calls

通话记录,包含类型、号码和时间戳。

输出:

📋 通话记录(10 条)

📞 来电
📞 01234567890
🕐 03.03.2026 18:54 (0:39)

📵 未接来电
📞 09876543210
🕐 02.03.2026 15:30 (0:00)

📱 去电
📞 017000000000
🕐 01.03.2026 12:15 (2:30)

📌 最近通话:📞 来电 来自 01234567890 于 03.03.26 18:54

选项:

  • - -n, --limit N - 条目数量(默认:10)

通话类型:

  • - 📞 来电(类型 1)- 已接听的来电
  • 📵 未接来电(类型 2)- 未接听的来电
  • 📱 去电(类型 3)- 拨出的电话

reconnect

强制重新连接并获取新的外部 IP。

bash
.venv/bin/python scripts/fritz_status.py reconnect

输出:

🔄 已请求重新连接。正在等待新连接...

⚠️ 系统级操作:

  • - 短暂中断所有设备的互联网连接
  • 分配新的外部 IP
  • 通常需要 10-30 秒
  • 未经确认切勿执行!

reboot

重启 FRITZ!Box。

bash
.venv/bin/python scripts/fritz_status.py reboot

输出:

🔄 已请求重启。FRITZ!Box 正在重启。
⏱️ 通常需要 2-5 分钟。
📡 所有设备将断开连接(互联网、WLAN、电话)。

⚠️ 系统级操作:

  • - 中断所有连接(互联网、WLAN、电话)2-5 分钟
  • 网络中所有设备断开连接
  • 路由器完全重启
  • 未经确认切勿执行!

fritzconnection 库

用于 FritzBox TR-064 API 的 Python 库。

文档: https://fritzconnection.readthedocs.io/

两个 API 接口

fritzconnection 使用两个不同的 API

API方法用途
TR-064fc.callaction(service, action, args)网络、状态、配置、智能家居
AHA-HTTP
fc.callhttp(command, ain) | 智能家居 DECT、设备统计、XML 响应 |

TR-064 返回 Python 数据类型(包含转换后值的字典)。
HTTP 接口 返回原始 HTTP 响应(text/plain 或 text/xml,通常需要解析)。

基本用法

python
from fritzconnection import FritzConnection

fc = FritzConnection(address=192.168.178.1, password=pw)

路由器信息

print(fc) # 型号信息

TR-064:通过重新连接获取新 IP

fc.call_action(WANIPConn1, ForceTermination) fc.reconnect() # 上述操作的快捷方式

HTTP:获取智能家居设备统计

response = fc.call_http(getbasicdevicestats, ain=12345 7891011)

主要服务(TR-064)

服务描述状态
WANIPConnectionWAN 状态、IP、运行时间、重新连接✅ 已实现
WANCommonInterfaceConfig
流量统计、带宽 | ✅ 已实现 | | Hosts | 已连接设备、MAC 过滤 | ✅ 已实现 | | DeviceInfo | 型号、固件、序列号 | ✅ 已实现 | | XAVM-DEOnTel | 通话记录、电话簿 | ✅ 已实现 | | WLANConfiguration | WLAN 网络、访客 WLAN | ✅ 已实现 | | DeviceConfig | 路由器重启 | ✅ 已实现 | | X_AVM-DE

标签

skill ai

通过对话安装

该技能支持在以下平台通过对话安装:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 fritz-connection-1776359525 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 fritz-connection-1776359525 技能

通过命令行安装

skillhub install fritz-connection-1776359525

下载

⬇ 下载 Fritz Connection v1.0.0(免费)

文件大小: 10.04 KB | 发布时间: 2026-4-17 14:53

v1.0.0 最新 2026-4-17 14:53
Initial release of Fritz Connection skill for AVM FRITZ!Box TR-064 interface.

- Query and control Fritz!Box routers: model, uptime, bandwidth, connected devices, WLAN state, call lists, reconnect, and reboot.
- Strong safety warnings and required confirmations for critical operations (reconnect, reboot, WLAN toggles).
- Simple CLI usage with documented commands and example outputs for all major features.
- Setup and configuration instructions included.
- Based on the Python fritzconnection library; extension and customization examples provided.

Archiver·手机版·闲社网·闲社论坛·羊毛社区· 多链控股集团有限公司 · 苏ICP备2025199260号-1

Powered by Discuz! X5.0   © 2024-2025 闲社网·线报更新论坛·羊毛分享社区·http://xianshe.com

p2p_official_large
返回顶部