# Tokenjuice

> 使用可选的 Tokenjuice 插件压缩冗杂的 Exec 和 bash 工具结果

- 网址：https://funcoding.ai/agents/openclaw/tools/tokenjuice/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/tools/tokenjuice

---
`tokenjuice` 是一个可选的外部插件，可在命令已运行后压缩冗杂的 `exec` 和 `bash`
工具结果。

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

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

## 启用插件

安装一次：

```bash
openclaw plugins install clawhub:@openclaw/tokenjuice
```

然后启用：

```bash
openclaw config set plugins.entries.tokenjuice.enabled true
```

等效命令：

```bash
openclaw plugins enable tokenjuice
```

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

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

## tokenjuice 会更改什么

- 在冗杂的 `exec` 和 `bash` 结果反馈到会话之前对其进行压缩。
- 保持原始命令执行不变。
- 应用安全清单策略：精确的文件内容读取保持原样，独立的仓库清单命令可以压缩，而不安全的混合命令序列保持原样。
- 保持选择性启用：如果你希望所有位置都使用逐字输出，请禁用该插件。

## 验证是否正常工作

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

## 禁用插件

```bash
openclaw config set plugins.entries.tokenjuice.enabled false
```

或者：

```bash
openclaw plugins disable tokenjuice
```

## 相关内容

- [Exec 工具](https://funcoding.ai/agents/openclaw/tools/exec/)
- [思考级别](https://funcoding.ai/agents/openclaw/tools/thinking/)
- [上下文引擎](https://funcoding.ai/agents/openclaw/concepts/context-engine/)