Skip to content

在 OpenClaw 中使用 exec 或 bash 工具时,如果原始 shell 输出过于冗长(如 git status),可以启用内置的 tokenjuice 插件自动压缩结果。它只改写返回的 tool_result,不修改命令本身、不重跑命令、不改变 exit code。启用命令:openclaw config set plugins.entries.tokenjuice.enabled trueopenclaw plugins enable tokenjuice;禁用时两种方式均可对应。

OpenClaw Tokenjuice 插件配置:压缩 exec/bash 工具输出

tokenjuice 是 OpenClaw 内置的可选插件,用于在 execbash 工具执行完成后,自动压缩冗长的输出结果。

它改变的是返回的 tool_result,而不是命令本身。Tokenjuice 不会改写 shell 输入、不会重新运行命令、也不会改变命令的退出码(exit code)。

目前,该插件作用于 PI 嵌入式运行以及 Codex 应用服务器框架中 OpenClaw 动态工具的调用链。Tokenjuice 挂载到 OpenClaw 的工具结果中间件,在结果返回给当前会话前进行修剪。

怎么启用 Tokenjuice 插件

快速启用:

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

等效命令:

bash
openclaw plugins enable tokenjuice

OpenClaw 已自带该插件,无需执行 plugins installtokenjuice install openclaw 等额外安装步骤。

如果你更习惯直接编辑配置文件:

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

Tokenjuice 改变了什么

  • execbash 结果被回灌到会话之前,压缩其中噪音较大的输出。
  • 原始命令执行过程不受影响。
  • 保留对文件内容的精确读取以及其它 tokenjuice 应保持原样的命令输出。
  • 插件为按需启用:如果你希望所有工具都返回未经处理的原始输出,关闭该插件即可。

怎么验证 Tokenjuice 是否生效

  1. 启用插件。
  2. 启动一个能调用 exec 的会话。
  3. 运行一条会产生大量输出的命令,例如 git status
  4. 检查返回的工具结果是否比原始 shell 输出更简短、更结构化。

怎么禁用 Tokenjuice 插件

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

或:

bash
openclaw plugins disable tokenjuice

常见问题

Tokenjuice 会影响命令的退出码吗?

不会。Tokenjuice 只处理返回的 tool_result,不会改变命令的 exit code、不会重新运行命令、也不会修改 shell 输入。

启用 Tokenjuice 后,某些命令的输出被错误地压缩了怎么办?

插件设计上会保留对文件内容的精确读取等应保持原样的输出。如果遇到意外压缩,可以暂时禁用该插件,并在 OpenClaw 仓库 提交 issue 反馈。

Tokenjuice 需要额外安装吗?

不需要。OpenClaw 已内置该插件,启用命令即可,无需 plugins install 等操作。

相关文档