openclaw-langfuse-plugin

OpenClaw plugin for reporting AI agent execution traces to Langfuse. Captures full agent lifecycle including LLM calls, tool executions, messages, and session events.

Install

openclaw plugins install openclaw-langfuse-plugin

Configure

Add the plugin config to your openclaw.json:

Single Langfuse target

{
  "plugins": {
    "allow": ["openclaw-langfuse-plugin"],
    "entries": {
      "openclaw-langfuse-plugin": {
        "enabled": true,
        "config": {
          "publicKey": "pk-lf-xxx",
          "secretKey": "sk-lf-xxx",
          "baseUrl": "http://your-langfuse:3000"
        }
      }
    }
  }
}

Multiple Langfuse targets

Send traces to multiple Langfuse instances simultaneously:

{
  "plugins": {
    "allow": ["openclaw-langfuse-plugin"],
    "entries": {
      "openclaw-langfuse-plugin": {
        "enabled": true,
        "config": {
          "targets": [
            {
              "name": "production",
              "publicKey": "pk-lf-xxx",
              "secretKey": "sk-lf-xxx",
              "baseUrl": "http://langfuse-prod:3000"
            },
            {
              "name": "analytics",
              "publicKey": "pk-lf-yyy",
              "secretKey": "sk-lf-yyy",
              "baseUrl": "http://langfuse-analytics:3000"
            }
          ]
        }
      }
    }
  }
}

Or via CLI

openclaw plugins enable openclaw-langfuse-plugin

Then edit ~/.openclaw/openclaw.json to add your Langfuse credentials.

Config Options

| Option | Type | Default | Description | |--------|------|---------|-------------| | publicKey | string | — | Langfuse public key (single target mode) | | secretKey | string | — | Langfuse secret key (single target mode) | | baseUrl | string | https://cloud.langfuse.com | Langfuse server URL | | targets | array | — | Multiple Langfuse targets (overrides single key config) | | debug | boolean | false | Enable debug logging | | enabledHooks | string[] | all | List of hooks to enable |

Available Hooks

session_start, session_end, message_received, message_sending, message_sent, llm_input, llm_output, before_tool_call, after_tool_call, before_agent_start, agent_end, gateway_start

What Gets Captured

| Data | Source Hook | Level | |------|------------|-------| | User input | message_received | Full content | | LLM system prompt | llm_input | Full content | | LLM conversation history | llm_input | Full messages | | LLM response | llm_output | Full text + usage | | Tool call params & results | before/after_tool_call | Full content | | Agent duration & stats | agent_end | Metrics | | Session lifecycle | session_start/end | Events |

Update

openclaw plugins update

Uninstall

openclaw plugins uninstall openclaw-langfuse-plugin

License

Apache-2.0