Cloud Monitor:Integrasikan Aplikasi OpenClaw

Metode 1: Instalasi satu-klik (Direkomendasikan)

Pada mesin yang menjalankan OpenClaw, buka terminal, tempel perintah instalasi dari langkah sebelumnya, lalu jalankan:

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

Skrip instalasi secara otomatis melakukan tindakan berikut:

1. Memeriksa lingkungan untuk Node.js, npm, dan CLI OpenClaw.

2. Mengunduh dan mengekstrak plugin opentelemetry-instrumentation-openclaw ke direktori ekstensi OpenClaw.

3. Menginstal dependensi waktu proses untuk plugin tersebut.

4. Secara otomatis mencari ekstensi diagnostics-otel dan menginstal dependensinya jika belum terinstal.

5. Memperbarui file openclaw.json dengan konfigurasi untuk kedua plugin. Untuk OpenClaw v2026.4.25 dan yang lebih baru, skrip juga secara otomatis menambahkan hooks.allowConversationAccess: true.

6. Merestart gateway untuk menerapkan konfigurasi baru.

Output yang diharapkan mirip dengan berikut:

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

Metode 2: Instalasi manual

Untuk melakukan instalasi manual, ikuti langkah-langkah berikut.

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

Tidak ada data yang muncul di konsol setelah konfigurasi?

Periksa hal-hal berikut secara berurutan:

1. Pastikan versi OpenClaw Anda adalah v26.2.19 atau yang lebih baru. Jalankan openclaw --version untuk memverifikasi.

2. Pastikan gateway telah direstart (otomatis direstart setelah instalasi satu-klik, tetapi Anda perlu menjalankan openclaw gateway restart untuk instalasi manual). Jika restart gagal, Anda dapat menjalankan openclaw doctor lalu restart gateway setelah masalah diperbaiki.

3. Pastikan URL Endpoint benar dan dapat dijangkau melalui jaringan. Uji konektivitas dengan curl.

4. Pastikan ketiga nilai header (x-arms-license-key, x-arms-project, dan x-cms-workspace) dimasukkan dengan benar.

5. Jika versi OpenClaw adalah 2026.4.25 atau yang lebih baru, atur hooks.allowConversationAccess ke true dalam konfigurasi plugin untuk mencegah kebijakan keamanan memblokir hook terkait percakapan. Jika versinya sebelum 2026.4.25, pastikan konfigurasi tidak mengandung bidang hooks untuk menghindari error "Unrecognized key".

6. Perhatikan bahwa flushIntervalMs default-nya adalah 60 detik. Untuk tugas berdurasi pendek, tunggu beberapa menit sebelum data muncul.

Apakah integrasi memengaruhi performa?

Dampaknya minimal. opentelemetry-instrumentation-openclaw menggunakan mekanisme ekspor batch OpenTelemetry. Data rentang dibuffer di memori dan dilaporkan dalam batch pada interval tertentu, sehingga tidak menghalangi alur pemrosesan normal agen.

Bisakah saya hanya menginstal pelaporan jejak?

Ya. Anda dapat menambahkan parameter --disable-metrics selama instalasi untuk melewati konfigurasi diagnostics-otel dan hanya mengaktifkan pelaporan jejak.

Apakah jejak dari plugin berbeda akan saling bertabrakan?

Tidak. Skrip instalasi mengatur diagnostics.otel.traces ke false secara default. Komponen opentelemetry-instrumentation-openclaw secara khusus bertanggung jawab untuk melaporkan jejak. Tidak akan terjadi konflik meskipun keduanya melaporkan secara bersamaan.

Apakah instalasi akan menimpa konfigurasi yang sudah ada?

Tidak. Skrip instalasi menggunakan strategi pembaruan gabungan—hanya memperbarui bidang yang diperlukan seperti endpoint dan headers, dan membiarkan konfigurasi yang sudah ada untuk traces, logs, dan sampleRate tetap tidak berubah.

Mengapa konsumsi token selalu 0?

OpenClaw v2026.3.8 mengandung bug yang menyebabkan pengumpulan konsumsi token salah. Bug ini telah diperbaiki pada versi v2026.4.5 dan yang lebih baru.

Bisakah saya menggunakan gRPC untuk melaporkan data?

Plugin diagnostics-otel di OpenClaw hanya mendukung http/protobuf. Jika Anda mengatur grpc, pengaturan tersebut akan diabaikan tanpa pemberitahuan. Tidak terjadi error, tetapi pengaturan tersebut tidak berpengaruh.