Cloud Monitor：接入 OpenClaw 應用

使用限制

步驟一：擷取接入命令

在安裝外掛程式之前，您需要先從CloudMonitor 2.0 控制台擷取接入命令。

1. 登入CloudMonitor 2.0 控制台，選擇目標工作空間。

2. 在左側導覽列單擊接入中心。

3. 在AI 應用可觀測地區單擊 OpenClaw 卡片。

4. 在參數配置地區輸入應用程式名稱，根據需求選擇串連方式，然後單擊 LicenseKey 右側的點擊擷取。

   頁面下方將根據配置參數產生相應的接入命令，單擊右上方可一鍵複製。命令中包含 Endpoint、LicenseKey 等存取點資訊，如需手動安裝請記錄：

   參數	說明	樣本
   Endpoint	OTLP Trace/Metric 資料上報地址	https://proj-xtrace-xxx.cn-hangzhou-intranet.log.aliyuncs.com/apm/trace/opentelemetry/v1/traces https://proj-xtrace-xxx.cn-hangzhou-intranet.log.aliyuncs.com/apm/trace/opentelemetry/v1/metrics
   x-arms-license-key	資料寫入鑒權的 LicenseKey	d95vgxi0cn@xxxxx
   x-arms-project	Log Service專案名稱	proj-xtrace-xxx-cn-hangzhou
   x-cms-workspace	CloudMonitor 2.0 工作空間標識	default-cms-xxx-cn-hangzhou
   serviceName	應用程式名稱	openclaw-xxx

步驟二：安裝接入

curl -fsSL https://arms-apm-cn-hangzhou-pre.oss-cn-hangzhou.aliyuncs.com/openclaw-cms-plugin/install.sh | bash -s -- \
  --endpoint "https://你的Endpoint地址" \
  --x-arms-license-key "你的License-Key" \
  --x-arms-project "你的Project" \
  --x-cms-workspace "你的Workspace" \
  --serviceName "你的服務名"

[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

════════════════════════════════════════════════════
  ✅ openclaw-cms-plugin installed successfully!
════════════════════════════════════════════════════

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

openclaw plugins enable diagnostics-otel

{
  "plugins": {
    "allow": ["openclaw-cms-plugin", "diagnostics-otel"],
    "load": {
      "paths": ["<openclaw-cms-plugin 的安裝路徑>"]
    },
    "entries": {
      "openclaw-cms-plugin": {
        "enabled": 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

步驟三：驗證安裝

執行以下命令檢查外掛程式是否生效：

openclaw plugins list

預期輸出類似如下內容：

┌──────────────┬──────────┬──────────┬────────────────────────────────────────────────────────────────────────────────────────────────────────────────┬──────────┐
│ Name         │ ID       │ Status   │ Source                                                                                                         │ Version  │
├──────────────┼──────────┼──────────┼────────────────────────────────────────────────────────────────────────────────────────────────────────────────┼──────────┤
│ OpenClaw     │ openclaw │ loaded   │ ~/.openclaw/extensions/openclaw-cms-plugin/index.ts                                                            │ 0.1.1    │
│ CMS Plugin   │ -cms-    │          │ Report OpenClaw AI agent execution traces to Alibaba Cloud CMS via OpenTelemetry                               │          │
│ Diagnostics  │ diagnost │ loaded   │ stock:diagnostics-otel/index.ts                                                                                │ 2026.3.1 │
│ OpenTelemetr │ ics-otel │          │ Export diagnostics events to OpenTelemetry                                                                     │          │
└──────────────┴──────────┴──────────┴────────────────────────────────────────────────────────────────────────────────────────────────────────────────┴──────────┘

步驟四：查看監控資料

安裝完成後， 向 OpenClaw 發送幾條訊息，觸發 Agent 執行。之後您可以在CloudMonitor 2.0 控制台查看 OpenClaw 上報的監控資料。

1. 登入CloudMonitor 2.0 控制台，選擇目標工作空間。

2. 在左側導覽列選擇應用可觀測 > AI 應用可觀測。

3. 在應用列表中找到您配置的服務名稱（如 openclaw-gateway）。

4. 單擊應用程式名稱或選擇調用鏈分析查看調用鏈路、Token 消耗、LLM 輸入輸出和耗時分布。

卸載

如需卸載外掛程式，執行以下命令：

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

卸載指令碼將自動清理 openclaw-cms-plugin 的安裝目錄和 openclaw.json 中的所有相關配置，包括 diagnostics-otel 的配置也會一併禁用。

常見問題