Crawler Summary

events-framework answer-first brief

A local-first, 0-token Events Framework for OpenClaw: append JSONL event records from scripts/monitors, apply dedupe/merge/quiet-hours policies, and proactively notify a Telegram chat with user-friendly messages. Control plane never calls a model; any analysis is on-demand only. --- name: events-framework description: >- A local-first, 0-token Events Framework for OpenClaw: append JSONL event records from scripts/monitors, apply dedupe/merge/quiet-hours policies, and proactively notify a Telegram chat with user-friendly messages. Control plane never calls a model; any analysis is on-demand only. version: 0.1.0 author: Zjianru license: MIT compatibility: >- Requires Python 3.10+ on the gatewa Published capability contract available. No trust telemetry is available yet. Last updated 3/1/2026.

Freshness

Last checked 3/1/2026

Best For

Contract is available with explicit auth and schema references.

Not Ideal For

events-framework is not ideal for teams that need stronger public trust telemetry, lower setup complexity, or more explicit contract coverage before production rollout.

Evidence Sources Checked

editorial-content, capability-contract, runtime-metrics, public facts pack

Claim this agent
Agent DossierGitHubSafety: 89/100

events-framework

A local-first, 0-token Events Framework for OpenClaw: append JSONL event records from scripts/monitors, apply dedupe/merge/quiet-hours policies, and proactively notify a Telegram chat with user-friendly messages. Control plane never calls a model; any analysis is on-demand only. --- name: events-framework description: >- A local-first, 0-token Events Framework for OpenClaw: append JSONL event records from scripts/monitors, apply dedupe/merge/quiet-hours policies, and proactively notify a Telegram chat with user-friendly messages. Control plane never calls a model; any analysis is on-demand only. version: 0.1.0 author: Zjianru license: MIT compatibility: >- Requires Python 3.10+ on the gatewa

OpenClawself-declared

Public facts

6

Change events

1

Artifacts

0

Freshness

Mar 1, 2026

Verifiededitorial-contentNo verified compatibility signals

Published capability contract available. No trust telemetry is available yet. Last updated 3/1/2026.

Schema refs publishedTrust evidence available

Trust score

Unknown

Compatibility

OpenClaw

Freshness

Mar 1, 2026

Vendor

Zjianru

Artifacts

0

Benchmarks

0

Last release

Unpublished

Executive Summary

Key links, install path, and a quick operational read before the deeper crawl record.

Verifiededitorial-content

Summary

Published capability contract available. No trust telemetry is available yet. Last updated 3/1/2026.

Setup snapshot

git clone https://github.com/Zjianru/events-framework.git
  1. 1

    Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.

  2. 2

    Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Evidence Ledger

Everything public we have scraped or crawled about this agent, grouped by evidence type with provenance.

Verifiededitorial-content
Vendor (1)

Vendor

Zjianru

profilemedium
Observed Mar 1, 2026Source linkProvenance
Compatibility (2)

Protocol compatibility

OpenClaw

contractmedium
Observed Feb 24, 2026Source linkProvenance

Auth modes

api_key

contracthigh
Observed Feb 24, 2026Source linkProvenance
Artifact (1)

Machine-readable schemas

OpenAPI or schema references published

contracthigh
Observed Feb 24, 2026Source linkProvenance
Security (1)

Handshake status

UNKNOWN

trustmedium
Observed unknownSource linkProvenance
Integration (1)

Crawlable docs

6 indexed pages on the official domain

search_documentmedium
Observed Apr 15, 2026Source linkProvenance

Release & Crawl Timeline

Merged public release, docs, artifact, benchmark, pricing, and trust refresh events.

Self-declaredagent-index

Artifacts Archive

Extracted files, examples, snippets, parameters, dependencies, permissions, and artifact metadata.

Self-declaredGITHUB OPENCLEW

Extracted files

0

Examples

3

Snippets

0

Languages

typescript

Parameters

Executable Examples

bash

python3 ~/.openclaw/net/open-source/events-framework/events-router.py validate-config --config-file ~/.openclaw/net/config/events.json
python3 ~/.openclaw/net/open-source/events-framework/events-router.py selftest

bash

python3 ~/.openclaw/net/open-source/events-framework/events-router.py tick --config-file ~/.openclaw/net/config/events.json --print-only

bash

python3 ~/.openclaw/net/open-source/events-framework/events-router.py emit --code "TEST/HELLO" --title "事件框架自检" --level info --summary "这是一条测试事件"
python3 ~/.openclaw/net/open-source/events-framework/events-router.py tick --print-only

Docs & README

Full documentation captured from public sources, including the complete README when available.

Self-declaredGITHUB OPENCLEW

Docs source

GITHUB OPENCLEW

Editorial quality

ready

A local-first, 0-token Events Framework for OpenClaw: append JSONL event records from scripts/monitors, apply dedupe/merge/quiet-hours policies, and proactively notify a Telegram chat with user-friendly messages. Control plane never calls a model; any analysis is on-demand only. --- name: events-framework description: >- A local-first, 0-token Events Framework for OpenClaw: append JSONL event records from scripts/monitors, apply dedupe/merge/quiet-hours policies, and proactively notify a Telegram chat with user-friendly messages. Control plane never calls a model; any analysis is on-demand only. version: 0.1.0 author: Zjianru license: MIT compatibility: >- Requires Python 3.10+ on the gatewa

Full README

name: events-framework description: >- A local-first, 0-token Events Framework for OpenClaw: append JSONL event records from scripts/monitors, apply dedupe/merge/quiet-hours policies, and proactively notify a Telegram chat with user-friendly messages. Control plane never calls a model; any analysis is on-demand only. version: 0.1.0 author: Zjianru license: MIT compatibility: >- Requires Python 3.10+ on the gateway host. Uses openclaw message send when available; otherwise falls back to Telegram HTTP API using the bot token in openclaw.json.

Events Framework(Event Inbox + Event Router)— OpenClaw Skill (MVP)

目标:把“主动通知(事件)→ 限频/合并/静默 → Telegram 推送”做成 0-token 的可复用能力。

这套技能由两部分组成:

  • events-router.py:纯本地脚本(0-token),负责读取 event inbox、路由、限频/合并、静默时段、发送 Telegram
  • events.json:声明式配置(sources/静默时段/合并频率/限频策略)

Quickstart (local)

推荐布局(本仓库 net 的约定):

  • ~/.openclaw/net/tools/events-router.py(本机 wrapper,便于本机特殊策略)
  • ~/.openclaw/net/open-source/events-framework/events-router.py(权威源,可开源)
  • ~/.openclaw/net/config/events.json(配置)
  • ~/.openclaw/net/state/events-router.json(状态,自动生成)
  • ~/.openclaw/net/work/events/inbox.jsonl(inbox,自动生成)

验证:

python3 ~/.openclaw/net/open-source/events-framework/events-router.py validate-config --config-file ~/.openclaw/net/config/events.json
python3 ~/.openclaw/net/open-source/events-framework/events-router.py selftest

手动跑一轮(只打印,不发送):

python3 ~/.openclaw/net/open-source/events-framework/events-router.py tick --config-file ~/.openclaw/net/config/events.json --print-only

写入一个测试事件(append 到 inbox):

python3 ~/.openclaw/net/open-source/events-framework/events-router.py emit --code "TEST/HELLO" --title "事件框架自检" --level info --summary "这是一条测试事件"
python3 ~/.openclaw/net/open-source/events-framework/events-router.py tick --print-only

Message format (Telegram)

  • 同一 Telegram chat 里混合“对话 + 事件通知”,事件通知使用稳定前缀以便识别。
  • 定时快报(L1):【事件快报】(<窗口>),按 registry 的 code 顺序输出事件摘要,并列出窗口期内“无进度/空白”的任务。
  • 立即通道(L1):【事件告警】...,仅在 level=alertactionRequired=true 时投递。
  • 默认不展示内部 id/JSON(详情用 detail 子命令输出)。

Reference docs

  • Spec (Chinese, detailed): EVENTS_FRAMEWORK.md

Contract & API

Machine endpoints, protocol fit, contract coverage, invocation examples, and guardrails for agent-to-agent use.

Verifiedcapability-contract

Contract coverage

Status

ready

Auth

api_key

Streaming

No

Data region

global

Protocol support

OpenClaw: self-declared

Requires: openclew, lang:typescript

Forbidden: none

Guardrails

Operational confidence: medium

Contract is available with explicit auth and schema references.
Trust confidence is not low and verification freshness is acceptable.
Invocation examples
curl -s "https://xpersona.co/api/v1/agents/zjianru-events-framework/snapshot"
curl -s "https://xpersona.co/api/v1/agents/zjianru-events-framework/contract"
curl -s "https://xpersona.co/api/v1/agents/zjianru-events-framework/trust"

Reliability & Benchmarks

Trust and runtime signals, benchmark suites, failure patterns, and practical risk constraints.

Missingruntime-metrics

Trust signals

Handshake

UNKNOWN

Confidence

unknown

Attempts 30d

unknown

Fallback rate

unknown

Runtime metrics

Observed P50

unknown

Observed P95

unknown

Rate limit

unknown

Estimated cost

unknown

No benchmark suites or observed failure patterns are available.

Media & Demo

Every public screenshot, visual asset, demo link, and owner-provided destination tied to this agent.

Missingno-media
No screenshots, media assets, or demo links are available.

Related Agents

Neighboring agents from the same protocol and source ecosystem for comparison and shortlist building.

Self-declaredprotocol-neighbors
GITHUB_REPOSactivepieces

Rank

70

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

Traction

No public download signal

Freshness

Updated 2d ago

OPENCLAW
GITHUB_REPOScherry-studio

Rank

70

AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs

Traction

No public download signal

Freshness

Updated 5d ago

MCPOPENCLAW
GITHUB_REPOSAionUi

Rank

70

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

Traction

No public download signal

Freshness

Updated 6d ago

MCPOPENCLAW
GITHUB_REPOSCopilotKit

Rank

70

The Frontend for Agents & Generative UI. React + Angular

Traction

No public download signal

Freshness

Updated 23d ago

OPENCLAW
Machine Appendix

Contract JSON

{
  "contractStatus": "ready",
  "authModes": [
    "api_key"
  ],
  "requires": [
    "openclew",
    "lang:typescript"
  ],
  "forbidden": [],
  "supportsMcp": false,
  "supportsA2a": false,
  "supportsStreaming": false,
  "inputSchemaRef": "https://github.com/Zjianru/events-framework#input",
  "outputSchemaRef": "https://github.com/Zjianru/events-framework#output",
  "dataRegion": "global",
  "contractUpdatedAt": "2026-02-24T19:44:21.510Z",
  "sourceUpdatedAt": "2026-02-24T19:44:21.510Z",
  "freshnessSeconds": 4420401
}

Invocation Guide

{
  "preferredApi": {
    "snapshotUrl": "https://xpersona.co/api/v1/agents/zjianru-events-framework/snapshot",
    "contractUrl": "https://xpersona.co/api/v1/agents/zjianru-events-framework/contract",
    "trustUrl": "https://xpersona.co/api/v1/agents/zjianru-events-framework/trust"
  },
  "curlExamples": [
    "curl -s \"https://xpersona.co/api/v1/agents/zjianru-events-framework/snapshot\"",
    "curl -s \"https://xpersona.co/api/v1/agents/zjianru-events-framework/contract\"",
    "curl -s \"https://xpersona.co/api/v1/agents/zjianru-events-framework/trust\""
  ],
  "jsonRequestTemplate": {
    "query": "summarize this repo",
    "constraints": {
      "maxLatencyMs": 2000,
      "protocolPreference": [
        "OPENCLEW"
      ]
    }
  },
  "jsonResponseTemplate": {
    "ok": true,
    "result": {
      "summary": "...",
      "confidence": 0.9
    },
    "meta": {
      "source": "GITHUB_OPENCLEW",
      "generatedAt": "2026-04-16T23:37:42.773Z"
    }
  },
  "retryPolicy": {
    "maxAttempts": 3,
    "backoffMs": [
      500,
      1500,
      3500
    ],
    "retryableConditions": [
      "HTTP_429",
      "HTTP_503",
      "NETWORK_TIMEOUT"
    ]
  }
}

Trust JSON

{
  "status": "unavailable",
  "handshakeStatus": "UNKNOWN",
  "verificationFreshnessHours": null,
  "reputationScore": null,
  "p95LatencyMs": null,
  "successRate30d": null,
  "fallbackRate": null,
  "attempts30d": null,
  "trustUpdatedAt": null,
  "trustConfidence": "unknown",
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Capability Matrix

{
  "rows": [
    {
      "key": "OPENCLEW",
      "type": "protocol",
      "support": "unknown",
      "confidenceSource": "profile",
      "notes": "Listed on profile"
    }
  ],
  "flattenedTokens": "protocol:OPENCLEW|unknown|profile"
}

Facts JSON

[
  {
    "factKey": "docs_crawl",
    "category": "integration",
    "label": "Crawlable docs",
    "value": "6 indexed pages on the official domain",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  },
  {
    "factKey": "vendor",
    "category": "vendor",
    "label": "Vendor",
    "value": "Zjianru",
    "href": "https://github.com/Zjianru/events-framework",
    "sourceUrl": "https://github.com/Zjianru/events-framework",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-03-01T06:04:18.293Z",
    "isPublic": true
  },
  {
    "factKey": "protocols",
    "category": "compatibility",
    "label": "Protocol compatibility",
    "value": "OpenClaw",
    "href": "https://xpersona.co/api/v1/agents/zjianru-events-framework/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/zjianru-events-framework/contract",
    "sourceType": "contract",
    "confidence": "medium",
    "observedAt": "2026-02-24T19:44:21.510Z",
    "isPublic": true
  },
  {
    "factKey": "auth_modes",
    "category": "compatibility",
    "label": "Auth modes",
    "value": "api_key",
    "href": "https://xpersona.co/api/v1/agents/zjianru-events-framework/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/zjianru-events-framework/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:44:21.510Z",
    "isPublic": true
  },
  {
    "factKey": "schema_refs",
    "category": "artifact",
    "label": "Machine-readable schemas",
    "value": "OpenAPI or schema references published",
    "href": "https://github.com/Zjianru/events-framework#input",
    "sourceUrl": "https://xpersona.co/api/v1/agents/zjianru-events-framework/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:44:21.510Z",
    "isPublic": true
  },
  {
    "factKey": "handshake_status",
    "category": "security",
    "label": "Handshake status",
    "value": "UNKNOWN",
    "href": "https://xpersona.co/api/v1/agents/zjianru-events-framework/trust",
    "sourceUrl": "https://xpersona.co/api/v1/agents/zjianru-events-framework/trust",
    "sourceType": "trust",
    "confidence": "medium",
    "observedAt": null,
    "isPublic": true
  }
]

Change Events JSON

[
  {
    "eventType": "docs_update",
    "title": "Docs refreshed: Sign in to GitHub · GitHub",
    "description": "Fresh crawlable documentation was indexed for the official domain.",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  }
]

Sponsored

Ads related to events-framework and adjacent AI workflows.