Cloud Monitor:OpenClaw Uygulamalarını Entegre Etme

Yöntem 1: Tek tıklamayla yükleme (Önerilen)

OpenClaw'ın çalıştığı makinede bir terminal açın, önceki adımdaki kurulum komutunu yapıştırın ve çalıştırın:

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>"

Kurulum betiği otomatik olarak aşağıdaki işlemleri gerçekleştirir:

1. Ortamda Node.js, npm ve OpenClaw CLI olup olmadığını kontrol eder.

2. opentelemetry-instrumentation-openclaw eklentisini indirir ve OpenClaw uzantıları dizinine çıkarır.

3. Eklenti için çalışma zamanı bağımlılıklarını yükler.

4. diagnostics-otel uzantısını otomatik olarak bulur ve henüz yüklü değilse bağımlılıklarını yükler.

5. Her iki eklenti için yapılandırmalarla openclaw.json dosyasını günceller. OpenClaw v2026.4.25 ve sonraki sürümler için ayrıca hooks.allowConversationAccess: true ayarını otomatik olarak ekler.

6. Yeni yapılandırmayı uygulamak üzere ağ geçidini yeniden başlatır.

Beklenen çıktı aşağıdakine benzer:

[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!
════════════════════════════════════════════════════

Yöntem 2: Manuel kurulum

Manuel kurulum gerçekleştirmek için aşağıdaki adımları izleyin.

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

Yapılandırmadan sonra konsolda veri görünmüyor mu?

Aşağıdaki öğeleri sırayla kontrol edin:

1. OpenClaw sürümünüzün v26.2.19 veya üzeri olduğunu doğrulayın. Doğrulamak için openclaw --version komutunu çalıştırın.

2. Ağ geçidinin yeniden başlatıldığını doğrulayın (tek tıklamayla kurulumdan sonra otomatik olarak yeniden başlatılır, ancak manuel kurulum için openclaw gateway restart komutunu çalıştırmanız gerekir). Yeniden başlatma başarısız olursa openclaw doctor komutunu çalıştırabilir ve sorunlar giderildikten sonra ağ geçidini yeniden başlatabilirsiniz.

3. Endpoint URL'sinin doğru olduğunu ve ağ üzerinden erişilebilir olduğunu doğrulayın. Bağlantıyı curl ile test edin.

4. Üç üst bilgi değerinin de (x-arms-license-key, x-arms-project ve x-cms-workspace) doğru girildiğini doğrulayın.

5. OpenClaw sürümü 2026.4.25 veya üzeriyse, güvenlik ilkesinin konuşmayla ilgili hook'ları engellemesini önlemek için eklenti yapılandırmasında hooks.allowConversationAccess değerini true olarak ayarlayın. Sürüm 2026.4.25'ten önceyse, "Unrecognized key" hatasından kaçınmak için yapılandırmada hooks alanının bulunmadığından emin olun.

6. Varsayılan flushIntervalMs değerinin 60 saniye olduğunu unutmayın. Kısa ömürlü görevler için verilerin görünmesi birkaç dakika bekleyin.

Entegrasyon performansı etkiler mi?

Etkisi minimum düzeydedir. opentelemetry-instrumentation-openclaw OpenTelemetry'nin toplu dışa aktarma mekanizmasını kullanır. Span verileri bellekte arabelleğe alınır ve düzenli aralıklarla toplu halde raporlanır; bu durum aracının normal işleme akışını engellemez.

Yalnızca izleme raporlaması yükleyebilir miyim?

Evet. Kurulum sırasında --disable-metrics parametresini ekleyerek diagnostics-otel yapılandırmasını atlayabilir ve yalnızca İzleme raporlamasını etkinleştirebilirsiniz.

Farklı eklentilerden gelen izlemeler çakışır mı?

Hayır. Kurulum betiği varsayılan olarak diagnostics.otel.traces değerini false olarak ayarlar. opentelemetry-instrumentation-openclaw bileşeni özellikle izlemeleri raporlamaktan sorumludur. İkisi aynı anda raporlasa bile çakışma oluşmaz.

Kurulum mevcut yapılandırmaların üzerine yazar mı?

Hayır. Kurulum betiği bir birleştirme-güncelleme stratejisi kullanır; yalnızca endpoint ve headers gibi gerekli alanları günceller ve traces, logs ve sampleRate için mevcut yapılandırmalarınızı değiştirmeden bırakır.

Token tüketimi neden her zaman 0?

OpenClaw v2026.3.8, hatalı token tüketimi toplamaya neden olan bir hata içerir. Bu hata v2026.4.5 ve sonraki sürümlerde düzeltildi.

Veri raporlamak için gRPC kullanabilir miyim?

OpenClaw'daki diagnostics-otel eklentisi yalnızca http/protobuf destekler. grpc ayarlarsanız bu ayar sessizce yok sayılır. Hata oluşmaz ancak ayarın hiçbir etkisi olmaz.