概述

tokenjuice 是可选内置插件,在 exec 和 bash 工具运行后压缩嘈杂的工具结果,减少返回到会话的 token 数量。不修改命令本身,不重新运行命令,不改变退出码。

核心功能

  • 压缩 exec 和 bash 工具结果(在命令运行后)
  • 保留精确的文件内容读取和其他应保持原始的命令
  • 适用于 PI 嵌入式运行和 Codex app-server harness 中的 OpenClaw 动态工具
  • 通过工具结果中间件钩子工作

配置/使用

启用:

openclaw config set plugins.entries.tokenjuice.enabled true
# 或
openclaw plugins enable tokenjuice

JSON 配置:

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

禁用:

openclaw config set plugins.entries.tokenjuice.enabled false

验证

  1. 启用插件
  2. 启动可调用 exec 的会话
  3. 运行嘈杂命令(如 git status)
  4. 检查返回的工具结果是否比原始 shell 输出更短、更结构化

相关页面

  • concepts/tool-exec — Exec 工具(tokenjuice 压缩的目标工具)
  • context-engine — 上下文引擎(token 管理)
  • concepts/tool-thinking — Thinking 级别