Tools 导读

Tokenjuice:它会替你伸哪只手

Tokenjuice 不是名词卡片,而是一只会伸出来帮忙的手。你要看清它什么时候出手、抓进去什么、递回来什么,还有每个参数到底像哪颗按钮。原文最响的一记鼓点,其实是:tokenjuice is an optional bundled 新本领插件 that compacts noisy exec and bash 工具小帮手 results…。

先讲这一页到底在解决什么

Tokenjuice:它会替你伸哪只手

Tokenjuice 不是名词卡片,而是一只会伸出来帮忙的手。你要看清它什么时候出手、抓进去什么、递回来什么,还有每个参数到底像哪颗按钮。原文最响的一记鼓点,其实是:tokenjuice is an optional bundled 新本领插件 that compacts noisy exec and bash 工具小帮手 results…。

原文共 6 节,先看 Start Here 路径:/tools/tokenjuice 查看官方原文

第一站

它整理的是“回来的结果”,不是“出去的命令”

这是理解 Tokenjuice 最重要的一点。命令照常执行,退出码照常保留;插件只是在结果回到 harness session 之前,把噪音压一压。

不会重跑命令

它不是觉得输出太长就重新试一次,也不会偷偷改 shell 输入。

不会改变成败

命令成功就是成功,失败就是失败。Tokenjuice 只整理呈现,不改事实。

适用位置

目前它作用在 PI embedded runs 和 Codex app-server harness 的 OpenClaw dynamic tools 上。

一句话

它是结果压缩器,不是命令代理。

第二站

什么时候它很有用

当一个命令输出特别啰嗦,而 agent 只需要知道重点时,Tokenjuice 可以帮忙省上下文。

1

长输出

例如特别长的状态、日志、列表,原样塞回去会占很多 token。

2

结构化一点

它会尽量把噪音变短,让 agent 更快看出哪里重要。

3

保留原样场景

精确读文件内容这类场景不该乱压缩,Tokenjuice 会尽量保留原始内容。

4

保持可选

如果你要所有输出都逐字逐句原样回来,可以关掉这个插件。

第三站

开关很简单,验证也很简单

启用时设置 plugins.entries.tokenjuice.enabled true;关闭时设成 false,或用插件禁用命令。

启用

openclaw config set plugins.entries.tokenjuice.enabled true

关闭

openclaw config set plugins.entries.tokenjuice.enabled false,也可以 openclaw plugins disable tokenjuice

怎么确认

启用后跑一个比较吵的命令,比如 git status,看回来的工具结果是不是更短、更整齐。

记住边界

如果你在排查“命令到底原样吐了什么”,那就先关掉它,避免压缩影响判断。

最后总结

把 Tokenjuice 压成一句话

它是可选的工具结果压缩器:命令照跑、退出码照算,只把太吵的输出整理得更省上下文。