تخطَّ إلى المحتوى
TakoAPI
العودة إلى المهارات

context-compactor

بواسطة emberdesire

CLI Utilities
1.1kالتنزيلات وفق ما يذكره clawskills.sh
0المشاهدات
لا إعجاباتسجّل الدخول للإعجاب بهذه المهارة
—لم يُقيَّم بعد
تقييمك

موجز

Token-based context compaction for local models (MLX, llama.cpp, Ollama) that don't report context limits.

الوصف

ما الذي تفعله هذه المهارة

Client-side token estimation plugin for OpenClaw that proactively summarizes older messages before local models silently truncate or corrupt context. Works with MLX, llama.cpp, and Ollama, which don't report context overflow errors the way cloud APIs do. Configurable thresholds let you tune behavior per model size.

Built-in OpenClaw compaction only triggers when the model reports an overflow error, which local models rarely do, so this plugin catches the problem before it silently corrupts the session.

متى تستخدمها

  • Running long coding sessions with an 8K MLX model without losing conversation history
  • Debugging why a local model started returning garbled responses mid-session
  • Checking token usage before hitting a context limit with /context-stats
  • Forcing a fresh summary cache when context feels stale
  • Tuning compaction thresholds for a 4K vs 32K local model

مثال على سير العمل

الإدخال

User sends a message in a long session using an MLX 8K model

الوكيل
  1. 1

    before_agent_start hook fires and estimates total context tokens

  2. 2

    Plugin counts ~6,800 tokens against the 8,000 maxTokens threshold

  3. 3

    Splits messages into old (to summarize) and recent (to keep within keepRecentTokens)

  4. 4

    Calls the session model to generate a summary of old messages and caches it

  5. 5

    Injects the summary plus recent messages as the new context before the agent responds

الإخراج

Agent responds normally with full context awareness, without the model ever seeing a truncated or overflowed input

التثبيت

clawhub install emberdesire/context-compactor

شغّل أمر واجهة سطر الأوامر، أو الصق النص في Claude Code أو Cursor أو Codex أو أي وكيل برمجة تستخدمه.

الروابط