FRITZ!Box

核心功能：管理FRITZ!Box路由器（WLAN开关、联网设备查询、网络重连、路由器信息）及FRITZ!DECT智能家居设备（设备列表、智能插头开关）。典型场景：关闭WLAN、查看联网设备、控制智能插座等。输入为命令行指令或触发短语，输出为设备状态、列表等文本信息。需FRITZ!Box在本地网络，配置认证信息，高影响操作需用户确认。

first-it-consulting

热度 33.54

最近更新 2026-05-11 17:46:58

分类：自动化依赖：代码执行 / 第三方 API应用场景：自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add fritzbox

Metadata

name: fritzbox
description: Control AVM FRITZ!Box routers and Smarthome devices via TR-064 and Web API. Use when the user wants to manage their FRITZ!Box router (WLAN, connected devices, reconnect) or control FRITZ!DECT smarthome devices (smart plugs, thermostats). Triggers on phrases like "fritzbox", "fritz box", "router", "wlan", "wifi", "smarthome", "dect", "smart plug", "steckdose".
metadata: {"clawdbot":{"emoji":"📡","requires":{"bins":["python3"],"env":["FRITZBOX_PASSWORD","FRITZBOX_HOST"]},"primaryEnv":"FRITZBOX_HOST"}}

FRITZ!Box Skill

Control your AVM FRITZ!Box router and Smarthome devices.

When to Use

✅ USE this skill when:

"Turn WLAN/WiFi on/off"
"List connected devices"
"Show router info"
"Reconnect internet"
"List smarthome devices"
"Switch smart plug on/off"
"Check who's on the network"

❌ DON'T use this skill when:

Non-AVM routers
Advanced firewall configuration
Firmware updates

⚠️ Confirmation Required

The following commands make high-impact, hard-to-reverse changes to the network or connected devices. Always ask the user for explicit confirmation before running them:

Command	Impact
`wlan off` / `wlan on`	Disables or enables Wi-Fi — may cut network access
`reconnect`	Forces internet disconnection and re-dial
`smarthome switch <ain> off` / `on`	Turns a physical device on or off
`smarthome toggle <ain>`	Inverts the current device state

Only invoke these after the user has clearly and explicitly requested the specific action.

Prerequisites

FRITZ!Box must be accessible on the local network
For router functions: TR-064 must be enabled
For smarthome: DECT devices must be paired

Authentication

Option 1: .env File (Recommended)

Create a .env file:

FRITZBOX_USER=your_username
FRITZBOX_PASSWORD=your_password
FRITZBOX_HOST=fritz.box

Option 2: Command Line

python3 fritzbox.py --user admin --password YOURPASS wlan status

Common Commands

Router Control

# Router info
python3 fritzbox.py info

# WLAN on/off/status
python3 fritzbox.py wlan on
python3 fritzbox.py wlan off
python3 fritzbox.py wlan status

# List connected network devices
python3 fritzbox.py hosts

# Reconnect internet
python3 fritzbox.py reconnect

Smarthome Control

# List all smarthome devices
python3 fritzbox.py smarthome list

# Switch device on/off (AIN with spaces needs quotes!)
python3 fritzbox.py smarthome switch "08761 0311726" on
python3 fritzbox.py smarthome switch "08761 0311726" off

Note: The AIN (identifier) is shown in the device list. Use quotes if it contains spaces!

Smarthome Device Output

FRITZ!Smart Energy 200 #1
  AIN: 08761 0311726
  State: ON, Power: 84.4W, Voltage: 237.3V, Temp: 20.5°C

Troubleshooting

"401 Unauthorized":

Check credentials in .env
Ensure user exists in FRITZ!Box

"No smarthome devices found":

Check DECT devices are paired
Verify device is within range

Switch command fails:

Always use quotes around AIN: "08761 0311726"
Check device is present (green DECT icon in FRITZ!Box UI)

Custom Host

If your FRITZ!Box is on a different IP:

python3 fritzbox.py --host 192.168.178.1 info

API Used

TR-064 - Router functions (WLAN, hosts, device info)
Homeautoswitch API - Smarthome device control

Security Guidance

Least privilege: Create a dedicated FRITZ!Box user with limited permissions for agent use rather than using the admin account.
Protect credentials: Keep .env outside version control (it is listed in .gitignore). Restrict file permissions: chmod 600 .env.
Verify the host: Ensure FRITZBOX_HOST points to your own local router. Do not route credentials through untrusted hosts.
Scope of access: The configured account can authorize all router and smarthome changes supported by this skill. Treat the credentials with the same care as router admin credentials.