Unraid CLI (ucli) pour Openclaw

Une CLI TypeScript haute performance pour gérer les serveurs Unraid via la GraphQL API, conçue pour les opérateurs humains et les agents IA.

ingodibella
v0.4.0
Apr 1, 2026
0
907
0

Installer & Télécharger

1. ClawHub CLI

Le moyen le plus rapide d'installer une compétence directement depuis le registre.

npx clawhub@latest install unraid-cli

2. Installation manuelle

Copiez le dossier de la compétence dans l'un de ces emplacements

Global
~/.openclaw/skills/
Espace de travail
<project>/skills/

Priorité : Espace de travail > Local > Intégré

3. Installation du prompt

Copiez ce prompt dans OpenClaw pour l'installer automatiquement.

Aide-moi à installer unraid-cli via Clawhub. Si Clawhub n'est pas installé, installe-le d'abord (npm i -g clawhub).

Vous préférez télécharger ?

Obtenez les fichiers bruts de la compétence dans une archive ZIP.

Qu'est-ce que Unraid CLI (ucli) ?

Unraid CLI (ucli) fournit une interface robuste pour interagir avec les serveurs Unraid via leur GraphQL API. En tant que partie intégrante de l'écosystème Openclaw Skills, elle permet une gestion à distance fluide des composants du serveur, y compris les baies de disques, les conteneurs Docker, les machines virtuelles et les journaux système. Elle est conçue pour donner la priorité à la lisibilité par machine et à l'efficacité du développeur, ce qui en fait un choix idéal pour l'automatisation et l'orchestration de serveurs pilotée par l'IA.

Cet outil comble le fossé entre la gestion manuelle via Web UI et les flux de travail automatisés. En tirant parti d'Openclaw Skills comme ucli, les développeurs et les passionnés de homelab peuvent scripter des tâches complexes de maintenance de serveur ou fournir aux agents IA les outils nécessaires pour surveiller et réparer l'infrastructure serveur de manière autonome.

Cas d'utilisation de Unraid CLI (ucli)

  • Surveillance de la santé du système et de l'état de la baie via des scripts automatisés.
  • Gestion du cycle de vie des conteneurs Docker et des machines virtuelles.
  • Récupération et analyse des journaux système pour le dépannage.
  • Orchestration d'environnements multi-serveurs à l'aide de commandes CLI standardisées.
  • Fourniture d'une interface structurée aux agents IA pour effectuer des diagnostics de serveur.

Comment fonctionne Unraid CLI (ucli)

  1. L'utilisateur ou l'agent appelle la commande ucli avec un groupe fonctionnel spécifique tel que system, array ou containers.
  2. La CLI s'authentifie auprès du serveur Unraid à l'aide d'une API key configurée et d'une host URL fournies via des variables d'environnement ou un fichier de configuration.
  3. Une GraphQL query ou mutation est envoyée à l'API endpoint du serveur pour récupérer des données ou effectuer une action.
  4. Le serveur traite la requête et renvoie des données structurées, que la CLI formate en JSON pour garantir la compatibilité avec les flux de travail Openclaw Skills.
  5. L'agent ou l'utilisateur analyse la sortie pour vérifier l'action ou récupérer les informations système nécessaires pour les étapes d'automatisation ultérieures.

Configuration de Unraid CLI (ucli)

Installez le package via npm :

npm install -g unraid-cli

Configurez vos variables d'environnement pour permettre à la CLI de communiquer avec votre serveur :

export UNRAID_HOST="http://your-server-ip:7777"
export UNRAID_API_KEY="your_api_key"

Alternativement, vous pouvez créer un fichier de configuration dans ~/ .config/ucli/config.yaml pour des profils d'environnement stables.

Schéma de données et taxonomie de Unraid CLI (ucli)

L'outil utilise une hiérarchie de commandes structurée organisée en groupes fonctionnels. Le schéma de sortie est optimisé pour la lisibilité par machine lorsqu'il est utilisé avec Openclaw Skills.

Group Description
system Informations sur la santé, le statut, les ressources et la disponibilité.
array Gestion de la parité, des périphériques et de l'état de la baie.
disks Données SMART, températures et inventaire des disques.
containers Gestion du cycle de vie, journaux et statistiques pour Docker.
vms Inspection et contrôle des machines virtuelles.
shares Détails des partages de stockage et métriques d'utilisation.
logs Accès aux journaux système, tail et recherche.

Fonctionnalités avancées de Unraid CLI (ucli)

  • Prise en charge native de la sortie JSON pour une intégration fluide avec les pipelines de machine learning et Openclaw Skills.
  • Capacités avancées de filtrage et de tri pour façonner les données avant qu'elles n'atteignent le contexte de l'agent.
  • Prise en charge multi-profil pour gérer plusieurs environnements Unraid à partir d'une seule interface.
  • Sélection granulaire des champs pour optimiser les payloads et économiser les jetons de fenêtre de contexte.
  • Outils de diagnostic complets, y compris les tests de latence et les contrôles de santé de l'environnement.

SKILL.md


Chargement

Compétences Openclaw associées

METADATA

Github Stars: 0
forks: 0

En vedette*