What's new for you
Context engine plugins, persistent ACP channel bindings, Telegram topic routing, Spanish locale, gateway auth mode, Gemini 3.1 Flash-Lite, Docker slim builds, and many fixes. Requires explicit gateway.auth.mode when both token and password are set.
- Context Engine plugins — alternative context management via plugins (e.g. lossless-claw) without modifying core
- Persistent ACP bindings — Discord channel and Telegram topic bindings survive restarts
- Telegram topic agent routing — per-topic agentId overrides in forum groups and DM topics
- Spanish locale — Control UI now supports es
- Gateway auth mode — set gateway.auth.mode when both token and password are configured
- Gemini 3.1 Flash-Lite — first-class support across provider catalogs
- Docker slim builds — multi-stage Dockerfile, OPENCLAW_VARIANT=slim for smaller images
- Compaction model override — route summarization through a different model via agents.defaults.compaction.model
Release highlights
| Feature | Details |
|---|---|
| Context Engine Plugin | Plugin slot for alternative context management. Lifecycle hooks: bootstrap, ingest, assemble, compact, afterTurn, prepareSubagentSpawn, onSubagentEnded. Enables lossless-claw and similar plugins. |
| Persistent ACP Bindings | Discord channel and Telegram topic bindings survive restarts. CLI and docs support for managing bindings. |
| Telegram Topic Routing | Per-topic agentId overrides in forum groups and DM topics. Route topics to dedicated agents with isolated sessions. |
| Spanish Locale | Control UI now supports es — locale detection, lazy loading, language picker. |
| Gateway Auth Mode | Explicit gateway.auth.mode required when both token and password are set. Avoids startup/pairing failures. |
| Gemini 3.1 Flash-Lite | First-class google/gemini-3.1-flash-lite-preview support across model normalization and docs. |
| Docker Slim Builds | Multi-stage Dockerfile, minimal runtime image. OPENCLAW_VARIANT=slim for bookworm-slim. |
| Compaction Model Override | agents.defaults.compaction.model routes summarization through a different model than the main session. |
⚠️ Breaking changes
Gateway auth now requires explicit gateway.auth.mode when both gateway.auth.token and gateway.auth.password are configured (including SecretRefs). Set gateway.auth.mode to token or password before upgrade.
Feature deep dives
Learn more about the changes that matter most. Bug fixes and minor improvements are listed on GitHub.
Context Engine Plugin
Plugin slot for alternative context management strategies. Lifecycle hooks, slot-based registry, LegacyContextEngine wrapper. Enables plugins like lossless-claw without modifying core compaction.
Read more →Persistent ACP Bindings
Durable Discord channel and Telegram topic binding storage. Bindings survive restarts and can be managed via CLI.
Read more →Telegram Topic Routing
Per-topic agentId overrides in forum groups and DM topics. Route topics to dedicated agents with isolated sessions.
Read more →Spanish Locale
Control UI now supports Spanish (es) — locale detection, lazy loading, language picker labels.
Read more →Gateway Auth Mode
Explicit gateway.auth.mode required when both token and password are configured. Set to token or password before upgrade.
Read more →Gemini 3.1 Flash-Lite
First-class google/gemini-3.1-flash-lite-preview support across model-id normalization, aliases, and docs.
Read more →Docker Slim Builds
Multi-stage Dockerfile produces minimal runtime image. OPENCLAW_VARIANT=slim for bookworm-slim variant.
Read more →Compaction Model Override
agents.defaults.compaction.model routes compaction summarization through a different model than the main session.
Read more →Full release notes
The complete changelog with all changes, fixes, and technical details is on the official GitHub release page.
Open v2026.3.7 on GitHub →