> ## 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` 是一个可选的外部插件，会在命令已经运行后压缩嘈杂的 `exec` 和 `bash`
工具结果。

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

目前，这适用于 Codex app-server harness 中的 OpenClaw 嵌入式运行和 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 工具](/zh-CN/tools/exec)
* [思考级别](/zh-CN/tools/thinking)
* [上下文引擎](/zh-CN/concepts/context-engine)