Cloud Monitor:Intégrer des applications OpenClaw

Méthode 1 : Installation en un clic (Recommandé)

Sur la machine exécutant OpenClaw, ouvrez un terminal, collez la commande d'installation obtenue à l'étape précédente, puis exécutez-la :

curl -fsSL https://arms-apm-cn-hangzhou-pre.oss-cn-hangzhou.aliyuncs.com/opentelemetry-instrumentation-openclaw/install.sh | bash -s -- \
  --endpoint "https://<YOUR_ENDPOINT>" \
  --x-arms-license-key "<YOUR_LICENSE_KEY>" \
  --x-arms-project "<YOUR_PROJECT>" \
  --x-cms-workspace "<YOUR_WORKSPACE>" \
  --serviceName "<YOUR_SERVICE_NAME>"

Le script d'installation effectue automatiquement les actions suivantes :

1. Vérifie la présence de Node.js, npm et de la CLI OpenClaw dans l'environnement.

2. Télécharge et extrait le plugin opentelemetry-instrumentation-openclaw dans le répertoire des extensions d'OpenClaw.

3. Installe les dépendances d'exécution du plugin.

4. Localise automatiquement l'extension diagnostics-otel et installe ses dépendances si elles ne sont pas déjà présentes.

5. Met à jour le fichier openclaw.json avec les configurations des deux plugins. Pour OpenClaw v2026.4.25 et versions ultérieures, il ajoute également automatiquement hooks.allowConversationAccess: true.

6. Redémarre la passerelle pour appliquer la nouvelle configuration.

La sortie attendue ressemble à ceci :

[INFO]  Checking prerequisites...
[OK]    Node.js v24.14.0
[OK]    npm 11.9.0
[OK]    OpenClaw CLI found
[INFO]  Downloading plugin...
[OK]    Downloaded
[INFO]  Extracting...
[OK]    Extracted
[INFO]  Installing npm dependencies...
[OK]    Dependencies installed
[INFO]  Locating diagnostics-otel extension...
[OK]    Found diagnostics-otel at: /home/.../extensions/diagnostics-otel
[OK]    diagnostics-otel dependencies already present
[INFO]  Updating config...
[OK]    Config updated
[INFO]  Restarting OpenClaw gateway...
[OK]    Gateway restarted
════════════════════════════════════════════════════
  ✅ opentelemetry-instrumentation-openclaw installed successfully!
════════════════════════════════════════════════════

Méthode 2 : Installation manuelle

Pour réaliser une installation manuelle, suivez les étapes ci-dessous.

curl -fsSL -o opentelemetry-instrumentation-openclaw.tar.gz https://arms-apm-cn-hangzhou-pre.oss-cn-hangzhou.aliyuncs.com/opentelemetry-instrumentation-openclaw/opentelemetry-instrumentation-openclaw.tar.gz
tar -xzf opentelemetry-instrumentation-openclaw.tar.gz
cd opentelemetry-instrumentation-openclaw
npm install --omit=dev

openclaw plugins enable diagnostics-otel

{
  "plugins": {
    "allow": ["opentelemetry-instrumentation-openclaw", "diagnostics-otel"],
    "load": {
      "paths": ["<PATH_TO_OPENTELEMETRY_INSTRUMENTATION_OPENCLAW>"]
    },
    "entries": {
      "opentelemetry-instrumentation-openclaw": {
        "enabled": true,
        "hooks": {
          "allowConversationAccess": true
        },
        "config": {
          "endpoint": "<ENDPOINT>",
          "headers": {
            "x-arms-license-key": "<YOUR_LICENSE_KEY>",
            "x-arms-project": "<YOUR_ARMS_PROJECT>",
            "x-cms-workspace": "<YOUR_WORKSPACE_ID>"
          },
          "serviceName": "<YOUR_SERVICE_NAME>"
        }
      },
      "diagnostics-otel": {
        "enabled": true
      }
    }
  },
  "diagnostics": {
    "enabled": true,
    "otel": {
      "enabled": true,
      "endpoint": "<ENDPOINT>",
      "protocol": "http/protobuf",
      "headers": {
        "x-arms-license-key": "<YOUR_LICENSE_KEY>",
        "x-arms-project": "<YOUR_ARMS_PROJECT>",
        "x-cms-workspace": "<YOUR_WORKSPACE_ID>"
      },
      "serviceName": "<YOUR_SERVICE_NAME>",
      "traces": false,
      "metrics": true,
      "logs": false
    }
  }
}

openclaw gateway restart

FROM ghcr.io/openclaw/openclaw:latest
RUN curl -fsSL https://arms-apm-cn-hangzhou-pre.oss-cn-hangzhou.aliyuncs.com/opentelemetry-instrumentation-openclaw/install.sh | bash -s -- \
  --endpoint "https://<YOUR_ENDPOINT>" \
  --x-arms-license-key "<YOUR_LICENSE_KEY>" \
  --x-arms-project "<YOUR_PROJECT>" \
  --x-cms-workspace "<YOUR_WORKSPACE>" \
  --serviceName "<YOUR_SERVICE_NAME>"

FROM ghcr.io/openclaw/openclaw:latest
RUN curl -fsSL https://arms-apm-cn-hangzhou-pre.oss-cn-hangzhou.aliyuncs.com/opentelemetry-instrumentation-openclaw/install-ack.sh | bash -s

openclaw plugins list

┌───────────────────┬─────────────────┬──────────┬──────────┬────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┬────────────┐
│ Name              │ ID              │ Format   │ Status   │ Source                                                                                                                                                                     │ Version    │
├───────────────────┼─────────────────┼──────────┼──────────┼────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┼────────────┤
│ OpenClaw OTel     │ opentelemetry-  │ openclaw │ enabled  │ ~/.openclaw/extensions/opentelemetry-instrumentation-openclaw/dist/index.js                                                                                                │ 0.1.3-beta │
│ Plugin            │ instrumentation │          │          │ Report OpenClaw AI agent execution traces to any OTLP-compatible backend via OpenTelemetry                                                                                 │            │
│ @openclaw/        │ diagnostics-    │ openclaw │ enabled  │ ~/.openclaw/npm/node_modules/@openclaw/diagnostics-otel/dist/index.js                                                                                                      │ 2026.5.6   │
│ diagnostics-otel  │ otel            │          │          │                                                                                                                                                                            │            │
└───────────────────┴─────────────────┴──────────┴──────────┴────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┴────────────┘

curl -fsSL https://arms-apm-cn-hangzhou-pre.oss-cn-hangzhou.aliyuncs.com/opentelemetry-instrumentation-openclaw/uninstall.sh | bash

Aucune donnée n'apparaît dans la console après la configuration ?

Vérifiez les points suivants dans l'ordre :

1. Assurez-vous que votre version d'OpenClaw est la v26.2.19 ou ultérieure. Exécutez openclaw --version pour le vérifier.

2. Confirmez que la passerelle a bien redémarré (elle redémarre automatiquement après une installation en un clic, mais nécessite l'exécution de openclaw gateway restart pour une installation manuelle). En cas d'échec du redémarrage, exécutez openclaw doctor puis redémarrez la passerelle une fois les problèmes résolus.

3. Vérifiez que l'URL de l'Endpoint est correcte et accessible sur le réseau. Testez la connectivité avec curl.

4. Assurez-vous que les trois valeurs d'en-tête (x-arms-license-key, x-arms-project et x-cms-workspace) sont correctement renseignées.

5. Si la version d'OpenClaw est 2026.4.25 ou ultérieure, définissez hooks.allowConversationAccess sur true dans la configuration du plugin pour empêcher la politique de sécurité de bloquer les hooks liés aux conversations. Pour les versions antérieures à 2026.4.25, assurez-vous que la configuration ne contient pas le champ hooks afin d'éviter une erreur « Unrecognized key ».

6. Notez que la valeur par défaut de flushIntervalMs est de 60 secondes. Pour les tâches de courte durée, patientez quelques minutes avant l'apparition des données.

L'intégration affecte-t-elle les performances ?

L'impact est minime. opentelemetry-instrumentation-openclaw utilise le mécanisme d'exportation par lot d'OpenTelemetry. Les données de span sont mises en mémoire tampon et signalées par lots à intervalles réguliers, ce qui ne bloque pas le flux de traitement normal de l'agent.

Puis-je installer uniquement le signalement des traces ?

Oui. Ajoutez le paramètre --disable-metrics lors de l'installation pour ignorer la configuration de diagnostics-otel et activer uniquement le signalement des traces.

Les traces provenant de différents plugins entrent-elles en conflit ?

Non. Le script d'installation définit diagnostics.otel.traces sur false par défaut. Le composant opentelemetry-instrumentation-openclaw est spécifiquement chargé du signalement des traces. Aucun conflit ne survient même si les deux signalent simultanément.

L'installation écrase-t-elle les configurations existantes ?

Non. Le script d'installation utilise une stratégie de fusion-mise à jour : il met à jour uniquement les champs nécessaires tels que endpoint et headers, et laisse inchangées vos configurations existantes pour traces, logs et sampleRate.

Pourquoi la consommation de tokens est-elle toujours à 0 ?

OpenClaw v2026.3.8 contient un bogue entraînant une collecte incorrecte de la consommation de tokens. Ce bogue a été corrigé dans la v2026.4.5 et les versions ultérieures.

Puis-je utiliser gRPC pour signaler des données ?

Le plugin diagnostics-otel d'OpenClaw prend uniquement en charge http/protobuf. Si vous définissez grpc, le paramètre est ignoré silencieusement. Aucune erreur ne se produit, mais le paramètre n'a aucun effet.