Gateway
OpenTelemetry 匯出
OpenClaw 透過官方 diagnostics-otel 外掛,使用 OTLP/HTTP (protobuf) 匯出診斷資料。日誌也能以 stdout JSONL 格式寫出,供容器與沙箱日誌管線使用。任何接受 OTLP/HTTP 的收集器或後端均可直接運作,無須修改程式碼。如需本機檔案日誌,請參閱日誌記錄。
- 診斷事件是由閘道及內建外掛針對模型執行、訊息流程、工作階段、佇列與命令執行所發出的結構化程序內記錄。
diagnostics-otel會訂閱這些事件,並透過 OTLP/HTTP 將其匯出為 OpenTelemetry 指標、追蹤與日誌,也可將日誌記錄同步輸出為 stdout JSONL。- 當提供者傳輸層接受自訂標頭時,提供者呼叫會從 OpenClaw 受信任的模型呼叫 span 上下文接收 W3C
traceparent標頭。外掛發出的追蹤上下文不會被傳播。 - 僅當診斷介面與外掛皆已啟用時,匯出器才會附加,因此預設情況下的程序內成本接近於零。
快速開始
openclaw plugins install clawhub:@openclaw/diagnostics-otel{ plugins: { allow: ["diagnostics-otel"], entries: { "diagnostics-otel": { enabled: true }, }, }, diagnostics: { enabled: true, otel: { enabled: true, endpoint: "http://otel-collector:4318", protocol: "http/protobuf", serviceName: "openclaw-gateway", traces: true, metrics: true, logs: true, sampleRate: 0.2, flushIntervalMs: 60000, }, },}或者從命令列介面啟用外掛:openclaw plugins enable diagnostics-otel。
匯出的訊號
| 訊號 | 包含內容 |
|---|---|
| 指標 | 權杖用量、成本、執行時間、容錯移轉、Skills 使用情況、訊息流程、Talk 事件、佇列通道、工作階段狀態/復原、工具執行、命令執行、記憶體、存活狀態及匯出器健康狀態的計數器/直方圖。 |
| 追蹤 | 模型使用、模型呼叫、執行框架生命週期、Skills 使用情況、工具執行、命令執行、網路鉤子/訊息處理、上下文組裝及工具迴圈的 span。 |
| 日誌 | 啟用 diagnostics.otel.logs 時,透過 OTLP 或 stdout JSONL 匯出的結構化 logging.file 記錄;除非明確啟用內容擷取,否則不會提供日誌內文。 |
可個別切換 traces、metrics 與 logs。當 diagnostics.otel.enabled 為 true 時,追蹤與指標預設為開啟;日誌預設為關閉,且僅在明確將 diagnostics.otel.logs 設為 true 時才會匯出。日誌預設透過 OTLP 匯出;將 diagnostics.otel.logsExporter 設為 stdout 可輸出 stdout JSONL,設為 both 則兩者皆輸出。
設定參考
{ diagnostics: { enabled: true, otel: { enabled: true, endpoint: "http://otel-collector:4318", tracesEndpoint: "http://otel-collector:4318/v1/traces", metricsEndpoint: "http://otel-collector:4318/v1/metrics", logsEndpoint: "http://otel-collector:4318/v1/logs", protocol: "http/protobuf", // grpc disables OTLP export serviceName: "openclaw-gateway", // unset falls back to OTEL_SERVICE_NAME, then "openclaw" headers: { "x-collector-token": "..." }, traces: true, metrics: true, logs: true, logsExporter: "otlp", // otlp | stdout | both sampleRate: 0.2, // root-span sampler, 0.0..1.0 flushIntervalMs: 60000, // metric export interval (min 1000ms) captureContent: { enabled: false, inputMessages: false, outputMessages: false, toolInputs: false, toolOutputs: false, systemPrompt: false, toolDefinitions: false, }, }, },}環境變數
| 變數 | 用途 |
|---|---|
OTEL_EXPORTER_OTLP_ENDPOINT |
未設定 diagnostics.otel.endpoint 設定鍵時的備用值。 |
OTEL_EXPORTER_OTLP_TRACES_ENDPOINT / OTEL_EXPORTER_OTLP_METRICS_ENDPOINT / OTEL_EXPORTER_OTLP_LOGS_ENDPOINT |
未設定相符的 diagnostics.otel.*Endpoint 設定鍵時所使用的訊號專屬端點備用值。訊號專屬設定的優先順序高於訊號專屬環境變數,而訊號專屬環境變數的優先順序又高於共用端點。 |
OTEL_SERVICE_NAME |
未設定 diagnostics.otel.serviceName 設定鍵時的備用值。預設服務名稱為 openclaw。 |
OTEL_EXPORTER_OTLP_PROTOCOL |
未設定 diagnostics.otel.protocol 時的線路通訊協定備用值。只有 http/protobuf 會啟用匯出。 |
OTEL_SEMCONV_STABILITY_OPT_IN |
設為 gen_ai_latest_experimental 可發出最新的 GenAI 推論 span 結構:{gen_ai.operation.name} {gen_ai.request.model} span 名稱、CLIENT span 類型,以及以 gen_ai.provider.name 取代舊版 gen_ai.system。無論如何,GenAI 指標一律使用有界、低基數屬性。 |
OPENCLAW_OTEL_PRELOADED |
當其他預載程式或主機程序已註冊全域 OpenTelemetry SDK 時設為 1。外掛之後會略過自身的 NodeSDK 生命週期,但仍會連接診斷監聽器並遵循 traces/metrics/logs 設定。 |
隱私權與內容擷取
預設不會匯出原始模型/工具內容。Span 只攜帶有界識別資訊(頻道、提供者、模型、錯誤類別、僅雜湊的請求 ID、工具來源、工具擁有者、Skills 名稱/來源),絕不包含提示文字、回應文字、工具輸入、工具輸出、Skills 檔案路徑或工作階段金鑰。在低基數屬性中,看似具範圍限定的代理程式工作階段金鑰值(例如以 agent: 開頭)會被替換成 unknown。OTLP 日誌記錄預設會保留嚴重性、記錄器、程式碼位置、受信任的追蹤上下文及經清理的屬性;只有在 diagnostics.otel.captureContent 為布林值 true 時才會匯出原始日誌訊息內文。個別的 captureContent.* 子鍵絕不會啟用日誌內文。Talk 指標只會匯出有界事件中繼資料(模式、傳輸方式、提供者、事件類型),不會包含逐字稿、音訊承載資料、工作階段 ID、輪次 ID、通話 ID、房間 ID 或移交權杖。
傳出的模型請求可能包含 W3C traceparent 標頭;該標頭僅根據作用中模型呼叫的 OpenClaw 自有診斷追蹤上下文產生。呼叫端既有的 traceparent 標頭會被取代,因此外掛或自訂提供者選項無法偽造跨服務追蹤祖先關係。
只有當收集器及保留政策已獲准處理提示、回應、工具或系統提示文字時,才將 diagnostics.otel.captureContent.* 設為 true。每個子鍵彼此獨立:
inputMessages- 使用者提示內容。outputMessages- 模型回應內容。toolInputs- 工具引數承載資料。toolOutputs- 工具結果承載資料。systemPrompt- 組裝後的系統/開發者提示。toolDefinitions- 模型工具名稱、說明與結構描述。
啟用任何子鍵時,模型與工具 span 只會取得該類別經過界限控制與遮蔽處理的 openclaw.content.* 屬性。
內建代理程式執行階段的工具執行會擷取 toolInputs/toolOutputs 內容(完成/錯誤 span 上的 openclaw.content.tool_input 與 gen_ai.tool.call.arguments;完成 span 上的 openclaw.content.tool_output 與 gen_ai.tool.call.result)。openclaw.content.* 名稱仍是穩定的 OpenClaw 屬性名稱;gen_ai.tool.call.* 副本則將其鏡像提供給原生支援語意慣例的檢視器。外部執行框架的工具呼叫(Codex、Claude CLI)會發出不含內容承載資料的 tool.execution.* span。擷取的內容會透過受信任、僅供監聽器使用的通道傳輸,絕不會放入公開診斷事件匯流排。
取樣與排清
- 追蹤:
diagnostics.otel.sampleRate僅在根 span 上設定TraceIdRatioBasedSampler(0.0會捨棄全部,1.0會保留全部)。未設定時使用 OpenTelemetry SDK 的預設值(永遠啟用)。 - 指標:
diagnostics.otel.flushIntervalMs(下限為1000);未設定時使用 SDK 的週期性匯出預設值。 - **日誌:**OTLP 日誌遵循
logging.level(檔案日誌層級),並使用 診斷日誌記錄遮蔽路徑,而非主控台格式。高流量 安裝環境應優先使用 OTLP 收集器取樣/篩選,而非本機 取樣。若平台已將 stdout/stderr 傳送至日誌處理器,且沒有 OTLP 日誌 收集器,請設定diagnostics.otel.logsExporter: "stdout"。 stdout 記錄每行為一個 JSON 物件,包含ts、signal、service.name、嚴重性、本文、已遮蔽的屬性,以及可用時受信任的追蹤 欄位。 - **檔案日誌關聯:**當日誌呼叫帶有有效的
診斷追蹤上下文時,JSONL 檔案日誌會包含頂層
traceId、spanId、parentSpanId與traceFlags,讓日誌處理器能將本機日誌行與 已匯出的 span 關聯。 - **請求關聯:**閘道 HTTP 請求與 WebSocket 訊框會建立
內部請求追蹤範圍。該範圍內的日誌與診斷事件
預設會繼承請求追蹤,而代理執行與模型呼叫
span 則建立為子項,因此提供者的
traceparent標頭會維持在 同一追蹤中。 - 模型呼叫關聯:
openclaw.model.callspan 預設包含安全的提示詞 元件大小;當提供者結果公開用量時,也會包含各次呼叫的權杖屬性。openclaw.model.usage仍是用於彙總成本、上下文及頻道儀表板的 執行層級計量 span;當發出事件的執行階段具有受信任的 追蹤上下文時,它會維持在同一診斷追蹤中。
匯出的指標
模型用量
openclaw.tokens(計數器,屬性:openclaw.token、openclaw.channel、openclaw.provider、openclaw.model、openclaw.agent)openclaw.cost.usd(計數器,屬性:openclaw.channel、openclaw.provider、openclaw.model)openclaw.run.duration_ms(直方圖,屬性:openclaw.channel、openclaw.provider、openclaw.model)openclaw.context.tokens(直方圖,屬性:openclaw.context、openclaw.channel、openclaw.provider、openclaw.model)gen_ai.client.token.usage(直方圖,GenAI 語意慣例指標,屬性:gen_ai.token.type=input/output、gen_ai.provider.name、gen_ai.operation.name、gen_ai.request.model)gen_ai.client.operation.duration(直方圖,秒,GenAI 語意慣例指標,屬性:gen_ai.provider.name、gen_ai.operation.name、gen_ai.request.model,選用error.type)openclaw.model_call.duration_ms(直方圖,屬性:openclaw.provider、openclaw.model、openclaw.api、openclaw.transport,以及分類錯誤中的openclaw.errorCategory與openclaw.failureKind)openclaw.model_call.request_bytes(直方圖,最終模型請求承載資料的 UTF-8 位元組大小;不含原始承載資料內容)openclaw.model_call.response_bytes(直方圖,串流回應區塊承載資料的 UTF-8 位元組大小;高頻文字、思考及工具呼叫差異僅計入增量delta位元組;不含原始回應內容)openclaw.model_call.time_to_first_byte_ms(直方圖,第一個串流回應事件前經過的時間)openclaw.model.failover(計數器,屬性:openclaw.provider、openclaw.model、openclaw.failover.to_provider、openclaw.failover.to_model、openclaw.failover.reason、openclaw.failover.suspended、openclaw.lane)openclaw.skill.used(計數器,屬性:openclaw.skill.name、openclaw.skill.source、openclaw.skill.activation,選用openclaw.agent,選用openclaw.toolName)
訊息流程
openclaw.webhook.received(計數器,屬性:openclaw.channel、openclaw.webhook)openclaw.webhook.error(計數器,屬性:openclaw.channel、openclaw.webhook)openclaw.webhook.duration_ms(直方圖,屬性:openclaw.channel、openclaw.webhook)openclaw.message.queued(計數器,屬性:openclaw.channel、openclaw.source)openclaw.message.received(計數器,屬性:openclaw.channel、openclaw.source)openclaw.message.dispatch.started(計數器,屬性:openclaw.channel、openclaw.source)openclaw.message.dispatch.completed(計數器,屬性:openclaw.channel、openclaw.outcome、openclaw.reason、openclaw.source)openclaw.message.dispatch.duration_ms(直方圖,屬性:openclaw.channel、openclaw.outcome、openclaw.reason、openclaw.source)openclaw.message.processed(計數器,屬性:openclaw.channel、openclaw.outcome)openclaw.message.duration_ms(直方圖,屬性:openclaw.channel、openclaw.outcome)openclaw.message.delivery.started(計數器,屬性:openclaw.channel、openclaw.delivery.kind)openclaw.message.delivery.duration_ms(直方圖,屬性:openclaw.channel、openclaw.delivery.kind、openclaw.outcome、openclaw.errorCategory)
對話
openclaw.talk.event(計數器,屬性:openclaw.talk.event_type、openclaw.talk.mode、openclaw.talk.transport、openclaw.talk.brain、openclaw.talk.provider)openclaw.talk.event.duration_ms(直方圖,屬性:與openclaw.talk.event相同;當對話事件回報持續時間時發出)openclaw.talk.audio.bytes(直方圖,屬性:與openclaw.talk.event相同;針對回報位元組長度的對話音訊訊框事件發出)
佇列與工作階段
openclaw.queue.lane.enqueue(計數器,屬性:openclaw.lane)openclaw.queue.lane.dequeue(計數器,屬性:openclaw.lane)openclaw.queue.depth(直方圖,屬性:openclaw.lane或openclaw.channel=heartbeat)openclaw.queue.wait_ms(直方圖,屬性:openclaw.lane)openclaw.session.state(計數器,屬性:openclaw.state、openclaw.reason)openclaw.session.stuck(計數器,屬性:openclaw.state;針對可復原的過時工作階段簿記發出)openclaw.session.stuck_age_ms(直方圖,屬性:openclaw.state;針對可復原的過時工作階段簿記發出)openclaw.session.turn.created(計數器,屬性:openclaw.agent、openclaw.channel、openclaw.trigger)openclaw.session.recovery.requested(計數器,屬性:openclaw.state、openclaw.action、openclaw.active_work_kind、openclaw.reason)openclaw.session.recovery.completed(計數器,屬性:openclaw.state、openclaw.action、openclaw.status、openclaw.active_work_kind、openclaw.reason)openclaw.session.recovery.age_ms(直方圖,屬性:與相符的復原計數器相同)openclaw.run.attempt(計數器,屬性:openclaw.attempt)
工作階段存活遙測
diagnostics.stuckSessionWarnMs 是工作階段存活診斷的無進度時長門檻。
當 OpenClaw 觀察到回覆、工具、狀態、區塊或 ACP 執行階段
進度時,processing 工作階段不會累計朝向此
門檻的時長。輸入狀態保活不算進度,因此仍可偵測到無回應的模型或
測試框架。
OpenClaw 依其仍能觀察到的工作分類工作階段:
session.long_running:進行中的內嵌工作、模型呼叫或工具呼叫 仍持續取得進度。由擁有者管理的模型呼叫若靜默超過diagnostics.stuckSessionWarnMs,在到達diagnostics.stuckSessionAbortMs前也會回報為長時間執行,因此緩慢或非串流模型提供者 在仍可觀察中止狀態時,不會看起來像停滯的閘道工作階段。session.stalled:存在進行中的工作,但進行中的執行最近未回報 進度。由擁有者管理的模型呼叫會在達到或超過diagnostics.stuckSessionAbortMs時,從session.long_running切換為session.stalled;無擁有者的過時模型/工具活動不會被視為無害的長時間執行工作。 停滯的內嵌執行一開始僅進行觀察,之後若經過diagnostics.stuckSessionAbortMs仍無進度,便會進入中止並排空流程,讓該執行通道後方 排隊的回合得以繼續。未設定時,中止門檻預設為較安全的 延長時窗,即至少 5 分鐘且為diagnostics.stuckSessionWarnMs的 3 倍。session.stuck:沒有進行中工作的過時工作階段簿記,或具有過時且無擁有者 模型/工具活動的閒置排隊工作階段。通過復原閘門後,這會立即釋放 受影響的工作階段執行通道。
復原會發出結構化的 session.recovery.requested 與
session.recovery.completed 事件。只有在出現變更狀態的復原結果
(aborted 或 released),且同一處理世代仍為目前世代時,
診斷工作階段狀態才會標記為閒置。
只有 session.stuck 會發出 openclaw.session.stuck 計數器、
openclaw.session.stuck_age_ms 直方圖與 openclaw.session.stuck
span。當工作階段維持不變時,重複的 session.stuck 診斷會逐步退避,
因此儀表板應針對持續增加發出警示,而非每次
心跳偵測刻度。關於此設定選項與預設值,請參閱
設定參考。
存活警告也會發出:
openclaw.liveness.warning(計數器,屬性:openclaw.liveness.reason)openclaw.liveness.event_loop_delay_p99_ms(直方圖,屬性:openclaw.liveness.reason)openclaw.liveness.event_loop_delay_max_ms(直方圖,屬性:openclaw.liveness.reason)openclaw.liveness.event_loop_utilization(直方圖,屬性:openclaw.liveness.reason)openclaw.liveness.cpu_core_ratio(直方圖,屬性:openclaw.liveness.reason)
測試框架生命週期
openclaw.harness.duration_ms(直方圖,屬性:openclaw.harness.id、openclaw.harness.plugin、openclaw.outcome,錯誤時包含openclaw.harness.phase)
工具執行與迴圈偵測
openclaw.tool.execution.duration_ms(直方圖,屬性:gen_ai.tool.name、openclaw.toolName、openclaw.tool.source、openclaw.tool.owner、openclaw.tool.params.kind,錯誤時另含openclaw.errorCategory)openclaw.tool.execution.blocked(計數器,屬性:gen_ai.tool.name、openclaw.toolName、openclaw.tool.source、openclaw.tool.owner、openclaw.tool.params.kind、openclaw.deniedReason)openclaw.tool.loop(計數器,屬性:openclaw.toolName、openclaw.loop.level、openclaw.loop.action、openclaw.loop.detector、openclaw.loop.count,選用openclaw.loop.paired_tool;偵測到重複的工具呼叫迴圈時發出)
執行
openclaw.exec.duration_ms(直方圖,屬性:openclaw.exec.target、openclaw.exec.mode、openclaw.outcome、openclaw.failureKind)
診斷內部資料(記憶體、承載資料、匯出器健全狀態)
openclaw.payload.large(計數器,屬性:openclaw.payload.surface、openclaw.payload.action、openclaw.channel、openclaw.plugin、openclaw.reason)openclaw.payload.large_bytes(直方圖,屬性:與openclaw.payload.large相同)openclaw.memory.rss_bytes/openclaw.memory.heap_used_bytes/openclaw.memory.heap_total_bytes/openclaw.memory.external_bytes/openclaw.memory.array_buffers_bytes(直方圖,無屬性;處理程序記憶體樣本)openclaw.memory.pressure(計數器,屬性:openclaw.memory.level、openclaw.memory.reason)openclaw.diagnostic.async_queue.dropped(計數器,屬性:openclaw.diagnostic.async_queue.drop_class;內部診斷佇列因背壓而捨棄的項目)openclaw.telemetry.exporter.events(計數器,屬性:openclaw.exporter、openclaw.signal、openclaw.status,選用openclaw.reason,選用openclaw.errorCategory;匯出器生命週期/故障自我遙測)
匯出的 span
openclaw.model.usageopenclaw.channel、openclaw.provider、openclaw.modelopenclaw.tokens.*(input/output/cache_read/cache_write/total)- 預設為
gen_ai.system;選擇採用最新的 GenAI 語意慣例時則為gen_ai.provider.name gen_ai.request.model、gen_ai.operation.name、gen_ai.usage.*
openclaw.runopenclaw.outcome、openclaw.channel、openclaw.provider、openclaw.model、openclaw.errorCategory
openclaw.model.call- 預設為
gen_ai.system;選擇採用最新的 GenAI 語意慣例時則為gen_ai.provider.name gen_ai.request.model、gen_ai.operation.name、openclaw.provider、openclaw.model、openclaw.api、openclaw.transport- 發生錯誤時包含
openclaw.errorCategory、error.type,以及選用的openclaw.failureKind openclaw.model_call.request_bytes、openclaw.model_call.response_bytes、openclaw.model_call.time_to_first_byte_msopenclaw.model_call.prompt.input_messages_count、openclaw.model_call.prompt.input_messages_chars、openclaw.model_call.prompt.system_prompt_chars、openclaw.model_call.prompt.tool_definitions_count、openclaw.model_call.prompt.tool_definitions_chars、openclaw.model_call.prompt.total_chars(僅包含安全的元件大小,不包含提示詞文字)- 當模型呼叫結果包含該次個別呼叫的提供者用量時,包含
openclaw.model_call.usage.*和gen_ai.usage.* - 當上游提供者結果公開請求 ID 時,包含具有
openclaw.upstreamRequestIdHash屬性(有界、以雜湊為基礎)的追蹤範圍事件openclaw.provider.request;絕不匯出原始 ID - 使用
OTEL_SEMCONV_STABILITY_OPT_IN=gen_ai_latest_experimental時,模型呼叫追蹤範圍會使用最新的 GenAI 推論追蹤範圍名稱{gen_ai.operation.name} {gen_ai.request.model}和CLIENT追蹤範圍種類,而非openclaw.model.call。
- 預設為
openclaw.harness.runopenclaw.harness.id、openclaw.harness.plugin、openclaw.outcome、openclaw.provider、openclaw.model、openclaw.channel- 完成時:
openclaw.harness.result_classification、openclaw.harness.yield_detected、openclaw.harness.items.started、openclaw.harness.items.completed、openclaw.harness.items.active - 發生錯誤時:
openclaw.harness.phase、openclaw.errorCategory、選用的openclaw.harness.cleanup_failed
openclaw.tool.executiongen_ai.tool.name、gen_ai.operation.name(execute_tool)、openclaw.toolName、openclaw.tool.source、選用的gen_ai.tool.call.id、openclaw.tool.owner、openclaw.tool.params.*- 發生錯誤時可選擇包含
openclaw.errorCategory/openclaw.errorCode;遭原則或沙箱拒絕時包含openclaw.deniedReason和openclaw.outcome=blocked
openclaw.execopenclaw.exec.target、openclaw.exec.mode、openclaw.outcome、openclaw.failureKind、openclaw.exec.command_length、openclaw.exec.exit_code、openclaw.exec.exit_signal、openclaw.exec.timed_out
openclaw.webhook.processedopenclaw.channel、openclaw.webhook
openclaw.webhook.erroropenclaw.channel、openclaw.webhook、openclaw.error
openclaw.message.processedopenclaw.channel、openclaw.outcome、openclaw.reason
openclaw.message.deliveryopenclaw.channel、openclaw.delivery.kind、openclaw.outcome、openclaw.errorCategory、openclaw.delivery.result_count
openclaw.session.stuckopenclaw.state、openclaw.ageMs、openclaw.queueDepth
openclaw.context.assembledopenclaw.prompt.size、openclaw.history.size、openclaw.context.tokens、openclaw.errorCategory(不包含提示詞、歷史記錄、回應或工作階段金鑰內容)
openclaw.tool.loopopenclaw.toolName、openclaw.loop.level、openclaw.loop.action、openclaw.loop.detector、openclaw.loop.count、選用的openclaw.loop.paired_tool(不包含迴圈訊息、參數或工具輸出)
openclaw.memory.pressureopenclaw.memory.level、openclaw.memory.reason、openclaw.memory.rss_bytes、openclaw.memory.heap_used_bytes、openclaw.memory.heap_total_bytes、openclaw.memory.external_bytes、openclaw.memory.array_buffers_bytes、選用的openclaw.memory.threshold_bytes/openclaw.memory.rss_growth_bytes/openclaw.memory.window_ms
明確啟用內容擷取時,模型與工具追蹤範圍也可以針對你選擇採用的特定內容類別,包含有界且已遮蔽的 openclaw.content.* 屬性。
診斷事件目錄
下列事件為上述指標與追蹤範圍提供基礎。外掛也可以直接訂閱這些事件,而不必透過 OTLP 匯出。
模型用量
model.usage- 權杖、成本、持續時間、上下文、提供者/模型/頻道、工作階段 ID。usage是用於成本與遙測的提供者/回合計量;context.used是目前的提示詞/上下文快照。涉及快取輸入或工具迴圈呼叫時,其值可能低於提供者的usage.total。
訊息流程
webhook.received/webhook.processed/webhook.errormessage.queued/message.processedmessage.delivery.started/message.delivery.completed/message.delivery.error
佇列與工作階段
queue.lane.enqueue/queue.lane.dequeuesession.state/session.long_running/session.stalled/session.stuckrun.attempt/run.progressdiagnostic.heartbeat(彙總計數器:網路鉤子/佇列/工作階段)
執行框架生命週期
harness.run.started/harness.run.completed/harness.run.error- 代理程式執行框架的每次執行生命週期。包含harnessId、選用的pluginId、提供者/模型/頻道及執行 ID。完成時會新增durationMs、outcome、選用的resultClassification、yieldDetected和itemLifecycle計數。錯誤會新增phase(prepare/start/send/resolve/cleanup)、errorCategory和 選用的cleanupFailed。
命令執行
exec.process.completed- 終端結果、持續時間、目標、模式、結束 代碼和失敗種類。不包含命令文字和工作目錄。exec.approval.followup_suppressed- 工作階段重新繫結後,捨棄過時的核准後續處理。 包含approvalId、reason(session_rebound)、phase(direct_delivery或gateway_preflight) 和分派器時間戳記。不包含工作階段金鑰、路由和命令文字。
不使用匯出器
不執行 diagnostics-otel,仍可讓外掛或自訂接收端使用診斷事件:
{ diagnostics: { enabled: true },}若要在不提高 logging.level 的情況下輸出特定除錯資訊,請使用診斷旗標。旗標不區分大小寫,並支援萬用字元(telegram.* 或
*):
{ diagnostics: { flags: ["telegram.http"] },}或作為一次性的環境變數覆寫:
OPENCLAW_DIAGNOSTICS=telegram.http,telegram.payload openclaw gateway旗標輸出會寫入標準記錄檔(logging.file),且仍會由
logging.redactSensitive 遮蔽。完整指南:
診斷旗標。
停用
{ diagnostics: { otel: { enabled: false } },}或者不要將 diagnostics-otel 加入 plugins.allow,或執行
openclaw plugins disable diagnostics-otel。