Commencez avec OpenClaw Lightsail - Amazon Lightsail

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Commencez avec OpenClaw Lightsail

OpenClaw est une passerelle de chat alimentée par l'IA qui fonctionne sur Amazon Lightsail, vous offrant un assistant IA privé et auto-hébergé accessible depuis votre navigateur, Telegram, etc. WhatsApp Ce didacticiel explique comment lancer une instance Amazon OpenClaw Lightsail, associer votre navigateur, activer les fonctionnalités d'intelligence artificielle et éventuellement connecter des canaux de messagerie.

Le saviez-vous ?

Votre instance OpenClaw Lightsail est préconfigurée avec Amazon Bedrock comme fournisseur de modèles d'IA par défaut. Une fois la configuration terminée, vous pouvez commencer à discuter avec votre assistant AI immédiatement. Aucune configuration supplémentaire n'est requise.

Étape 1 : créer une OpenClaw instance

Au cours de cette étape, vous allez créer une instance Lightsail en cours d'exécution. OpenClaw

Pour créer une instance Lightsail avec OpenClaw
  1. Connectez-vous à la console Lightsail.

  2. Dans la section Instances de la page d'accueil de Lightsail, choisissez Create instance.

  3. Choisissez la AWS région et la zone de disponibilité pour votre instance.

  4. Choisissez l'image pour votre instance comme suit :

    • Sous Sélectionnez une plate-forme, choisissez Linux/Unix.

    • Sous Sélectionnez un plan, choisissez OpenClaw.

    Sélectionnez le OpenClaw plan.
  5. Sous Choisissez votre plan d'instance, sélectionnez un plan d'instance (un plan de mémoire de 4 Go est recommandé pour des performances optimales).

  6. Entrez un nom pour votre instance ou utilisez le nom par défaut fourni.

    Note

    Les noms d'instance doivent être uniques dans votre compte Lightsail, comporter de 2 à 255 caractères, commencer et se terminer par un caractère alphanumérique et contenir uniquement des caractères alphanumériques, des points, des tirets ou des traits de soulignement.

  7. Choisissez Créer une instance.

Votre instance sera en état de démarrage pendant quelques minutes lors de son démarrage. Attendez que le statut indique En cours d'exécution avant de passer à l'étape suivante.

Étape 2 : associez votre navigateur à OpenClaw

Avant de pouvoir utiliser le OpenClaw tableau de bord, vous devez associer votre navigateur à OpenClaw. Cela crée une connexion sécurisée entre la session de votre navigateur et OpenClaw.

Astuce

Préparez votre navigateur sur le même appareil que celui que vous utiliserez pour accéder au OpenClaw tableau de bord. Vous allez copier un jeton depuis Lightsail et le coller dans le tableau de bord au cours de cette OpenClaw étape.

L'adresse IP publique par défaut de votre OpenClaw instance change si vous arrêtez et redémarrez votre instance. Lorsque vous attachez une adresse IP statique à votre instance, elle reste la même même si vous arrêtez et redémarrez votre instance. Pour plus d'informations, voir Afficher et gérer les adresses IP des ressources Lightsail.

Pour associer votre navigateur à OpenClaw
  1. Dans la section Instances de la console Lightsail, choisissez le nom de OpenClaw votre instance pour ouvrir la page de gestion des instances.

  2. Dans l'onglet Getting started, sous Associer votre navigateur à OpenClaw, choisissez Connect using SSH. Un terminal SSH basé sur un navigateur s'ouvre.

    L'onglet OpenClaw Getting Started.
  3. Dans le terminal SSH, recherchez l'URL du tableau de bord affichée dans le message de bienvenue. Copiez cette URL et ouvrez-la dans un nouvel onglet du navigateur.

    Couplage d'un appareil avec OpenClaw
  4. Dans le OpenClaw tableau de bord qui s'ouvre, recherchez le champ Gateway Token.

  5. De retour dans le terminal SSH, copiez le jeton d'accès affiché.

  6. Collez le jeton d'accès copié dans le champ Gateway Token du OpenClaw tableau de bord, puis cliquez sur Connect.

    Entrez un jeton pour la OpenClaw passerelle.
  7. Retournez au terminal SSH. Lorsque vous y êtes invité, appuyez sur y cette touche pour poursuivre le jumelage des appareils.

  8. Appuyez sur a cette touche pour approuver la demande de jumelage de l'appareil.

Une fois le jumelage terminé, le statut affiché sur le OpenClaw tableau de bord indique OK. Votre navigateur est désormais connecté à votre OpenClaw instance.

Votre navigateur est correctement connecté à la OpenClaw passerelle.
Astuce

Si vous devez associer un navigateur supplémentaire ultérieurement, il vous suffit de vous connecter à nouveau à votre instance par SSH et de répéter les étapes de couplage ci-dessus.

Étape 3 : Activez les fonctionnalités d'IA avec Amazon Bedrock

Votre instance OpenClaw Lightsail est configurée pour utiliser Amazon Bedrock pour alimenter son assistant AI. Au cours de cette étape, vous accorderez à votre instance les autorisations dont elle a besoin pour appeler l'API Bedrock.

Pour activer l'accès à l'API Bedrock
  1. Sur la page de gestion de votre OpenClaw instance, choisissez l'onglet Getting started.

  2. Sous Activer Amazon Bedrock en tant que fournisseur de modèles, cliquez sur le bouton Copier le script. Cliquez ensuite sur le CloudShell bouton Lancer pour ouvrir CloudShell.

    Copiez le script Bedrock pour créer un rôle IAM.
  3. Collez le script copié dans le CloudShell terminal et appuyez surEnter.

  4. Attendez que le script soit terminé. Lorsque vous voyez Terminé dans le résultat, les autorisations ont été appliquées avec succès.

Astuce

Le script crée un rôle IAM et y attache une politique qui accorde à votre OpenClaw instance l'accès à l'API Amazon Bedrock. Vous pouvez consulter et personnaliser cette politique IAM à tout moment dans la console IAM.

Une fois cette étape terminée, accédez à Chat dans le OpenClaw tableau de bord pour commencer à utiliser votre assistant AI.

Remarque : votre instance OpenClaw Lightsail utilise Anthropic Claude Sonnet 4.6 par défaut. Si c'est la première fois que vous utilisez des modèles Anthropic dans Amazon Bedrock, vous devez remplir le formulaire de première utilisation (FTU) pour y accéder. En savoir plus sur la façon d'accéder aux modèles Anthropic.

Étape 4 : Connecter un canal de messagerie (facultatif)

Vous pouvez l'étendre OpenClaw pour travailler avec des applications de messagerie telles que Telegram et WhatsApp interagir avec votre assistant IA directement depuis votre téléphone ou votre client de messagerie. Avant de pouvoir vous connecter OpenClaw à un canal de messagerie, vous devez associer votre navigateur à OpenClaw (voir l'étape 2).

Connect Telegram

Pour ajouter une chaîne Telegram
  1. Ouvrez Telegram et recherchez@BotFather.

  2. Envoyez la commande /newbot et suivez les instructions pour créer un nouveau bot. BotFather fournira un jeton de bot et un lien profond pour votre bot.

    BotFather sur Telegram.
  3. Connectez-vous à votre OpenClaw instance via SSH. Un terminal SSH basé sur un navigateur s'ouvre.

  4. Dans le terminal SSH connecté à votre OpenClaw instance, exécutez :

    openclaw channels add
  5. Sélectionnez Telegram dans la liste des chaînes disponibles.

    Sélectionnez Telegram dans le menu de sélection des chaînes.
  6. Lorsque vous y êtes invité, entrez le jeton de bot que vous avez reçu BotFather à l'étape 2.

  7. Dans le OpenClaw tableau de bord, accédez à la section Chaînes et ajoutez votre nom d'utilisateur Telegram à la liste d'autorisation.

    Autorisez votre bot à recevoir des messages à partir de votre identifiant Telegram.
  8. Testez l'intégration en envoyant un message à votre bot dans Telegram à l'étape 2.

  9. Vous verrez un message dans Telegram vous demandant d'approuver le OpenClaw jumelage. Dans le terminal SSH, exécutez :

    openclaw pairing approve telegram [pairing code]
    Telegram n'est pas associé à votre OpenClaw instance
  10. Testez à nouveau l'intégration en envoyant un message au bot que vous avez créé dans Telegram à l'étape 2

    Telegram est associé à votre OpenClaw instance

Connect WhatsApp

Pour ajouter une WhatsApp chaîne
  1. Connectez-vous à votre OpenClaw instance via SSH. Un terminal SSH basé sur un navigateur s'ouvre.

  2. Dans le terminal SSH connecté à votre OpenClaw instance, exécutez :

    openclaw channels add
  3. Sélectionnez WhatsAppdans la liste des chaînes disponibles.

  4. Suivez les instructions à l’écran. Un code QR sera affiché dans le terminal.

  5. Sur votre téléphone WhatsApp, ouvrez et utilisez la fonction Appareils connectés pour scanner le code QR.

  6. Terminez le jumelage sur votre téléphone.

  7. Testez l'intégration en envoyant un message à votre OpenClaw assistant directement WhatsApp en envoyant un message au numéro de contact que vous avez jumelé dans les étapes ci-dessus.

    WhatsApp est associé à votre OpenClaw instance

Étape 5 : créer un instantané de votre instance (facultatif)

Une fois la configuration terminée, nous vous recommandons de créer un instantané de votre OpenClaw instance. Les snapshots sont point-in-time des sauvegardes qui vous permettent de restaurer votre instance à partir d'un état connu, fournissant ainsi un mécanisme de restauration fiable. Vous pouvez également créer de nouvelles instances du plan souhaité à partir des instantanés.

Pour créer un snapshot manuel
  1. Dans la section Instances de la console Lightsail, choisissez le nom de votre instance. OpenClaw

  2. Choisissez l'onglet Instantanés.

  3. Sous Instantanés manuels, choisissez Créer un instantané.

  4. Entrez un nom pour votre instantané et choisissez Create.

Le saviez-vous ?

Lightsail stocke sept instantanés quotidiens et remplace automatiquement les plus anciens par les plus récents lorsque vous activez les instantanés automatiques pour votre instance. Pour plus d'informations, voir Configuration des instantanés automatiques pour les instances et les disques Lightsail.

Questions fréquemment posées (FAQ)

Comment associer un navigateur supplémentaire à mon OpenClaw instance ?

Vous pouvez associer autant de navigateurs que vous le souhaitez. Pour associer un nouveau navigateur, connectez-vous à nouveau à votre OpenClaw instance en SSH (sur la page de gestion des instances de la console Lightsail, choisissez Connect using SSH). Suivez les mêmes étapes de jumelage que celles de l'étape 2 : accédez à l'URL du tableau de bord, copiez le jeton d'accès depuis le terminal, collez-le dans le champ Gateway Token du OpenClaw tableau de bord du nouveau navigateur et approuvez la demande de jumelage.

Puis-je personnaliser les autorisations IAM accordées à mon OpenClaw instance ?

Oui. Le script de configuration de l'étape 3 crée un rôle IAM avec une politique qui accorde l'accès à Amazon Bedrock. Vous pouvez consulter, modifier ou restreindre cette politique à tout moment :

  • Ouvrez la console IAM et accédez à Rôles.

  • Trouvez le rôle créé pour votre OpenClaw instance, par LightsailRoleFor-i-0d15d5483571b95bb ex.

  • Choisissez le rôle pour afficher les politiques associées.

  • Choisissez le nom de la politique pour modifier ses autorisations.

Soyez prudent lorsque vous modifiez les autorisations : la suppression des autorisations Bedrock requises OpenClaw empêchera de générer des réponses basées sur l'IA. Pour plus d'informations, consultez les politiques IAM dans la documentation AWS.

Puis-je poser OpenClaw des questions sur lui-même, par exemple sur ce qu'il peut faire ou comment l'utiliser ?

Oui, OpenClaw l'assistant de chat intégré peut répondre aux questions le OpenClaw concernant. Si vous n'êtes pas sûr de ce que vous OpenClaw pouvez faire, il vous suffit de le demander directement dans l'interface de chat. Par exemple, vous pouvez saisir :

  • « En quoi pouvez-vous m'aider ? »

  • « À quelles chaînes puis-je me connecter OpenClaw ? »

  • « Comment ajouter un nouveau canal de messagerie ? »

OpenClaw répondra en fournissant des conseils en fonction de ses capacités. C'est un excellent moyen d'explorer les fonctionnalités sans quitter le OpenClaw tableau de bord.

Remarque : vous devrez soit suivre l'étape Activer les fonctionnalités d'IA avec Amazon Bedrock (étape 3 du guide de démarrage), soit configurer votre propre fournisseur de modèles pour que le chat fonctionne. La configuration de Bedrock consiste à exécuter un script en un clic depuis l'onglet Getting started de votre instance pour accorder les autorisations nécessaires et, si c'est la première fois que vous utilisez des modèles Anthropic, à soumettre un bref formulaire de première utilisation dans la console Amazon Bedrock. Sans cette étape, l'interface de chat ne disposera pas d'un modèle d'IA auquel se connecter.

Combien coûte l'utilisation OpenClaw de Lightsail ?

Voici une ventilation des coûts :

  • Instance Lightsail : vous payez pour le plan d'instance que vous avez sélectionné (par exemple, le plan de 4 Go). Les forfaits Lightsail sont facturés sur la base d'un tarif horaire à la demande. Vous ne payez donc que pour ce que vous utilisez. Pour chaque forfait Lightsail que vous utilisez, nous vous facturons le prix horaire fixe, jusqu'à concurrence du coût mensuel maximum du forfait.

  • Utilisation du modèle d'IA (jetons) — Chaque message envoyé et reçu par l' OpenClaw assistant est traité via Amazon Bedrock à l'aide d'un modèle de tarification basé sur des jetons. Les coûts varient selon le modèle : certains modèles sont plus chers par jeton que d'autres.

  • Abonnements à des modèles tiers : si vous sélectionnez un modèle tiers distribué via AWS Marketplace (tel qu'Anthropic Claude ou Cohere), des frais logiciels supplémentaires peuvent s'ajouter au coût par jeton. Ils apparaissent sous forme de rubriques distinctes dans AWS Marketplace sur votre facture.

  • Excédents de transfert de donnéesChaque forfait Lightsail inclut une allocation mensuelle de transfert de données. Si votre OpenClaw instance envoie ou reçoit plus de données que ce que votre forfait inclut, des frais d'excédent s'appliquent pour les transferts de données sortants.

  • Instantanés : les instantanés manuels et automatiques de votre instance Lightsail sont facturés en fonction de la quantité de stockage utilisée.

Je souhaite utiliser un modèle anthropique. Y a-t-il autre chose que je dois faire ?

Outre les autorisations standard, Anthropic a une exigence supplémentaire : vous devez remplir un formulaire de première utilisation (FTU) avant d'invoquer un modèle Anthropic pour la première fois. Il s'agit d'une exigence anthropique qui s'applique une fois par compte AWS, ou une fois au niveau du compte de gestion de l'organisation AWS, qui est ensuite héritée par tous les comptes membres de l'organisation. Votre OpenClaw instance utilise Anthropic Claude-Sonnet 4.6 par défaut.

Lightsail gère pour vous les autorisations IAM et Marketplace sous-jacentes dans le cadre de la configuration de l'étape 3. Le CloudShell script crée un rôle IAM qui inclut les trois autorisations AWS Marketplace requises (aws-marketplace:Subscribeaws-marketplace:Unsubscribe, etaws-marketplace:ViewSubscriptions). Ils sont nécessaires pour qu'Amazon Bedrock active automatiquement les modèles tiers la première fois qu'ils sont invoqués. Une fois qu'un modèle a été activé dans votre compte, tous les utilisateurs du compte peuvent l'invoquer sans avoir eux-mêmes besoin des autorisations du Marketplace. L'abonnement ne doit être souscrit qu'une seule fois.

Pour répondre à l'exigence FTU spécifique à Anthropic :

  • Ouvrez la console Amazon Bedrock.

  • Accédez au catalogue de modèles et sélectionnez un modèle anthropique (tel que Claude).

  • Vous serez invité à fournir les détails du cas d'utilisation. Remplissez et envoyez le formulaire.

L'accès aux modèles Anthropic est accordé immédiatement après l'envoi réussi du formulaire. Une fois cela fait, vous pouvez sélectionner n'importe quel modèle Anthropic dans le OpenClaw tableau de bord et commencer à l'utiliser immédiatement.

Note

Les modèles Amazon, Meta, Mistral AI et Qwen ne sont pas vendus via AWS Marketplace et ne nécessitent pas cette étape. DeepSeek

Pour plus d'informations, consultez la section Access Amazon Bedrock foundation models dans le guide de l'utilisateur Amazon Bedrock.

Comment fonctionne le protocole HTTPS ?

Votre OpenClaw instance est fournie avec un point de terminaison HTTPS intégré sécurisé par un certificat Let's Encrypt. Lorsque votre instance est créée, un certificat Let's Encrypt est automatiquement émis pour l' IPv4 adresse de votre instance. Aucune configuration manuelle n'est requise.

Qu'advient-il de mon certificat SSL si l'adresse IP de mon instance change ?

Votre OpenClaw instance inclut un démon de gestion des certificats intégré (lightsail-manage-certd) qui surveille l'adresse IP de votre instance. Si l'adresse IP change, par exemple lorsque vous attachez ou détachez une adresse IP statique, le démon détecte automatiquement le changement et émet un nouveau certificat Let's Encrypt pour la nouvelle adresse IP. Aucune action manuelle n'est requise.

À quelle fréquence mon certificat SSL est-il renouvelé ?

Les certificats Let's Encrypt émis pour votre OpenClaw instance sont valides pendant 7 jours. Le démon de gestion des certificats renouvelle automatiquement votre certificat 2 jours avant son expiration, afin que votre instance reste sécurisée sans interruption ni intervention manuelle.

Puis-je y installer des plugins OpenClaw ?

Oui OpenClaw prend en charge l'installation de plug-ins, et certains plugins ou modifications de configuration peuvent vous obliger à redémarrer manuellement le service de OpenClaw passerelle pour que les modifications prennent effet.

Pour gérer la passerelle après avoir installé un plugin ou mis à jour une configuration, connectez-vous à votre OpenClaw instance en SSH et utilisez les commandes suivantes :

  • Arrêtez le service de OpenClaw passerelle : sudo systemctl stop openclaw-gateway

  • Démarrez le service de OpenClaw passerelle : sudo systemctl start openclaw-gateway

  • Vérifiez l'état actuel du service : sudo systemctl status openclaw-gateway

Mon jeton de passerelle peut-il être compromis, et comment puis-je le faire pivoter ?

Oui. Le jeton de passerelle est généré une fois lors du premier démarrage de votre OpenClaw instance et ne pivote pas automatiquement. Si le jeton est exposé, par exemple en cas de fuite dans des journaux, de partage accidentel ou d'exposition par injection rapide, toute personne en possession de ce jeton peut accéder à votre OpenClaw passerelle jusqu'à ce que vous la régénériez manuellement.

Pour faire pivoter votre jeton de passerelle :

  • Connectez-vous à votre OpenClaw instance via SSH depuis la console Lightsail.

  • Exécutez la commande suivante pour régénérer le jeton :

    openclaw token rotate
  • L'ancien jeton est immédiatement invalidé. Tous les navigateurs ou clients actuellement associés à l'ancien jeton seront déconnectés.

  • Associez à nouveau vos navigateurs à l'aide du nouveau jeton en suivant les étapes de l'étape 2 : Associer votre navigateur à OpenClaw.

Astuce

Après avoir alterné votre jeton, vérifiez que tous les appareils fiables ont été couplés à nouveau avant de recommencer à les utiliser.

Comment puis-je modifier les informations d'identification de mon canal de messagerie (Telegram WhatsApp, Slack) ?

Si un jeton ou un identifiant de plateforme de messagerie stocké sur votre OpenClaw instance est compromis (par exemple, votre jeton de bot Telegram, vos identifiants de WhatsApp session ou votre jeton Slack), vous devez le faire pivoter immédiatement pour empêcher tout accès non autorisé à vos canaux de messagerie.

Les informations d'identification des canaux connectés sont stockées ~/.openclaw/credentials/ sur votre instance. Pour faire pivoter un identifiant, procédez comme suit :

  • Révoquez le jeton compromis à la source :

    • Télégramme : ouvrez Telegram@BotFather, envoyez un message et /revoke utilisez-le pour invalider votre jeton de bot existant et en générer un nouveau.

    • WhatsApp: Déconnectez-vous de la session de l'appareil associé WhatsApp sur votre téléphone (SettingsLinked Devices→ → sélectionnez votre OpenClaw session →Log out). Créez ensuite un nouveau lien à l'aide du flux de jumelage par code QR.

  • Mettez à jour les informations d'identification de votre OpenClaw instance : connectez-vous par SSH à votre instance et exécutez :

    openclaw channels update

    Sélectionnez le canal que vous souhaitez mettre à jour et entrez le nouveau jeton ou identifiant lorsque vous y êtes invité.

  • Vérifiez que le canal fonctionne en envoyant un message de test via le canal mis à jour.

Note

La rotation d'un identifiant de messagerie n'affecte pas votre jeton de passerelle ni les autres canaux connectés : chaque identifiant est géré indépendamment.