From e5d514495da672f278de6bb1d8089ddfa3718b31 Mon Sep 17 00:00:00 2001 From: sh1hsh1nk <13179671+sm86@users.noreply.github.com> Date: Tue, 7 Apr 2026 22:44:19 +0700 Subject: [PATCH 1/4] docs: Replace inline HTML with pure markdown in Contexto README ClawHub's markdown renderer does not support inline HTML - all

, ,

, tags were being escaped and displayed as raw text. Converted to pure markdown for clean rendering on ClawHub. --- packages/contexto/README.md | 45 +++++++++---------------------------- 1 file changed, 11 insertions(+), 34 deletions(-) diff --git a/packages/contexto/README.md b/packages/contexto/README.md index ca41547..8b4a90e 100644 --- a/packages/contexto/README.md +++ b/packages/contexto/README.md @@ -1,19 +1,13 @@ -

Contexto

-

Keep long-running OpenClaw agents reliable after the context window fills.

-

A drop-in OpenClaw context engine that retrieves old constraints instead of losing them to summaries.

- -

- Quick Start  •   - Why Contexto  •   - How It Works  •   - Website  •   - Discord -

- -

- OpenClaw works well until long sessions start compacting away the exact instruction that mattered.
- Contexto is the context engine built for that failure mode. -

+# Contexto + +**Keep long-running OpenClaw agents reliable after the context window fills.** + +A drop-in OpenClaw context engine that retrieves old constraints instead of losing them to summaries. + +[Quick Start](#quick-start) · [Why Contexto](#why-contexto) · [How It Works](#how-it-works) · [Website](https://getcontexto.com/) · [Discord](https://discord.gg/4QTRS5ew) + +OpenClaw works well until long sessions start compacting away the exact instruction that mattered. +Contexto is the context engine built for that failure mode. ## The Problem in 15 Seconds @@ -26,10 +20,6 @@ Do NOT delete anything." tools, retries, compaction ...] ``` -
- - - - -
- **Without Contexto** ```text @@ -37,9 +27,6 @@ Turn 35: Agent deletes 12 flagged emails. The constraint was lost in compaction. ``` - - **With Contexto** ```text @@ -51,10 +38,6 @@ Retrieved context: The instruction survives compaction. ``` -
- ## Why Contexto Contexto is a context engine for OpenClaw. It is built for the exact moment OpenClaw starts dropping or blurring the context your agent still needs: @@ -109,10 +92,6 @@ If you are deciding whether this is worth installing, this is the short version. | **Can you explain what was retrieved?** | No | Yes, full path tracing (`travel -> Japan -> visa docs`) | | **Setup time** | Built-in | One plugin install, one config key | -

- Before and after Contexto: without Contexto the full session is pushed directly to the model, with Contexto the runtime sends scoped context through Contexto before it reaches the LLM. -

- ## How It Works Contexto turns aging conversation history into a searchable context tree instead of a lossy summary blob. @@ -184,6 +163,4 @@ Apache 2.0. See [LICENSE](LICENSE). --- -

- If long-session reliability matters to you, star the repo and help other OpenClaw users discover it. -

+If long-session reliability matters to you, star the repo and help other OpenClaw users discover it. From 30613b810495d7a85114a28ab490b0a36d2f40ca Mon Sep 17 00:00:00 2001 From: sh1hsh1nk <13179671+sm86@users.noreply.github.com> Date: Tue, 7 Apr 2026 22:47:38 +0700 Subject: [PATCH 2/4] docs: Clean up README for ClawHub and bump to 0.1.12 - Remove roadmap, contributing link, and simplify license line - Fix package.json description casing and wording - Bump version to 0.1.12 --- packages/contexto/README.md | 11 +---------- packages/contexto/package.json | 4 ++-- 2 files changed, 3 insertions(+), 12 deletions(-) diff --git a/packages/contexto/README.md b/packages/contexto/README.md index 8b4a90e..c57cc22 100644 --- a/packages/contexto/README.md +++ b/packages/contexto/README.md @@ -142,24 +142,15 @@ interface ContextoBackend { } ``` -## Roadmap - -- [ ] Horizontal scaling with sub-agent context delegation -- [ ] Scoped context with access boundaries -- [ ] Knowledge from external documents -- [ ] Local backend -- [ ] Context sharing across agents - ## Community - [Discord](https://discord.gg/4QTRS5ew) - [Discussions](https://github.com/ekailabs/contexto/discussions) - [Issues](https://github.com/ekailabs/contexto/issues) -- [Contributing guide](CONTRIBUTING.md) ## License -Apache 2.0. See [LICENSE](LICENSE). +Apache 2.0 --- diff --git a/packages/contexto/package.json b/packages/contexto/package.json index 48b9682..42c9ffc 100644 --- a/packages/contexto/package.json +++ b/packages/contexto/package.json @@ -1,7 +1,7 @@ { "name": "@ekai/contexto", - "version": "0.1.11", - "description": "Openclaw plugin for smart context management", + "version": "0.1.12", + "description": "Context Engine for Long-running OpenClaw agents", "type": "module", "license": "Apache-2.0", "publishConfig": { From 46a8373168ddd470ab60d17d8da2820a6dfe7a55 Mon Sep 17 00:00:00 2001 From: sh1hsh1nk <13179671+sm86@users.noreply.github.com> Date: Tue, 7 Apr 2026 22:51:52 +0700 Subject: [PATCH 3/4] docs: Trim config table to apiKey only in both READMEs --- README.md | 10 +++------- packages/contexto/README.md | 10 +++------- 2 files changed, 6 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index 214801f..13bdd13 100644 --- a/README.md +++ b/README.md @@ -146,13 +146,9 @@ For the deeper technical reasoning: ## Configuration -| Property | Type | Required | Default | Description | -| --- | --- | --- | --- | --- | -| `apiKey` | string | Yes | — | Your Contexto API key | -| `contextEnabled` | boolean | No | `true` | Enable or disable context injection | -| `maxContextChars` | number | No | — | Max characters for injected context | -| `compactThreshold` | number (0-1) | No | `0.50` | Ingest and evict at this share of token budget | -| `compactionStrategy` | `'sliding-window' \| 'default'` | No | `'default'` | Compaction strategy | +| Property | Type | Required | Description | +| --- | --- | --- | --- | +| `apiKey` | string | Yes | Your Contexto API key | ## Custom Backends diff --git a/packages/contexto/README.md b/packages/contexto/README.md index c57cc22..5212722 100644 --- a/packages/contexto/README.md +++ b/packages/contexto/README.md @@ -118,13 +118,9 @@ For the deeper technical reasoning: ## Configuration -| Property | Type | Required | Default | Description | -| --- | --- | --- | --- | --- | -| `apiKey` | string | Yes | — | Your Contexto API key | -| `contextEnabled` | boolean | No | `true` | Enable or disable context injection | -| `maxContextChars` | number | No | — | Max characters for injected context | -| `compactThreshold` | number (0-1) | No | `0.50` | Ingest and evict at this share of token budget | -| `compactionStrategy` | `'sliding-window' \| 'default'` | No | `'default'` | Compaction strategy | +| Property | Type | Required | Description | +| --- | --- | --- | --- | +| `apiKey` | string | Yes | Your Contexto API key | ## Custom Backends From 8e9162f9cccd5cdc26a72d162ce44684a766c626 Mon Sep 17 00:00:00 2001 From: sh1hsh1nk <13179671+sm86@users.noreply.github.com> Date: Tue, 7 Apr 2026 22:58:04 +0700 Subject: [PATCH 4/4] docs: Trim package README for ClawHub marketplace - Remove Custom Backends section (developer-facing) - Remove star-the-repo footer (GitHub-specific) - Keep Under the Hood section with blog links --- packages/contexto/README.md | 18 ------------------ 1 file changed, 18 deletions(-) diff --git a/packages/contexto/README.md b/packages/contexto/README.md index 5212722..a2762af 100644 --- a/packages/contexto/README.md +++ b/packages/contexto/README.md @@ -122,22 +122,6 @@ For the deeper technical reasoning: | --- | --- | --- | --- | | `apiKey` | string | Yes | Your Contexto API key | -## Custom Backends - -The engine talks to storage through `ContextoBackend`. The default remote backend calls `api.getcontexto.com`, but you can implement your own. - -```ts -interface ContextoBackend { - ingest(payload: WebhookPayload | WebhookPayload[]): Promise; - search( - query: string, - maxResults: number, - filter?: Record, - minScore?: number - ): Promise; -} -``` - ## Community - [Discord](https://discord.gg/4QTRS5ew) @@ -149,5 +133,3 @@ interface ContextoBackend { Apache 2.0 --- - -If long-session reliability matters to you, star the repo and help other OpenClaw users discover it.