Un client HTTP Node.js léger et sans dépendance pour effectuer des requêtes API résilientes avec tentatives automatiques et gestion gracieuse des erreurs.
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 simplehttpskill
2. Installation manuelle
Copiez le dossier de la compétence dans l'un de ces emplacements
~/.openclaw/skills/ <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 simplehttpskill 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 Simple HTTP ?
La compétence Simple HTTP est un utilitaire haute performance conçu pour que les agents d'IA interagissent avec les services web et les API. Construit nativement sur les modules Node.js, ce composant Openclaw Skills permet des opérations GET, POST, PUT et DELETE fluides sans la surcharge de bibliothèques externes. Il est conçu pour la fiabilité, avec un support intégré pour les en-têtes personnalisés et la sérialisation automatique des charges utiles, ce qui en fait un outil essentiel pour les agents devant récupérer ou envoyer des données sur le web.
En exploitant les modules natifs http et https de Node.js, cette compétence assure une empreinte minimale et une compatibilité élevée sur différents environnements. Elle simplifie la complexité de la gestion des requêtes en fournissant une interface unifiée qui gère avec élégance les erreurs réseau et les codes d'état HTTP spécifiques.
Cas d'utilisation de Simple HTTP
- Récupération de données à partir d'APIs RESTful pour le traitement et la prise de décision des agents.
- Envoi de webhooks en temps réel et de notifications d'événements à des services tiers.
- Interaction avec des microservices cloud pour déclencher des flux de travail externes.
- Automatisation des tâches de récupération de données nécessitant une gestion robuste des erreurs et des tentatives automatiques.
Comment fonctionne Simple HTTP
- L'utilisateur instancie le HttpClient, en définissant éventuellement des paramètres globaux tels que les en-têtes de base, les délais d'expiration et le nombre maximal de tentatives.
- Une requête est initiée en utilisant une méthode HTTP spécifique (GET, POST, etc.) et une URL cible.
- La compétence sérialise automatiquement les corps de requête basés sur des objets en JSON et définit les en-têtes appropriés.
- Si une erreur transitoire survient, telle qu'un délai d'expiration de connexion, une limite de débit (429) ou une erreur de serveur (5xx), la compétence applique une stratégie de backoff exponentiel avec gigue.
- Une fois les tentatives terminées ou épuisées, la compétence renvoie un objet de réponse standardisé contenant le code d'état, les en-têtes et le corps analysé pour inspection.
Configuration de Simple HTTP
Pour utiliser cet outil dans le cadre d'Openclaw Skills, assurez-vous que les fichiers sources sont disponibles dans votre projet. Vous pouvez initialiser et utiliser le client comme indiqué ci-dessous :
const { HttpClient } = require("./src/http-client");
const client = new HttpClient({
defaultHeaders: { "Authorization": "Bearer YOUR_TOKEN" },
maxRetries: 3
});
Aucune installation npm externe n'est requise car la compétence dépend uniquement des modules intégrés de Node.js.
Schéma de données et taxonomie de Simple HTTP
Toutes les requêtes renvoient un objet de réponse cohérent pour simplifier la logique de l'agent :
| Clé | Type | Description |
|---|---|---|
ok |
boolean | Vrai si le code d'état HTTP est dans la plage 2xx |
status |
number | null | Le code d'état HTTP numérique, ou null pour les erreurs réseau |
headers |
object | Paires clé-valeur des en-têtes de réponse |
body |
any | La charge utile de la réponse, automatiquement analysée si le contenu est du JSON |
error |
string | null | Un message d'erreur descriptif si la requête a échoué |
Fonctionnalités avancées de Simple HTTP
- Backoff exponentiel intégré avec gigue pour atténuer la limitation de débit et l'instabilité transitoire du serveur.
- Architecture sans dépendance utilisant uniquement les modules de base de Node.js pour une sécurité et une vitesse maximales.
- Sérialisation JSON automatique pour les corps de requête et analyse intelligente des données de réponse.
- Modèle de gestion des erreurs sans exception qui garantit un contrôle de flux prévisible pour les agents d'IA en renvoyant toujours un objet de réponse.
SKILL.md
Chargement
Compétences Openclaw associées
Permissions Broker
Un proxy axé sur la sécurité qui permet aux agents IA d'accéder à des API tierces et à des dépôts Git via des approbations humaines (human-in-the-loop) sur Telegram.
Open Wallet
Un pont permettant aux agents d'IA de générer des liens partageables qui permettent aux utilisateurs d'exécuter en toute sécurité des transactions blockchain ou de signer des messages en utilisant leurs propres portefeuilles.
Linear
Intégrez la gestion de projet Linear dans votre flux de travail d'agent pour automatiser le suivi des tickets, la gestion des notifications et la synchronisation d'équipe.
agentmail-cli
Une interface en ligne de commande pour l'API AgentMail afin de gérer les boîtes de réception jetables et d'automatiser la communication par e-mail.
Paper Parse
Un outil d'analyse académique sophistiqué qui génère à la fois des rapports techniques approfondis et des résumés logiques concis pour tout article scientifique.
Compétence Build Session
Un cadre de productivité qui transforme le temps d'inactivité des agents autonomes en sessions structurées pour construire, rechercher et livrer du code.
En vedette*
