hansjone/oclaw
1
0
Fork 0
mirror of https://github.com/hansjone/oclaw.git synced 2026-10-10 23:30:53 +08:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
oclaw/docs/openclaw-trace-taxonomy.md
oliver ba3836f00f 初始化：独立 oclaw 仓库首提交 
- 在 oclaw/ 下重新初始化 Git 仓库
- 补齐子仓库 .gitignore，避免提交本地运行态数据（_local、node_modules、logs 等）
- 提交当前工程代码与配置

Made-with: Cursor
2026-04-24 22:31:22 +08:00

2.4 KiB
Raw Blame History

oclaw trace taxonomy

Trace events share a common payload shape across components. Prefer joining on trace_id, pipeline, and oc_stage.

Stable keys

Key Meaning
trace_id Correlates all events for one gateway turn
pipeline Which subsystem emitted the event (openclaw_gateway, openclaw_agent_core, openclaw_direct_loop, openclaw_skill_executor)
oc_stage Normalized lifecycle stage (see tables below)
lang Request language when known
run_id Agent core run UUID (retry container)
attempt_no 1-based attempt index inside run_id
openclaw_task_id Async worker task id when present
openclaw_worker_id Worker thread id when present

Gateway (pipeline=openclaw_gateway)

event_type oc_stage
gateway_received ingress
gateway_normalized normalize
skill_manifest skills_manifest
memory_retrieval_started memory_start
memory_retrieval_finished memory_done
router_decision route
task_enqueued async_enqueue
runtime_config runtime_config
response_sent response

gateway_received payload now includes relay pointer stats:

  • relay_pointer_count: number of direct pointer attachments on inbound message
  • relay_envelope_present: whether metadata.relay_share_envelope exists
  • relay_envelope_pointer_count: pointer count inside envelope manifest

Agent core (pipeline=openclaw_agent_core)

event_type oc_stage
run_started run_start
attempt_started attempt
attempt_finished attempt_done
run_finished run_done
run_compact compact
run_retry retry

Direct loop (pipeline=openclaw_direct_loop)

event_type oc_stage
tool_wire_filter wire_filter
tool_result_context_guard tool_context_guard

Both include trace_id and, when provided by the parent attempt, run_id and attempt_no.

Skill executor (pipeline=openclaw_skill_executor)

event_type oc_stage
skill_selected skill_select
skill_executed skill_done

The payload includes run_id and attempt_no when available, so skill execution can be joined back to run_started/attempt_started.

Attempt memory hook (pipeline=openclaw_agent_core)

event_type oc_stage
after_turn_memory memory_done