Tokenjuice Plugin: Reduce Clutter from Exec and Bash Tool Outputs

Learn how the optional Tokenjuice plugin condenses noisy exec and bash tool results in OpenClaw runs. This page explains installation, activation, and what changes Tokenjuice makes to tool outputs.

Read this when

  • You want shorter `exec` or `bash` tool results in OpenClaw
  • You want to install or enable the Tokenjuice plugin
  • You need to understand what tokenjuice changes and what it leaves raw

tokenjuice is an optional external plugin that reduces clutter from exec and bash tool outputs after command execution finishes.

It modifies the tool_result that gets returned, leaving the command itself unchanged. Tokenjuice does not alter shell input, re-execute commands, or modify exit codes.

Currently this works with OpenClaw embedded runs and OpenClaw dynamic tools inside the Codex app-server harness. Tokenjuice intercepts OpenClaw's tool-result middleware and shortens the output before it re-enters the active harness session.

Enable the plugin

Install one time:

openclaw plugins install clawhub:@openclaw/tokenjuice

Then activate it:

openclaw config set plugins.entries.tokenjuice.enabled true

Same effect:

openclaw plugins enable tokenjuice

To edit configuration directly:

{
  plugins: {
    entries: {
      tokenjuice: {
        enabled: true,
      },
    },
  },
}

What tokenjuice changes

  • Condenses noisy exec and bash results before they return to the session.
  • Leaves the original command execution untouched.
  • Uses a safe-inventory approach: exact file reads stay raw, standalone repository-inventory commands may be compacted, and unsafe mixed command sequences remain raw.
  • Requires opt-in: turn off the plugin to get full output everywhere.

Verify it is working

  1. Turn on the plugin.
  2. Launch a session that can invoke exec.
  3. Run a verbose command like git status.
  4. Verify the returned tool result is shorter and better organized than the raw shell output.

Disable the plugin

openclaw config set plugins.entries.tokenjuice.enabled false

Alternatively:

openclaw plugins disable tokenjuice
255 words · updated Jul 27, 2026