0
0
# Install this skill:
npx skills add ChristiaanRossouw/openclaw-unifi

Or install specific skill: npx add-skill https://github.com/ChristiaanRossouw/openclaw-unifi

# Description

Control UniFi Network - manage clients, block devices, and monitor signals.

# SKILL.md


name: unifi
description: Control UniFi Network - manage clients, block devices, and monitor signals.
metadata: {"clara":{"emoji":"🏰","requires":{"bins":["php"],"env":["UNIFI_USER","UNIFI_PASS","UNIFI_URL"]}}}


UniFi Network Control

Manage your UniFi network directly.

Setup

  1. Install PHP and Composer.
  2. Set environment variables:
  3. UNIFI_URL: Controller URL (e.g., https://192.168.1.1)
  4. UNIFI_USER: Local username
  5. UNIFI_PASS: Local password
  6. UNIFI_SITE: Site ID (usually default)
  7. Install dependencies:
    bash cd skills/unifi && composer install

Commands

List Clients

Returns active clients on the network.

php skills/unifi/bridge.php list_clients

List Devices

Returns status of UniFi Access Points and Switches.

php skills/unifi/bridge.php list_devices

Block / Unblock Client

Put a device on digital time-out.

php skills/unifi/bridge.php block <MAC_ADDRESS>
php skills/unifi/bridge.php unblock <MAC_ADDRESS>

Set Client Note

Label your devices for easier identification.

php skills/unifi/bridge.php set_note <USER_ID> "My Note"

Safety Note

Be careful when blocking devices or toggling WLANs; you might disconnect the host machine running Clara!

# README.md

openclaw-unifi

A UniFi Network Control skill for OpenClaw.

Description

This skill allows OpenClaw agents to manage UniFi networks directly. It uses the UniFi API Client (Art-of-WiFi) as a bridge to communicate with your UniFi controller.

Features

  • List active and historical wireless/wired clients.
  • Monitor device signals and data usage.
  • Block/Unblock clients (digital time-out).
  • Set client notes/aliases.
  • Map out UniFi devices (APs, Switches).

Setup

  1. PHP & Composer: Ensure PHP 8.x and Composer are installed on your host system.
  2. UniFi Credentials: Create a local admin user in your UniFi controller (e.g., openclaw).
  3. Environment Variables:
  4. UNIFI_URL: Your controller URL (e.g., https://192.168.1.1)
  5. UNIFI_USER: The local username created.
  6. UNIFI_PASS: The local password.
  7. UNIFI_SITE: Site ID (defaults to default).

Installation

mkdir -p skills/unifi
# Download skill files to this directory
cd skills/unifi
composer install

Safety Note

Be careful when using commands that modify network state (like blocking). Ensure you do not block the machine running OpenClaw!

Credits

Built as a collaboration between Christiaan (@Romans5Verse8) and Clara (the sassy AI). 💅✨

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.