# Send Context Optimizer to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "context-optimizer",
    "name": "Context Optimizer",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/ad2546/context-optimizer",
    "canonicalUrl": "https://clawhub.ai/ad2546/context-optimizer",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/context-optimizer",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=context-optimizer",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "chat-logger.js",
      "SUMMARY.md",
      "INSTALL.md",
      "README.md",
      "package.json",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "context-optimizer",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T15:23:05.820Z",
      "expiresAt": "2026-05-06T15:23:05.820Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=context-optimizer",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=context-optimizer",
        "contentDisposition": "attachment; filename=\"context-optimizer-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "context-optimizer"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/context-optimizer"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/context-optimizer",
    "downloadUrl": "https://openagent3.xyz/downloads/context-optimizer",
    "agentUrl": "https://openagent3.xyz/skills/context-optimizer/agent",
    "manifestUrl": "https://openagent3.xyz/skills/context-optimizer/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/context-optimizer/agent.md"
  }
}
```
## Documentation

### Context Pruner

Advanced context management optimized for DeepSeek's 64k context window. Provides intelligent pruning, compression, and token optimization to prevent context overflow while preserving important information.

### Key Features

DeepSeek-optimized: Specifically tuned for 64k context window
Adaptive pruning: Multiple strategies based on context usage
Semantic deduplication: Removes redundant information
Priority-aware: Preserves high-value messages
Token-efficient: Minimizes token overhead
Real-time monitoring: Continuous context health tracking

### Auto-compaction with dynamic context:

import { createContextPruner } from './lib/index.js';

const pruner = createContextPruner({
  contextLimit: 64000, // DeepSeek's limit
  autoCompact: true,    // Enable automatic compaction
  dynamicContext: true, // Enable dynamic relevance-based context
  strategies: ['semantic', 'temporal', 'extractive', 'adaptive'],
  queryAwareCompaction: true, // Compact based on current query relevance
});

await pruner.initialize();

// Process messages with auto-compaction and dynamic context
const processed = await pruner.processMessages(messages, currentQuery);

// Get context health status
const status = pruner.getStatus();
console.log(\`Context health: ${status.health}, Relevance scores: ${status.relevanceScores}\`);

// Manual compaction when needed
const compacted = await pruner.autoCompact(messages, currentQuery);

### Archive Retrieval (Hierarchical Memory):

// When something isn't in current context, search archive
const archiveResult = await pruner.retrieveFromArchive('query about previous conversation', {
  maxContextTokens: 1000,
  minRelevance: 0.4,
});

if (archiveResult.found) {
  // Add relevant snippets to current context
  const archiveContext = archiveResult.snippets.join('\\n\\n');
  // Use archiveContext in your prompt
  console.log(\`Found ${archiveResult.sources.length} relevant sources\`);
  console.log(\`Retrieved ${archiveResult.totalTokens} tokens from archive\`);
}

### Auto-Compaction Strategies

Semantic Compaction: Merges similar messages instead of removing them
Temporal Compaction: Summarizes older conversations by time windows
Extractive Compaction: Extracts key information from verbose messages
Adaptive Compaction: Chooses best strategy based on message characteristics
Dynamic Context: Filters messages based on relevance to current query

### Dynamic Context Management

Query-aware Relevance: Scores messages based on similarity to current query
Relevance Decay: Relevance scores decay over time for older conversations
Adaptive Filtering: Automatically filters low-relevance messages
Priority Integration: Combines message priority with semantic relevance

### Hierarchical Memory System

The context archive provides a RAM vs Storage approach:

Current Context (RAM): Limited (64k tokens), fast access, auto-compacted
Archive (Storage): Larger (100MB), slower but searchable
Smart Retrieval: When information isn't in current context, efficiently search archive
Selective Loading: Extract only relevant snippets, not entire documents
Automatic Storage: Compacted content automatically stored in archive

### Configuration

{
  contextLimit: 64000, // DeepSeek's context window
  autoCompact: true, // Enable automatic compaction
  compactThreshold: 0.75, // Start compacting at 75% usage
  aggressiveCompactThreshold: 0.9, // Aggressive compaction at 90%
  
  dynamicContext: true, // Enable dynamic context management
  relevanceDecay: 0.95, // Relevance decays 5% per time step
  minRelevanceScore: 0.3, // Minimum relevance to keep
  queryAwareCompaction: true, // Compact based on current query relevance
  
  strategies: ['semantic', 'temporal', 'extractive', 'adaptive'],
  preserveRecent: 10, // Always keep last N messages
  preserveSystem: true, // Always keep system messages
  minSimilarity: 0.85, // Semantic similarity threshold
  
  // Archive settings
  enableArchive: true, // Enable hierarchical memory system
  archivePath: './context-archive',
  archiveSearchLimit: 10,
  archiveMaxSize: 100 * 1024 * 1024, // 100MB
  archiveIndexing: true,
  
  // Chat logging
  logToChat: true, // Log optimization events to chat
  chatLogLevel: 'brief', // 'brief', 'detailed', or 'none'
  chatLogFormat: '📊 {action}: {details}', // Format for chat messages
  
  // Performance
  batchSize: 5, // Messages to process in batch
  maxCompactionRatio: 0.5, // Maximum 50% compaction in one pass
}

### Chat Logging

The context optimizer can log events directly to chat:

// Example chat log messages:
// 📊 Context optimized: Compacted 15 messages → 8 (47% reduction)
// 📊 Archive search: Found 3 relevant snippets (42% similarity)
// 📊 Dynamic context: Filtered 12 low-relevance messages

// Configure logging:
const pruner = createContextPruner({
  logToChat: true,
  chatLogLevel: 'brief', // Options: 'brief', 'detailed', 'none'
  chatLogFormat: '📊 {action}: {details}',
  
  // Custom log handler (optional)
  onLog: (level, message, data) => {
    if (level === 'info' && data.action === 'compaction') {
      // Send to chat
      console.log(\`🧠 Context optimized: ${message}\`);
    }
  }
});

### Integration with Clawdbot

Add to your Clawdbot config:

skills:
  context-pruner:
    enabled: true
    config:
      contextLimit: 64000
      autoPrune: true

The pruner will automatically monitor context usage and apply appropriate pruning strategies to stay within DeepSeek's 64k limit.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ad2546
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T15:23:05.820Z
- Expires at: 2026-05-06T15:23:05.820Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/context-optimizer)
- [Send to Agent page](https://openagent3.xyz/skills/context-optimizer/agent)
- [JSON manifest](https://openagent3.xyz/skills/context-optimizer/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/context-optimizer/agent.md)
- [Download page](https://openagent3.xyz/downloads/context-optimizer)