@clawlauncher/claw-activity-monitor
v0.1.6
Published
Streams OpenClaw agent activity to the Claw Launcher dashboard.
Readme
@clawlauncher/claw-activity-monitor
OpenClaw plugin that streams agent activity to the Claw Launcher control plane.
Provisioned automatically when you launch a bot through Claw Launcher — no manual install required. Self-hosted OpenClaw users can install it directly from npm.
Requirements
- OpenClaw
>= 2026.5.0(self-hosted on2026.4.xshould stay on0.1.5— see CHANGELOG) - Node.js
>= 22.12.0
Setup (self-hosted)
npm install @clawlauncher/claw-activity-monitorPlace the package in any OpenClaw plugin discovery directory, then update your openclaw.json to grant the plugin conversation-access. This step is required on OpenClaw 2026.5.x — without it, three hooks (llm_input, llm_output, agent_end) are silently blocked by the gateway and the plugin will run without observing turn lifecycle events:
{
"plugins": {
"entries": {
"claw-activity-monitor": {
"enabled": true,
"hooks": {
"allowConversationAccess": true
}
}
}
}
}Verify the configuration took effect:
openclaw plugins inspect claw-activity-monitor --runtime --jsonLook for policy.allowConversationAccess: true and an empty diagnostics array. Diagnostics like typed hook "llm_input" blocked because non-bundled plugins must set ...allowConversationAccess=true indicate the flag isn't set yet.
Configuration
The plugin reads one required environment variable: OPENCLAW_GATEWAY_TOKEN. The Claw Launcher control plane sets this at provisioning time. If it isn't set, the plugin logs an error and exits register() cleanly.
License
Proprietary — Copyright © 2026 Claw Launcher. All rights reserved.
This package is closed-source: source code lives in a private repository and is licensed, not sold. You may install and run it as part of an authorized Claw Launcher deployment. Copying, redistribution, modification, reverse engineering, sublicensing, and competing-product use are not permitted without prior written consent.
Full terms in LICENSE.
