Comment configurer Office Claws : guide complet etape par etape

Comment configurer Office Claws : guide complet etape par etape — Apprenez a configurer Office Claws et a deployer un agent IA securise sur votre propre VPS Contabo en quelques minutes. Installation du CLI, abonnement, identifiants Contabo et Tailscale, provisionnement, connexion de Codex et securite automatisee inclus.
15 avr. 202615 min de lecture
Share with

Gerer des agents IA implique generalement de jongler entre des fenetres de terminal, des sessions SSH et des fichiers de configuration eparpilles. Office Claws remplace tout cela par un seul CLI — plus une application de bureau avec un bureau en pixel art ou chaque agent est assis a son propre poste. Chaque agent tourne sur un VPS de votre propre compte Contabo et communique avec votre ordinateur via votre propre reseau Tailscale. Ce guide vous accompagne a travers chaque etape de la configuration — de l'installation du CLI jusqu'a votre premiere conversation avec votre agent.

Ce dont vous avez besoin avant de commencer

Rassemblez les elements suivants avant de commencer. Avoir tout sous la main permet de boucler la configuration en quelques minutes.

Comptes et identifiants

  • Un abonnement Office Claws. Il existe un seul forfait, Self-Hosted, a 4,99 $/mois. Un abonnement actif est requis avant de provisionner un agent — vous vous abonnez depuis le CLI a l'etape 2.
  • Un compte Contabo avec un VPS. Votre agent tourne sur un VPS de votre propre compte Contabo, que vous payez directement a Contabo — un petit VPS coute quelques euros par mois. Commandez le VPS chez Contabo avant de lancer l'onboarding. Office Claws fait tourner un agent par VPS.
  • Des identifiants API Contabo. Ouvrez my.contabo.com/api/details et notez votre Client ID et votre Client secret (sous "API Data"), votre API user (l'email de connexion Contabo) et votre API password. Le mot de passe API n'est pas votre mot de passe de connexion au site — si vous n'en avez jamais defini, cliquez sur "Set password" sur cette page.
  • Un compte Tailscale et une cle d'authentification. Tailscale cree le reseau chiffre entre votre ordinateur et le VPS de votre agent. Creez un compte gratuit sur tailscale.com, puis generez une cle d'authentification dans la console d'administration sous Settings > Keys > Generate auth key.
  • Un abonnement ChatGPT avec Codex. Votre agent tourne sur votre propre abonnement OpenAI Codex (ChatGPT), que vous connectez via une connexion dans le navigateur a l'etape 5. Aucune cle API n'est necessaire.
  • Un ordinateur sous macOS ou Linux, avec Tailscale installe et connecte. Le CLI joint vos agents via votre tailnet.

Lancez votre premier agent en 3 minutes environ

Installez la CLI Office Claws, connectez votre compte Contabo et votre abonnement Codex : votre agent obtient son propre VPS et un bureau dans l'office.

curl -fsSL https://officeclaws.com/downloads/install.sh | sh

4,99 $/mois + votre propre VPS Contabo · les clés restent dans votre trousseau

Comment fonctionne la tarification

Office Claws propose un seul forfait : Self-Hosted, 4,99 $/mois. Il inclut le CLI, l'application de bureau et son bureau en pixel art, le chat en temps reel avec les agents, les logs, les taches planifiees et les canaux comme Telegram. L'infrastructure reste la votre : le VPS se trouve dans votre compte Contabo et est facture par Contabo, et le modele tourne sur votre propre abonnement Codex.

Il n'y a pas d'essai gratuit — un abonnement actif est requis avant le provisionnement. Les remboursements sont regis par notre Politique de remboursement.

Setup flow: Download, Register, Configure, Provision, Chat

Etape 1 : Installer le CLI

Installez le CLI officeclaws avec une seule commande :

curl -fsSL https://officeclaws.com/downloads/install.sh | sh

Lancez officeclaws version pour verifier qu'il est bien dans votre PATH. Vous preferez une interface graphique ? L'application de bureau avec le bureau en pixel art est disponible sur la page d'accueil et fonctionne avec le meme compte et les memes agents.

Etape 2 : Creer votre compte et vous abonner

officeclaws register    # ou : officeclaws login
officeclaws subscribe

register cree votre compte Office Claws avec un email et un mot de passe ; utilisez login si vous en avez deja un. subscribe ouvre le paiement dans votre navigateur (s'il ne peut pas ouvrir de navigateur, il affiche le lien a copier). Une fois le paiement effectue, votre compte peut provisionner des agents.

Etape 3 : Faire l'onboarding de votre premier agent

officeclaws onboard --name Mona

L'onboarding est interactif. Il :

  1. Verifie que votre abonnement est actif. Si ce n'est pas le cas, il vous renvoie vers officeclaws subscribe.
  2. Demande vos quatre identifiants API Contabo et les valide. Ils sont enregistres dans le trousseau de votre systeme d'exploitation, vous ne les saisissez donc qu'une fois.
  3. Demande votre cle d'authentification Tailscale, elle aussi enregistree dans le trousseau.
  4. Cree une cle SSH que le CLI utilise pour joindre vos agents.
  5. Synchronise les VPS de votre compte Contabo et vous laisse choisir celui qui deviendra un agent.

Si vous omettez --name, l'onboarding vous le demande. Deux options facultatives personnalisent l'agent : --comm-style friendly|business|creative definit son ton, et --avatar choisit l'un des 12 avatars en pixel art affiches dans le bureau de l'application. Chaque question a aussi son option (--contabo-client-id, --tailscale-authkey, --vps, etc.), si bien que l'onboarding peut tourner de facon entierement non interactive — officeclaws help les liste toutes.

Etape 4 : Suivre le provisionnement

Une fois le VPS choisi, Office Claws le provisionne et affiche la progression directement dans votre terminal pendant qu'il :

  1. Installe l'agent a partir d'une image Office Claws preconstruite.
  2. Rattache le VPS a votre reseau Tailscale.
  3. Durcit le serveur et demarre le runtime de l'agent dans Docker.
  4. Configure la passerelle de l'agent, joignable uniquement via votre tailnet.

L'ensemble du processus prend environ 2 a 3 minutes. L'image contient deja tout ce dont l'agent a besoin, le serveur n'installe donc aucun paquet de zero — c'est ce qui garde le provisionnement rapide. A la fin, le CLI affiche vos deux prochaines commandes.

Si le VPS contient deja des donnees que vous voulez remplacer, --reinstall l'efface et le reinstalle a partir de l'image Office Claws. Ne l'utilisez que sur un serveur que vous acceptez d'effacer.

Etape 5 : Connecter votre abonnement Codex

officeclaws connect-codex

Cette commande ouvre la page de connexion d'OpenAI dans votre navigateur (ou affiche le lien). Connectez-vous avec le compte ChatGPT qui dispose de Codex ; le CLI attend que vous ayez termine (jusqu'a cinq minutes) et confirme quand votre agent tourne sur votre abonnement. Codex est la voie de modele prise en charge pour les agents Office Claws — Claude Code et les autres abonnements Anthropic ne sont pas pris en charge.

Etape 6 : Commencer a discuter avec votre agent

officeclaws chat

Cette commande ouvre un chat interactif avec votre agent principal (Ctrl-D pour quitter). Utilisez officeclaws chat -m "..." pour un message ponctuel, --agent <id> pour parler a un agent precis, officeclaws agents pour lister vos agents et officeclaws logs --follow pour suivre les logs d'un agent.

Essayez ces premiers messages pour tester votre configuration :

  • "En quoi peux-tu m'aider ?"
  • "Resume ce document pour moi : [coller le texte]"
  • "Verifie ce code a la recherche de bugs : [coller le code]"

Dans l'application de bureau, le meme agent apparait a un bureau dans l'espace en pixel art — cliquez sur son sprite pour ouvrir le panneau de chat, qui conserve tout l'historique pour reprendre la conversation la ou vous l'aviez laissee.

Comprendre le bureau en pixel art

Si vous utilisez l'application de bureau, le bureau n'est pas qu'un gadget visuel. Il vous offre un apercu instantane de l'etat de tous vos agents :

Agent states: Typing, Coffee, Resting, Offline

  • En train de taper a un bureau — L'agent traite activement une requete ou est disponible.
  • En train de prendre un cafe — L'agent est dans un bref cycle d'inactivite.
  • En train de se reposer sur le canape — L'agent est dans un etat d'inactivite prolonge.
  • Assis dans la zone hors ligne — Le VPS de l'agent est injoignable.

A mesure que vous ajoutez des agents, chacun se voit attribuer un bureau dans l'office. La disposition prend en charge jusqu'a six bureaux dans la salle principale, un bureau dans le petit bureau lateral et des sieges dans les espaces detente.

Comment vos identifiants restent securises

La securite est une preoccupation courante quand un outil touche a vos comptes cloud et IA. Voici comment Office Claws s'en occupe :

  1. Stockage dans le trousseau local. Vos identifiants API Contabo, votre cle d'authentification Tailscale et votre session CLI sont stockes dans le trousseau de votre systeme d'exploitation, pas sur les serveurs d'Office Claws. Les valeurs secretes ne sont jamais affichees — les listes ne montrent que des apercus masques.
  2. Votre propre reseau. Le CLI et l'application de bureau joignent votre agent en SSH via votre reseau Tailscale. Les ports SSH, HTTPS et de la passerelle de l'agent ne sont ouverts que sur votre tailnet.
  3. Votre propre abonnement. La connexion de Codex passe par le flux de connexion d'OpenAI : vous vous connectez sur la page d'OpenAI, et aucune cle API ne circule. La session qui en resulte reside sur le VPS de votre agent.
  4. Connexion directe. Le chat et les logs circulent directement entre votre ordinateur et votre agent via votre tailnet. Une fois officeclaws connect-codex lance, les requetes au modele vont du VPS de votre agent directement vers OpenAI ; avant cela, une petite allocation de depart passe par la passerelle LLM d'Office Claws. Office Claws conserve une copie de votre historique de chat dans votre compte ; la page securite detaille exactement ce qui est stocke.

Ce qu'Office Claws automatise : la configuration manuelle que vous evitez

Pour comprendre la valeur d'un provisionnement en une seule commande, il est utile de voir a quoi ressemble la configuration d'un VPS securise pour agent IA sans lui. Voici chaque etape qu'Office Claws gere automatiquement en coulisses. Si vous le faisiez vous-meme, prevoyez 45 minutes a une heure de travail en terminal par serveur — a condition de reussir chaque commande du premier coup.

Creer le serveur et y acceder

Manuellement, vous vous connecteriez a votre fournisseur cloud (Contabo, Hetzner, DigitalOcean ou un autre), creeriez un serveur Ubuntu 24.04, attendriez son demarrage et vous y connecteriez en SSH en tant que root. Il faut aussi generer une paire de cles SSH, televerser la cle publique et confirmer que la connexion fonctionne.

Creer un utilisateur non-root

Faire tourner des services en tant que root est un risque de securite. Vous devriez creer un utilisateur dedie, l'ajouter au groupe sudo, copier votre cle publique SSH dans son fichier authorized_keys et definir les permissions correctes (700 pour le repertoire .ssh, 600 pour le fichier de cle). Ensuite, configurer l'acces sudo sans mot de passe pour des commandes specifiques — pare-feu, Tailscale et Docker — afin que le processus de l'agent puisse gerer ces services sans privileges root complets.

Durcir SSH

Par defaut, SSH sur un serveur Ubuntu fraichement installe autorise la connexion root et l'authentification par mot de passe — deux vecteurs d'attaque courants. Vous devez ecrire une configuration de durcissement qui desactive tous ces elements :

  • Connexion root (PermitRootLogin no)
  • Authentification par mot de passe (PasswordAuthentication no)
  • Authentification challenge-response
  • X11 forwarding
  • Agent forwarding

Ensuite, validez la syntaxe de la configuration avec sshd -t et redemarrez le service SSH. Une seule faute de frappe dans ce fichier et vous vous verrouillez hors du serveur.

Installer et configurer le pare-feu

Ensuite, installez ufw (Uncomplicated Firewall) et definissez une politique par defaut de refus de tout le trafic entrant. Vous autorisez temporairement SSH sur toutes les interfaces pour ne pas perdre votre connexion, puis — une fois Tailscale en marche — vous restreignez SSH, HTTPS et le port de la passerelle agent (18789) a l'interface Tailscale uniquement et supprimez la regle SSH publique. L'etat final du pare-feu :

  • Tout le trafic entrant refuse par defaut
  • Port 22 (SSH) : autorise uniquement via Tailscale
  • Port 443 (HTTPS) : autorise uniquement via Tailscale
  • Port 18789 (passerelle agent) : autorise uniquement via Tailscale
  • Tout le trafic sortant autorise

Se tromper dans l'ordre des operations ici — restreindre SSH avant que Tailscale ne soit actif — signifie perdre completement l'acces au serveur.

Mettre en place la prevention d'intrusion

Installez et activez fail2ban, qui surveille les journaux d'authentification et bannit temporairement les adresses IP presentant des schemas de connexion par force brute. Cela ajoute une couche de defense meme si SSH venait a etre expose suite a une mauvaise configuration.

Activer les mises a jour de securite automatiques

Installez unattended-upgrades et apt-listchanges, puis configurez-les avec dpkg-reconfigure. Cela garantit que le serveur applique automatiquement les correctifs de securite sans intervention manuelle. Sauter cette etape signifie que votre serveur accumulera des vulnerabilites en quelques semaines.

Allouer la memoire swap

Creez un fichier swap de 2 Go a /swapfile, definissez les permissions a 600, formatez-le avec mkswap, activez-le avec swapon et ajoutez-le a /etc/fstab pour qu'il persiste entre les redemarrages. Sans swap, un pic de memoire dans le processus de l'agent peut tuer le conteneur ou faire planter le serveur.

Installer et configurer Tailscale

Installez Tailscale depuis leur script d'installation officiel, demarrez-le avec votre cle d'authentification et un nom d'hote, attendez l'attribution d'une adresse IP (jusqu'a 60 secondes), definissez l'operateur sur votre utilisateur non-root, demandez un certificat TLS et activez le service HTTPS sur le port de la passerelle agent. Cela cree le tunnel chiffre qui remplace l'exposition sur l'internet public pour toutes les communications de l'agent.

Installer Docker et recuperer l'image de l'agent

Installez Docker depuis le script d'installation officiel, ajoutez votre utilisateur non-root au groupe docker, authentifiez-vous aupres du registre de conteneurs si necessaire et pre-telechargez l'image de l'environnement d'execution de l'agent. Ensuite, lancez le conteneur avec les variables d'environnement appropriees, les limites de memoire (1800 Mo avec 2 Go de swap), le reseau hote, un volume persistant et une politique de redemarrage pour qu'il survive aux redemarrages.

Connecter le fournisseur du modele

Configurez l'acces de l'agent au modele — une cle API passee au conteneur sous forme de variable d'environnement, ou une connexion par abonnement comme celle de Codex — et configurez la passerelle avec la connectivite WebSocket, TLS et les permissions operateur. Attendez ensuite que la passerelle s'initialise et extrayez le jeton d'authentification des logs du conteneur.

Verifier que tout fonctionne

Confirmez que les regles du pare-feu sont correctes, que Tailscale est connecte, que le conteneur Docker tourne, que l'agent repond via la passerelle et que votre machine locale peut l'atteindre a travers le reseau Tailscale. Mettez a jour votre configuration SSH locale et known_hosts pour un acces pratique par la suite.

Ce que tout cela represente

Voici la liste complete des paquets et services configures sur chaque VPS d'agent Office Claws :

All 8 security layers automated by Office Claws

ComposantFonction
ufwPare-feu avec regles d'acces Tailscale uniquement
fail2banPrevention d'intrusion par force brute
unattended-upgradesCorrectifs de securite automatiques
Configuration de durcissement SSHDesactive la connexion root, les mots de passe, le forwarding
TailscaleReseau chiffre et certificats TLS
DockerEnvironnement d'execution de l'agent conteneurise avec limites de memoire
2 Go de swapProtection contre les debordements de memoire
Utilisateur non-root avec sudo restreintPrincipe du moindre privilege

Cela represente huit couches de securite configurees a travers environ 20 etapes manuelles, chacune avec ses propres modes de defaillance. Ratez l'ordre du pare-feu et vous vous verrouillez dehors. Oubliez le swap et l'agent plante sous charge. Sautez unattended-upgrades et votre serveur accumule des vulnerabilites. Configurez mal le durcissement SSH et vous laissez la porte ouverte — ou vous la fermez sur vous-meme.

Avec Office Claws, vous lancez officeclaws onboard, suivez la progression pendant deux ou trois minutes et obtenez tout cela — durci, teste et connecte. Le provisionnement a partir d'une image signifie que chaque serveur demarre d'une image preconstruite et verifiee, il n'y a donc aucun ecart entre ce que vous attendez et ce que vous obtenez.

Resolution des problemes courants de configuration

"No active subscription"

L'onboarding s'arrete si votre compte n'a pas d'abonnement actif. Lancez officeclaws subscribe, finalisez le paiement, puis relancez officeclaws onboard.

Les identifiants Contabo sont rejetes

Verifiez les quatre valeurs sur my.contabo.com/api/details. L'erreur la plus frequente consiste a saisir le mot de passe de connexion au site au lieu du mot de passe API. Si vous n'avez jamais defini de mot de passe API, definissez-en un sur cette page d'abord.

"No VPSes found on your account"

L'onboarding transforme en agent un VPS qui existe deja dans votre compte Contabo. Commandez un VPS chez Contabo, attendez qu'il soit demarre, puis relancez officeclaws onboard.

Le provisionnement prend plus de temps que prevu

Le provisionnement prend generalement 2 a 3 minutes. S'il est nettement plus lent, Contabo est peut-etre encore en train de preparer le serveur — verifiez son statut dans le panneau de controle Contabo. Une execution avec --reinstall prend plus de temps, car Contabo doit d'abord reinstaller l'image du serveur. En cas d'echec, le CLI affiche l'erreur, officeclaws agents indique le statut de l'agent et les logs complets se trouvent dans ~/.openclaw/logs.

La cle d'authentification Tailscale est rejetee

Assurez-vous que la cle n'a pas expire et, s'il s'agit d'une cle a usage unique, qu'elle n'a pas deja servi. Generez-en une nouvelle dans la console d'administration Tailscale et passez-la avec officeclaws onboard --tailscale-authkey <cle>.

L'agent apparait hors ligne ou le chat ne se connecte pas

Verifiez que Tailscale tourne sur votre ordinateur. chat et logs joignent l'agent via votre tailnet, les deux cotes doivent donc etre connectes. Ouvrez l'application Tailscale et confirmez que votre machine apparait comme "Connected".

Et ensuite

Une fois votre premier agent operationnel :

  • Ajoutez d'autres agents. Chaque agent obtient son propre VPS et son propre poste dans le bureau. Commandez un autre VPS chez Contabo et relancez officeclaws onboard.
  • Planifiez du travail recurrent. officeclaws cron add cree des taches planifiees, et officeclaws telegram set vous permet de parler a un agent depuis Telegram.
  • Explorez les personnalites d'agent. Differents reglages de --comm-style produisent des schemas d'interaction nettement differents.

Configurer Office Claws prend quelques minutes, mais le resultat est un espace de travail IA persistant qui continue de tourner que votre terminal ou l'application soient ouverts ou non. Vos agents continuent de travailler sur leur VPS, et vous vous reconnectez quand vous en avez besoin.

Auteur

Office Claws Team

Nous construisons le futur de la gestion des agents IA chez Office Claws. Partage d'analyses sur l'infrastructure, la sécurité et l'expérience développeur.

Lancez votre premier agent en 3 minutes environ

Installez la CLI Office Claws, connectez votre compte Contabo et votre abonnement Codex : votre agent obtient son propre VPS et un bureau dans l'office.

curl -fsSL https://officeclaws.com/downloads/install.sh | sh

4,99 $/mois + votre propre VPS Contabo · les clés restent dans votre trousseau