Changer le thème

Guide complet du contrôle à distance OpenClaw : transformez votre téléphone en télécommande de votre OS IA personnel

Easton editorial illustration: MCP trust and permission gateway

Au café, une urgence : un PDF sur le bureau du PC à la maison. Je sors le téléphone et envoie à « ClawBot » sur Telegram : « Fais une capture du bureau ». Dix secondes plus tard, la capture arrive — le PDF est bien là. Puis : « Ouvre ce fichier et résume la page 3 ». Deux minutes après, le résumé de la page 3.

Franchement, ce genre de scène est devenu banal pour moi ces six derniers mois. Depuis qu’OpenClaw est mon système d’exploitation IA personnel, mon iPhone est une vraie « télécommande » — caméra du PC à la maison, localisation, capture d’écran à distance. Le tout via des outils open source, les données restant chez moi.

Si vous voulez que le téléphone soit le vrai poste de pilotage de votre agent IA, sans rester coincé dans l’écosystème du fabricant, ce guide contrôle à distance OpenClaw est pour vous. Pas de théorie creuse : on configure.

Guide économique « élever la homard » : ArkClaw démocratise l’agent IA

OpenClaw (homard) est puissant mais la config rebute ? ArkClaw de ByteDance Volcano Engine abaisse la barrière : pas de serveur ni de Token à bricoler, un « assistant IA » 24 h/24 en un clic — navigateur, scripts, calendrier.

Le prix compte : 9,9 ¥/mois ; avec le code d’invitation ZLKUK54M (inscription ici) 8,9 ¥. Développeurs : Coding Plan Pro peut offrir l’accès.

Comprendre le protocole Gateway OpenClaw (couche 1 — bases)

Pour piloter OpenClaw depuis le téléphone, il faut d’abord voir comment le système tourne. Le « protocole Gateway » n’est qu’un vocabulaire de connexion entre appareils.

OpenClaw utilise le Gateway WS Protocol (protocole WebSocket Gateway). Tous les appareils — poste principal sur PC, nœud mobile, interface Telegram — partagent un plan de contrôle via une connexion WebSocket persistante. Chaque appareil annonce son rôle et ses capacités à la connexion.

Exemple : l’iPhone dit « je suis un nœud iOS, caméra, capture d’écran, localisation ». Le PC dit « je suis la Gateway, je coordonne ». Le Bot Telegram dit « je suis client, je reçois vos ordres ».

Trois rôles à retenir :

Gateway : le « cerveau », en général sur PC ou serveur. Les commandes y arrivent d’abord, puis sont routées vers les nœuds.

Node : l’appareil qui exécute. iPhone, Android, vieux téléphone — chacun déclare ses caps : camera, screen, location, voice, etc.

Client : l’interface de commande — Telegram, Discord, app iOS ou Web.

Sécurité ? C’était ma première inquiétude. OpenClaw combine authentification Token, signature appareil, TLS, et contrôle fin : le nœud peut déclarer la caméra, la Gateway peut n’autoriser que la capture d’écran pour un client donné.

[Image : schéma d’architecture du protocole Gateway OpenClaw, relations Gateway, Node, Client]
Prompt : diagramme d’architecture technique, Gateway centrale reliée à plusieurs appareils iOS et Android, style tech bleu, épuré, high quality

En configuration, un extrait JSON typique :

{
  "role": "node",
  "caps": ["camera", "screen", "location"],
  "commands": ["camera.snap", "screen.record", "location.get"],
  "permissions": {
    "camera.capture": true,
    "screen.record": false
  }
}

Le nœud annonce photo, capture, localisation ; l’usage effectif dépend des permissions Gateway. Même en cas de compromission, la surface reste limitée.

Configuration pratique du nœud mobile (couche 2 — avancé)

Configuration iOS

OpenClaw n’est pas sur l’App Store : TestFlight (si accès bêta) ou IPA signé (j’utilise AltStore, re-signature mensuelle).

Après installation, l’écran de configuration du nœud :

Gateway URL : adresse WebSocket. En LAN : ws://192.168.1.100:8080. Pour l’extérieur : reverse proxy en wss:// — j’utilise Cloudflare Tunnel sans exposer l’IP publique.

Client ID : nom du nœud, ex. iphone-15-main.

Auth Token : jeton généré côté Gateway.

Capabilities : cocher les capacités. Au premier essai, seulement location, puis camera et screen une fois stable.

Connexion réussie si l’état affiche « Connected » en vert.

Piège iOS : les apps en arrière-plan sont tuées. Activer « Actualisation en arrière-plan » ou rouvrir l’app de temps en temps. Je laisse le nœud sur un téléphone de secours.

Configuration Android

Plus souple : APK officiel ou Node dans Termux.

APK : comme iOS. Arrière-plan plus tolérant, mais sur ROM chinoises (Huawei, Xiaomi, OPPO) autoriser manuellement l’exécution en arrière-plan.

Termux : npm install openclaw, logs détaillés, mais même problème de kill — Termux:Boot, Tasker pour la persistance.

[Image : capture Termux Android, nœud OpenClaw connecté]
Prompt : capture écran mobile, terminal Termux avec logs de connexion réussie OpenClaw, mode sombre, texte vert, high quality

Règle commune : moindre privilège. Pas besoin de caméra ? Ne l’activez pas. Signature appareil : clé publique sur Gateway, privée sur nœud — Token seul ne suffit pas. Ma Gateway exige la signature.

Pilotage via Telegram

Le moyen le plus direct : Telegram. Pas d’app en plus, ouvrir Telegram suffit.

Créer un Bot via @BotFather, récupérer le Token, ajouter le plugin Telegram dans channels, redémarrer la Gateway.

channels:
  telegram:
    token: "YOUR_BOT_TOKEN"
    mode: polling

polling est le plus simple en personnel. webhook demande HTTPS public, mais répond plus vite.

Pour le contrôle matériel à distance, lier des commandes aux capacités du nœud dans skills :

skills:
  remote_control:
    commands:
      camera:
        target: "iphone-15-main"
        action: "camera.snap"
      screenshot:
        target: "iphone-15-main"
        action: "screen.capture"
      where:
        target: "iphone-15-main"
        action: "location.get"

/camera déclenche une photo sur l’iPhone indiqué ; /where renvoie les coordonnées GPS.

La première photo reçue depuis la maison reste mémorable — un assistant toujours disponible, entièrement à vous.

[Image : conversation Telegram, commande /camera et photo retournée]
Prompt : capture interface Telegram, utilisateur envoie /camera, bot renvoie la photo, style mobile, high quality

Telegram gère aussi les groupes : Bot dans un groupe solo pour l’historique, ou partage familial avec permissions strictes (évitez les captures nocturnes non désirées).

Envoyer image ou document au Bot permet analyse ou enregistrement — sorte de « presse-papiers multi-appareils ».

Application dédiée et scénarios avancés

Telegram ne couvre pas tout : aperçu caméra rapide, tableau de bord de tous les nœuds. Là intervient l’UI Web officielle sur http://localhost:3000. Par défaut local uniquement ; Nginx + HTTP Basic Auth pour l’accès mobile.

Des panneaux tiers (ex. ClawDash) existent — évaluer la sécurité avant de connecter votre Gateway.

Workflows automatisés

OpenClaw déclenche des skills sur événements. Exemple : géorepérage — entrée dans « maison » → le Mac lance la musique. Ou capture planifiée à 8 h sur un Android de secours, analyse IA, alerte Telegram si anomalie.

automations:
  - name: "arrive_home"
    trigger:
      type: "geofence"
      device: "iphone-15-main"
      location: "home"
    action:
      target: "macbook-pro"
      skill: "music.play"
  - name: "morning_check"
    trigger:
      type: "schedule"
      cron: "0 8 * * *"
    action:
      target: "android-spare"
      skill: "screen.analyze"

Dépannage

Connexion Gateway impossible : URL WebSocket, port, curl de test ; pour wss, certificat valide.

Nœud hors ligne alors que l’app est connectée : vérifier role: "node", pas "client".

Commande sans effet : logs Gateway, ID d’appareil correct.

Permission refusée : aligner permissions du nœud et politique Gateway — contrôle bilatéral.

Conclusion

En résumé :

  1. Le Gateway Protocol unifie téléphone et PC sur un même plan de contrôle — WebSocket, rôles et capacités déclarés simplement.

  2. En nœud, le téléphone devient capteur et exécuteur : caméra, GPS, écran — invoquables par votre agent IA.

  3. Telegram ou app dédiée pour commander votre système IA depuis n’importe où — données et décisions chez vous, pas dans un cloud « assistant intelligent ».

Ce soir, prenez un téléphone de rechange et suivez le chapitre 2. Même une simple « photo à distance » change la perception : vous avez des yeux partout.

La communauté fait évoluer OpenClaw en continu. Aujourd’hui c’est la couche 2 matérielle ; demain, peut-être plus encore.

Pour l’instant, mon téléphone n’est plus seulement un téléphone — c’est la télécommande de mon OS IA. Le vôtre peut l’être aussi.

Configuration complète d'un nœud mobile OpenClaw

Étapes détaillées pour configurer un appareil iOS ou Android comme nœud OpenClaw, connexion Gateway, permissions et contrôle via Telegram Bot

⏱️ Estimated time: 30 min

  1. 1

    Step 1: Préparation : installer l'application nœud OpenClaw

    Utilisateurs iOS :
    • Installer le client OpenClaw iOS via TestFlight ou signature AltStore
    • Activer « Actualisation en arrière-plan » pour garder le nœud en ligne

    Utilisateurs Android :
    • Option A : installer l'APK officiel, autoriser l'exécution en arrière-plan
    • Option B : dans Termux, exécuter npm install openclaw

    Note : un téléphone de secours convient mieux pour un nœud permanent ; le téléphone principal peut être limité par les restrictions d'arrière-plan
  2. 2

    Step 2: Configurer les paramètres de connexion du nœud

    Champs essentiels :
    • Gateway URL : ws://IP-LAN:port ou wss://domaine-public
    • Client ID : identifiant unique, ex. « iphone-15-main »
    • Auth Token : jeton d'authentification généré par la Gateway
    • Capabilities : cocher selon les besoins location/camera/screen

    Recommandations de sécurité :
    • Générer d'abord une paire de clés appareil, clé publique sur la Gateway, clé privée sur le nœud
    • N'ouvrir que location au premier test, puis les autres permissions
    • Principe du moindre privilège : surface d'attaque minimale
  3. 3

    Step 3: Configurer le contrôle via Telegram Bot

    Créer le Bot :
    • Contacter @BotFather sur Telegram, exécuter /newbot
    • Conserver le Bot Token obtenu

    Configurer OpenClaw :
    • Ajouter le plugin telegram dans la config channels
    • mode : polling (usage personnel) ou webhook (réponse plus rapide)
    • Dans skills, lier les commandes aux capacités du nœud, ex. /camera → camera.snap

    Commandes de test :
    • /camera - photo à distance
    • /where - obtenir la position
    • /screenshot - capture d'écran
  4. 4

    Step 4: Avancé : configurer des workflows automatisés

    Déclenchement par géorepérage :
    • Exécuter automatiquement des skills à l'entrée/sortie d'une zone
    • Exemple : lancer la musique en arrivant à la maison

    Tâches planifiées :
    • Utiliser des expressions cron pour des déclenchements horaires
    • Exemple : capture d'écran chaque matin à 8 h pour vérification

    Dépannage :
    • Impossible de joindre la Gateway : vérifier l'adresse WebSocket et le certificat TLS
    • Nœud hors ligne : confirmer que role vaut « node » et non « client »
    • Commande sans réponse : consulter les logs Gateway pour le routage

FAQ

Quel niveau technique pour configurer un nœud OpenClaw ?
Exigences modestes :
• Maîtriser les bases de la ligne de commande
• Comprendre WebSocket et l'authentification par Token
• Savoir éditer un fichier yaml

Sur iOS, familiarité avec TestFlight ou l'installation par signature. Sur Android avec Termux, notions Linux de base. En général, un profil développeur peut terminer en 30 minutes.
Un téléphone en nœud consomme-t-il beaucoup de batterie ?
Cela dépend de la configuration :
• location seule : consommation très faible, quasi imperceptible
• camera et screen : consommation uniquement à l'usage
• Connexion WebSocket longue : heartbeat très léger

Conseil : téléphone de secours dédié, ou activer le nœud seulement quand nécessaire. Sur iOS, attention aux limites d'arrière-plan ; sur Android, désactiver l'agressivité d'économie d'énergie du ROM.
Le contrôle à distance OpenClaw est-il sûr ?
Conception orientée sécurité :
• Authentification Token obligatoire à la connexion
• Signature appareil : clés asymétriques contre l'usurpation après fuite de Token
• Chiffrement TLS : wss pour l'accès externe
• Permissions fines : le nœud déclare les caps, la Gateway contrôle les appels clients
• Déploiement local : données sans serveur tiers

Bonnes pratiques : signature appareil obligatoire + moindre privilège + rotation régulière des Tokens.
Telegram Bot ou application dédiée : lequel choisir ?
Chacun a ses avantages :

Telegram Bot :
• Plus : pas d'app supplémentaire, disponible partout, partage en groupe
• Moins : interface de chat moins intuitive pour des opérations complexes

App dédiée / Web UI :
• Plus : interface visuelle, déclenchement en un clic, état des nœuds
• Moins : reverse proxy pour l'accès externe, parfois une app de plus

Conseil : Telegram suffit au quotidien ; Web UI pour les scénarios complexes ou fréquents.
Outre le téléphone, quels appareils peut-on contrôler ?
En théorie tout appareil capable d'exécuter OpenClaw :
• Ordinateurs (macOS/Windows/Linux) : Gateway principale ou autre nœud
• Raspberry Pi : faible consommation, idéal en continu
• Android TV / box : piloter le centre média domestique
• Anciens téléphones/tablettes : nœuds de surveillance dédiés

Prérequis : Node.js ou client OpenClaw, et WebSocket. La communauté étend progressivement les types d'appareils supportés.

6 min de lecture · Publié le: 26 févr. 2026 · Mis à jour le: 27 juil. 2026

Commentaires

Connectez-vous avec GitHub pour laisser un commentaire

Easton BlogEaston Blog