Appearance
在 OpenClaw 中使用 exec 或 bash 工具时,如果原始 shell 输出过于冗长(如 git status),可以启用内置的 tokenjuice 插件自动压缩结果。它只改写返回的 tool_result,不修改命令本身、不重跑命令、不改变 exit code。启用命令:openclaw config set plugins.entries.tokenjuice.enabled true 或 openclaw plugins enable tokenjuice;禁用时两种方式均可对应。
OpenClaw Tokenjuice 插件配置:压缩 exec/bash 工具输出
tokenjuice 是 OpenClaw 内置的可选插件,用于在 exec 和 bash 工具执行完成后,自动压缩冗长的输出结果。
它改变的是返回的 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 tokenjuiceOpenClaw 已自带该插件,无需执行 plugins install 或 tokenjuice install openclaw 等额外安装步骤。
如果你更习惯直接编辑配置文件:
json5
{
plugins: {
entries: {
tokenjuice: {
enabled: true,
},
},
},
}Tokenjuice 改变了什么
- 在
exec和bash结果被回灌到会话之前,压缩其中噪音较大的输出。 - 原始命令执行过程不受影响。
- 保留对文件内容的精确读取以及其它 tokenjuice 应保持原样的命令输出。
- 插件为按需启用:如果你希望所有工具都返回未经处理的原始输出,关闭该插件即可。
怎么验证 Tokenjuice 是否生效
- 启用插件。
- 启动一个能调用
exec的会话。 - 运行一条会产生大量输出的命令,例如
git status。 - 检查返回的工具结果是否比原始 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 等操作。