Runtime agents Node.js. Gateway centrale, crons, sessions, memoire. Le coeur d'execution d'Agent OS.

OpenClaw

OpenClaw est le runtime d'execution des agents. Tout agent tourne dans OpenClaw. Sans lui, rien ne s'execute.

Role

Executer les agents (demarrage, arret, supervision)
Gerer les crons (taches planifiees)
Gerer les sessions (contexte par agent)
Router les requetes entre agents
Exposer la gateway HTTP sur le port 18789

Architecture

Port 18789 (gateway)
    |
  OpenClaw Runtime (Node.js)
    |
  +--------+--------+--------+
  |        |        |        |
Agent 1  Agent 2  Agent 3  Crons
  |        |        |
 MCPs    MCPs     MCPs

Chaque agent tourne dans un process isole. Les MCPs sont montes par agent selon sa config.

Installation

OpenClaw est deploye via Docker.

# Cloner le repo
git clone <repo-openclaw>
cd openclaw

# Lancer
docker-compose up -d

# Verifier
curl http://localhost:18789/health

Le port 18789 est la gateway principale.

Configuration

La config vit dans le fichier openclaw.config.json :

{
  "port": 18789,
  "agents": {
    "ceo": {
      "model": "claude-opus-4-20250514",
      "mcps": ["obsidian", "notion", "email"],
      "memory": true
    },
    "social": {
      "model": "claude-sonnet-4-20250514",
      "mcps": ["twitter-stealth", "instagram-stealth", "tiktok-stealth"],
      "memory": true
    }
  },
  "crons": {
    "daily-report": "0 20 * * *",
    "market-scan": "0 */4 * * *"
  }
}

Chaque agent declare ses MCPs. Il n'a acces qu'a ceux-la.

Deployer un agent

Definir l'agent dans la config
Lister ses MCPs autorises
Definir son modele LLM
Redemarrer OpenClaw

# Ajouter l'agent dans la config
# Puis :
docker-compose restart openclaw

L'agent est disponible immediatement via la gateway.

Commandes utiles

Commande	Action
`curl localhost:18789/health`	Etat du runtime
`curl localhost:18789/agents`	Liste agents actifs
`curl localhost:18789/crons`	Liste crons actifs
`curl localhost:18789/sessions`	Sessions en cours
`curl localhost:18789/agent/{id}/start`	Demarrer un agent
`curl localhost:18789/agent/{id}/stop`	Arreter un agent

Sessions et memoire

Chaque agent a une session persistante. La session contient :

L'historique de conversation
Les variables de contexte
Les preferences chargees depuis OpenMemory

Les sessions survivent aux redemarrages si la persistence est activee.

Crons

Les crons sont des taches planifiees executees par les agents.

{
  "crons": {
    "daily-report": {
      "schedule": "0 20 * * *",
      "agent": "ceo",
      "prompt": "Genere le rapport quotidien"
    },
    "market-scan": {
      "schedule": "0 */4 * * *",
      "agent": "trader",
      "prompt": "Scan les marches et alerte si opportunite"
    }
  }
}

Format : cron standard (minute heure jour mois jour-semaine).

Limites

Un agent = un process. Pas de multi-threading intra-agent.
La gateway est HTTP uniquement. Pas de WebSocket natif.
Les crons ne se rattrapent pas si le runtime etait down.
La memoire session est en RAM par defaut. Activer la persistence pour la durabilite.

OpenClaw

On this page