OpenClaw

Overview

Pulse installs an OpenClaw hook package that forwards OpenClaw events to pulse emit.

All spans are tagged with source: "openclaw".

Quick start

Requires a running Pulse trace service and a configured Pulse CLI.

1. Configure CLI credentials and endpoint.

pulse init

2. Connect OpenClaw hooks.

pulse connect

If prompted to choose an integration, select OpenClaw.

3. Confirm integration health.

pulse status

Integration behavior

Detection path: ~/.openclaw/
Installed hook path: ~/.openclaw/hooks/pulse-hook/

Pulse installs:

• HOOK.md (hook metadata)
• handler.ts (event handler)

pulse connect only modifies Pulse’s hook directory and does not alter other OpenClaw hooks.

Events captured

OpenClaw event	Pulse event	Notes
command:new	session_start	New session created
command:stop	stop	Session stopped
command:reset	session_end	reason="reset"
message:received	user_prompt_submit	Captures prompt text
message:sent	notification	Agent notification/message

Span fields

Field	Description
span_id	UUID v4 span identifier
session_id	OpenClaw session identifier
timestamp	Event timestamp (ISO 8601)
source	openclaw
kind	Event category
event_type	Concrete event name
status	success or error
tool_name	Tool name when applicable
tool_input	Tool input payload
tool_response	Tool output payload
error	Error object for failed events
metadata	Integration and environment metadata

Debugging

For setup validation:

export PULSE_DEBUG=1

After running OpenClaw, inspect status and logs:

pulse status

For CLI-wide troubleshooting, see CLI Reference.