Openclaw Skills transforme les serveurs d'IA en agents découvrables et persistants grâce à des flux de travail d'enregistrement, d'acceptation et de handshake en une seule commande.
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 agent-handshake
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 agent-handshake 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 Agent Handshake ?
Openclaw Skills fournit une couche de handshake standardisée pour les agents d'IA : un serveur publie son identité, le côté local la valide et la stocke, et les futures connexions peuvent être initiées avec une seule commande. Il est conçu pour des piles hétérogènes telles que OpenCode, LangChain, CrewAI, les services génériques FastAPI et les points de terminaison MCP, faisant d'Openclaw Skills une couche pratique de découverte et de connexion pour les flottes d'agents mixtes.
En combinant l'enregistrement côté serveur, la persistance locale sous references\/servers\/ et la prise en charge optionnelle de Cloudflare Quick Tunnel, Openclaw Skills vous permet de vous connecter à des agents sur un LAN, derrière un NAT ou sur un VPS sans perdre le fil de la machine avec laquelle vous communiquez. Le résultat est un flux de travail CLI reproductible qui ajoute de la mémoire, de l'identité et de la traçabilité aux transferts d'agent à agent et d'humain à agent.
Cas d'utilisation de Agent Handshake
- Lorsqu'un utilisateur demande d'effectuer un handshake, de se connecter ou de découvrir un serveur OpenCode depuis la CLI.
- Lorsqu'une nouvelle instance CLI de OpenCode est installée et doit être enregistrée dans la mémoire locale.
- Lorsque vous devez identifier exactement à quel NAS, hôte cloud ou machine LAN vous vous connectez.
- Lorsqu'un serveur se trouve derrière un NAT ou un pare-feu et a besoin d'un Cloudflare Quick Tunnel pour un accès public temporaire.
- Lorsque vous souhaitez une exécution distante de type SSH sur un VPS via HTTP au lieu d'ouvrir le port 22.
- Lorsque Openclaw Skills doit maintenir un inventaire persistant des serveurs d'IA connus pour des handshakes rapides et une automatisation reproductible.
Comment fonctionne Agent Handshake
- Le serveur exécute
register.shpour collecter le nom d'hôte, l'OS, l'architecture, le matériel, le port, le point de terminaison de santé, le type d'agent et l'empreinte digitale SSH. register.shgénère un JSON d'identité de machine sousreferences\/servers\/<hostname>.jsonet confirme que l'agent est accessible.- La machine locale reçoit cette identité par copie,
accept.shou un tunnel, puis valide la santé et l'accessibilité. accept.shpersiste l'enregistrement du serveur localement, met à jourreferences\/servers\/_index.jsonet stocke la meilleure adresse connue dans~\/.agent-handshake.discover.shanalyse le réseau et fait correspondre les identités connues afin d'indiquer précisément à l'utilisateur quelle machine est disponible.handshake.sh autosélectionne l'URL la plus appropriée, affiche la bannière du serveur, ouvre la session et renvoie le résultat de la tâche.- Pour les scénarios NAT ou VPS,
tunnel.shoudeploy.shétend le flux de travail avec Cloudflare Quick Tunnel ou l'exécution de tâches à distance basée sur HTTP.
Configuration de Agent Handshake
- Installez la CLI OpenCode sur n'importe quel serveur qui exposera OpenCode Serve, ou assurez-vous que votre agent FastAPI ou MCP dispose déjà d'un point de terminaison
\/health. - Placez le répertoire Openclaw Skills sur la machine locale et sur chaque serveur qui va s'enregistrer.
- Enregistrez l'identité du serveur depuis le côté serveur :
chmod +x scripts\/*.sh
bash scripts\/register.sh
bash scripts\/register.sh opencode
- Acceptez le serveur localement et persistez-le :
bash scripts\/accept.sh lvliefeng http:\/\/192.168.5.2:4096
- Si le serveur est derrière un NAT, démarrez d'abord un tunnel, puis acceptez l'URL du tunnel :
bash scripts\/tunnel.sh start
bash scripts\/accept.sh lvliefeng https:\/\/random-name.trycloudflare.com
- Configuration facultative de OpenCode Serve :
export OPENCODE_AUTH='opencode:opencode123'
export OPENCODE_PORT='4096'
export OPENCODE_PROVIDER='zen'
export OPENCODE_MODEL='deepseek-v4-flash-free'
- Pour les déploiements VPS, amorcez le shell de l'agent HTTP :
bash scripts\/deploy.sh 4096 user:pass
- Vérifiez le handshake de bout en bout avec une connexion automatique :
bash scripts\/handshake.sh auto 'list NAS docker projects'
Schéma de données et taxonomie de Agent Handshake
Openclaw Skills stocke l'identité du serveur et l'état de découverte sous forme d'enregistrements JSON durables, avec un fichier par hôte et un inventaire indexé.
| Path | Generated by | Purpose | Key contents |
|---|---|---|---|
references\/servers\/<hostname>.json |
register.sh and accept.sh |
Enregistrement d'identité persistant par serveur | hostname, agent_type, protocol, OS, kernel, arch, CPU, memory, disk, LAN IPs, public IP, agent version, port, SSH fingerprint, tunnel URL, generated timestamp |
references\/servers\/_index.json |
accept.sh |
Registre global de tous les serveurs connus | servers map, total count, quick lookup keys |
~\/.agent-handshake |
accept.sh |
Mémoire au niveau de l'utilisateur pour les points de terminaison préférés ou les derniers connus | canonical URL, selected LAN or tunnel address, auth hints, local defaults |
Taxonomie des métadonnées
- Identity: hostname, OS, kernel, architecture
- Agent: agent_type, agent version, protocol, exposed endpoints
- Network: LAN IPs, public IP, port, tunnel URL
- Hardware: CPU model, memory size, disk capacity
- Security: SSH fingerprint, auth mode, Basic Auth secret reference
- Lifecycle: generation time, last accepted time, health status
Valeurs agent_type prises en charge
opencodelangchaincrewaigeneric-fastapigenericmcp
Règles de correspondance de protocole
opencodeutiliseGET \/global\/healthet le flux de session via\/sessionlangchainetcrewaiexposent généralementGET \/healthetPOST \/chatgeneric-fastapiest découvert viaGET \/healthplus\/docsou\/openapi.jsongenericest accepté pour tout agent HTTP qui renvoie une charge utile JSON de santé validemcpest suivi via son point de terminaison MCP et son chemin de découverte de santé
Ce schéma permet à Openclaw Skills de se souvenir exactement de quelle machine il s'agit, même lorsque plusieurs serveurs d'IA partagent le même réseau local.
Fonctionnalités avancées de Agent Handshake
- Détection automatique du type d'agent parmi
opencode,langchain,crewai,generic-fastapi,genericetmcp. - Prise en charge de Cloudflare Quick Tunnel pour la traversée NAT, HTTPS temporaire sans compte et accès distant rapide.
handshake.sh autochoisit automatiquement le meilleur type d'adresse disponible et affiche une bannière d'identité du serveur avant de se connecter.- Mémoire persistante via
references\/servers\/_index.jsonet~\/.agent-handshake, de sorte que Openclaw Skills se souvient de chaque serveur enregistré. - Exécution à distance de type SSH sur VPS avec
agent_shell.pyet\/runvia l'authentification HTTP Basic Auth. - Vérification de la santé sensible au protocole à l'aide de
\/global\/health,\/health,\/openapi.jsonet des chemins de découverte MCP. - Déploiement léger pouvant installer un service systemd et démarrer automatiquement au démarrage.
- La découverte, l'enregistrement et le transfert de session sont regroupés dans un seul flux de travail natif CLI pour les configurations multi-serveurs de Openclaw Skills.
SKILL.md
Chargement
Compétences Openclaw associées
Agent Deployment Kit
Une méthodologie structurée pour répliquer une configuration d'AI Agent sur plusieurs clients à l'aide d'une source de contexte unique et d'un générateur strict basé sur des barrières de validation.
Canvora Visual Generation Skill
Canvora est un utilitaire piloté par CLI qui convertit du texte brut, des URLs web et des documents en visuels marketing de haute qualité conformes à la charte graphique et en présentations structurées.
Tristan RFQ Overseer
Tristan RFQ Overseer transforme les RFQ entrantes en ébauches de devis tarifés, comparés et soumis à approbation, avec un état sauvegardé dans un coffre (vault).
UI Master Static
Directives de Openclaw Skills pour concevoir des interfaces professionnelles avec du CSS natif, BEM, des mises en page modernes et des animations soignées.
Novelty Validator
Un outil de vérification de recherche académique qui extrait des affirmations des comptes rendus de réunions et valide leur nouveauté par rapport à une base de données de 1,2 milliard de documents.
Répétition de Soutenance Académique
Un flux de travail (workflow) Openclaw Skills qui répète les soutenances académiques de bout en bout avec des jurys fictifs, des analyses de points faibles de la littérature et des comptes rendus de présentation.
En vedette*
