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

# Tokenjuice

`tokenjuice` 是一个可选的外部插件，会在命令已经运行完成后，对冗长的 `exec` 和 `bash`
工具结果进行压缩。

它改变的是返回的 `tool_result`，而不是命令本身。Tokenjuice 不会重写 shell 输入、重新运行命令，或更改退出代码。

目前，这适用于 OpenClaw 的内嵌运行，以及 Codex
app-server harness 中的 OpenClaw 动态工具。Tokenjuice 会挂接到 OpenClaw 的工具结果中间件，并在结果返回到当前 harness 会话之前对输出进行裁剪。

## 启用插件

安装一次：

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

然后启用它：

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

等效方式：

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

如果你更喜欢直接编辑配置：

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

## tokenjuice 会改变什么

* 在嘈杂的 `exec` 和 `bash` 结果被重新反馈到会话之前，将它们压缩。
* 保持原始命令执行不变。
* 应用安全清单策略：精确的文件内容读取保持原样，独立的仓库清单命令可以压缩，而不安全的混合命令序列保持原样。
* 保持可选启用：如果你希望所有地方都输出逐字内容，请禁用该插件。

## 验证它是否正常工作

1. 启用插件。
2. 启动一个可以调用 `exec` 的会话。
3. 运行一个冗长的命令，例如 `git status`。
4. 检查返回的工具结果是否比原始 shell 输出更短且更有结构。

## 禁用插件

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

或者：

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

## 相关内容

* [Exec 工具](/tools/exec)
* [思考级别](/tools/thinking)
* [上下文引擎](/concepts/context-engine)