> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tokenjuice

`tokenjuice` is an optional external plugin that compacts noisy `exec` and `bash`
tool results after the command has already run.

It changes the returned `tool_result`, not the command itself. Tokenjuice does
not rewrite shell input, rerun commands, or change exit codes.

Today this applies to OpenClaw embedded runs and OpenClaw dynamic tools in the Codex
app-server harness. Tokenjuice hooks OpenClaw's tool-result middleware and
trims the output before it goes back into the active harness session.

## Enable the plugin

Install once:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install clawhub:@openclaw/tokenjuice
```

Then enable it:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw config set plugins.entries.tokenjuice.enabled true
```

Equivalent:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins enable tokenjuice
```

If you prefer editing config directly:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  plugins: {
    entries: {
      tokenjuice: {
        enabled: true,
      },
    },
  },
}
```

## What tokenjuice changes

* Compacts noisy `exec` and `bash` results before they are fed back into the session.
* Keeps the original command execution untouched.
* Applies a safe-inventory policy: exact file-content reads stay raw, standalone repository-inventory commands can compact, and unsafe mixed command sequences stay raw.
* Stays opt-in: disable the plugin if you want verbatim output everywhere.

## Verify it is working

1. Enable the plugin.
2. Start a session that can call `exec`.
3. Run a noisy command such as `git status`.
4. Check that the returned tool result is shorter and more structured than the raw shell output.

## Disable the plugin

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw config set plugins.entries.tokenjuice.enabled false
```

Or:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins disable tokenjuice
```

## Related

* [Exec tool](/tools/exec)
* [Thinking levels](/tools/thinking)
* [Context engine](/concepts/context-engine)