Tokenjuice

기준일: 2026-07-26
난이도: 중급
공식 기준: Tokenjuice

개요

이 페이지는 OpenClaw Tokenjuice 도구(파라미터, 권한, 설정, CLI)를 공식 문서 기준으로 정리합니다.

공식 요약: Compact noisy exec and bash tool results with the optional Tokenjuice plugin

도구 가시성은 profile / allow·deny policy / sandbox / channel 권한에 따라 달라집니다. 최신 스키마는 항상 공식 문서를 우선합니다.

공식 문서 기반 상세

아래는 공식 tools/tokenjuice 문서를 정리한 내용입니다. 코드 블록, 파라미터 이름, 기본값은 원문 그대로입니다.

tokenjuice is an optional external plugin that compacts noisy exec and bash tool results after the command has already run.

It changes the returned tool_result, not the command itself. Tokenjuice does not rewrite shell input, rerun commands, or change exit codes.

Today this applies to OpenClaw embedded runs and OpenClaw dynamic tools in the Codex app-server harness. Tokenjuice hooks OpenClaw's tool-result middleware and trims the output before it goes back into the active harness session.

Enable the plugin

Install once:

openclaw plugins install clawhub:@openclaw/tokenjuice

Then enable it:

openclaw config set plugins.entries.tokenjuice.enabled true

Equivalent:

openclaw plugins enable tokenjuice

If you prefer editing config directly:

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

What tokenjuice changes

• Compacts noisy exec and bash results before they are fed back into the session.
• Keeps the original command execution untouched.
• Applies a safe-inventory policy: exact file-content reads stay raw, standalone repository-inventory commands can compact, and unsafe mixed command sequences stay raw.
• Stays opt-in: disable the plugin if you want verbatim output everywhere.

Verify it is working

1. Enable the plugin.
2. Start a session that can call exec.
3. Run a noisy command such as git status.
4. Check that the returned tool result is shorter and more structured than the raw shell output.

Disable the plugin

openclaw config set plugins.entries.tokenjuice.enabled false

Or:

openclaw plugins disable tokenjuice

관련 문서

• Exec tool
• Thinking levels
• Context engine

검증 체크리스트

• 해당 tool이 활성 profile/policy에서 허용되는지 확인
• sandbox / elevated / host 실행 경로 정책을 이해했는지 확인
• 채널·에이전트 권한과 충돌하지 않는지 확인
• 공식 CLI/--help와 문서 옵션이 버전과 맞는지 확인

관련

• Tools 목록 인덱스
• 공식: Tools overview, Tools and custom providers