AmiBêta
XOuvrir l'App
Tous les Guides
Intégration Bureau

Guide d'Installation OpenClaw

Donnez à Ami la capacité de contrôler votre bureau — notes, rappels, calendrier, musique et plus.

Note de confidentialité : OpenClaw s'exécute entièrement sur votre appareil. Votre token de gateway ne quitte jamais votre machine.

Prérequis

macOS est nécessaire pour les outils Apple Notes, Rappels, Calendrier et Musique.

Node.js 22+ — vérifiez avec node --version

Si vous n'avez pas Node 22+ :

bash
brew install node@22
Step 1

Installer OpenClaw

Exécutez le script d'installation dans votre terminal :

bash
curl -fsSL https://openclaw.ai/install.sh | bash

Cela installera la CLI et démarrera l'assistant automatiquement.

Vérifier l'installation

bash
openclaw doctor

openclaw n'est pas trouvé, ajoutez-le à votre PATH :

bash
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Step 2

Démarrer le Gateway

L'assistant installe un daemon qui démarre le gateway automatiquement. Pour vérifier :

bash
openclaw gateway status

Si vous devez le démarrer manuellement :

bash
openclaw gateway --port 18789

Trouvez votre token de gateway

Votre token est dans ~/.openclaw/openclaw.json sous gateway.auth.token. Vous pouvez le voir avec :

bash
cat ~/.openclaw/openclaw.json | grep '"token"' | head -1
Gardez ce token — vous en aurez besoin à l'étape suivante.
Step 3

Connecter Ami à OpenClaw

  1. Ouvrez l'app Ami et allez dans Paramètres
  2. Faites défiler jusqu'à la section Avancé
  3. Développez Gateway OpenClaw
  4. Remplissez les champs :
ChampValeur
URL du Gatewayws://127.0.0.1:18789
Token du Gateway(collez le token de l'Étape 2)

5. Activez Router le chat web via OpenClaw

6. Cliquez sur Enregistrer

Options supplémentaires

OptionFonction
Synchroniser l'identitéEnvoie le nom et la personnalité d'Ami au gateway pour les autres canaux
Récupérer les souvenirsImporte les souvenirs de l'espace de travail dans l'app
Envoyer les souvenirsAuto-synchronise les souvenirs de l'app toutes les 10 minutes
Step 4

Configurer l'Espace de Travail

OpenClaw utilise un dossier d'espace de travail. Le chemin par défaut est ~/.openclaw/workspace-ami/

Il doit contenir deux fichiers :

SOUL.md — Personnalité

Ce fichier est auto-synchronisé depuis l'app. Il définit qui est Ami et comment elle répond.

~/.openclaw/workspace-ami/SOUL.md

TOOLS.md — Instructions d'Outils

C'est le guide d'Ami pour utiliser les macOS outils. Il devrait déjà être configuré.

~/.openclaw/workspace-ami/TOOLS.md

Le fichier contient des osascript commandes pour chaque outil.

Outils Disponibles

Une fois connecté, vous pouvez demander à Ami de faire :

Apple Notes

Écris-moi une note sur les courses

Sauvegarde une note Plans du Weekend

Rappels

Rappelle-moi d'appeler le dentiste à 15h

Mets un rappel pour arroser les plantes demain

Calendrier

Qu'est-ce que j'ai aujourd'hui ?

Ajoute une réunion avec Jake vendredi à 14h

Musique

Mets de la musique

Pause la musique

Passe à la chanson suivante

Qu'est-ce qui joue ?

Contrôles Système

Active le mode sombre

Mets un minuteur de 5 minutes

Quel est mon niveau de batterie ?

Ouvrir Apps et URLs

Ouvre Safari

Ouvre le site twitter.com

Dépannage

Mettre à Jour OpenClaw

bash
npm update -g openclaw

Ou relancez l'installateur :

bash
curl -fsSL https://openclaw.ai/install.sh | bash

Architecture

Pour les curieux — voici comment Ami communique avec votre bureau :

┌──────────────┐     WebSocket      ┌──────────────────┐     osascript     ┌──────────────┐
│   Ami App    │ ──────────────────► │ OpenClaw Gateway │ ────────────────► │  macOS APIs  │
│  (browser)   │ ◄────────────────── │  (localhost)     │ ◄──────────────── │ Notes, Music │
│              │    SSE streaming    │  Port 18789      │    tool results   │ Calendar etc │
└──────────────┘                     └──────────────────┘                   └──────────────┘
                                            │
                                     ┌──────┴──────┐
                                     │  Workspace  │
                                     │  SOUL.md    │
                                     │  TOOLS.md   │
                                     └─────────────┘

1. Vous envoyez un message à Ami dans le navigateur

2. L'app détecte si c'est une demande d'outil et affiche une carte immédiatement

3. Le message est acheminé via le gateway OpenClaw par WebSocket

4. L'agent du gateway lit TOOLS.md, exécute la commande osascript appropriée

5. L'agent répond avec confirmation, qu'Ami vous dit

Prêt à commencer ?

Installez OpenClaw, connectez Ami et contrôlez votre bureau en langage naturel.

Ouvrir l'App