Tokenless 配置与数据隐私

Tokenless 默认启用压缩、本地统计和 SLS 度量。由于本地统计和 Stash 可能包含完整工具输出或被截断的原始 Payload，处理源代码、凭证和生产日志前应先确认这些默认值。

配置优先级

正常路径下，每个开关使用以下优先级：

环境变量 > ~/.tokenless/config.json > 默认值

空环境变量视为未设置。布尔环境变量中，1、true、yes（大小写不敏感）表示 true；其他非空值表示 false。为了可读性，建议明确使用 true 或 false。

当前实现有一个例外：当 TOKENLESS_STATS_ENABLED 和 TOKENLESS_SLS_ENABLED 都是非空值时，代码会完全跳过配置文件。在这个分支中，压缩开关优先使用 TOKENLESS_COMPRESSION_ENABLED；未设置时直接默认为 true。如果同时导出两个记录开关，也应显式导出压缩开关。

配置文件

配置路径：

~/.tokenless/config.json

完整示例：

{
  "stats_enabled": true,
  "sls_enabled": true,
  "compression_enabled": true
}

配置文件缺失、不可读或 JSON 无效时，当前代码会静默使用内存中的全 true 默认值。手动编辑后可先验证：

jq . ~/.tokenless/config.json

字段	默认值	实际行为
`stats_enabled`	`true`	把压缩前后文本和度量写入本地 SQLite
`sls_enabled`	`true`	目标 JSONL 文件已存在时追加仅包含度量的记录
`compression_enabled`	`true`	为 true 时返回压缩结果；false 时进入 dry-run 并返回原文

Tokenless 写入配置文件时会把权限限制为 0600。手动创建文件后也应确认：

chmod 600 ~/.tokenless/config.json

stats 子命令只修改 stats_enabled：

tokenless stats status
tokenless stats enable
tokenless stats disable

执行这些命令后，环境变量覆盖仍然优先。例如 TOKENLESS_STATS_ENABLED=0 tokenless stats enable 会把文件保存为 true，但带有该环境变量的进程仍会关闭统计。

环境变量

用户常用变量

变量	用途	约束
`TOKENLESS_STATS_ENABLED`	覆盖本地统计开关	不影响 SLS 或 Stash
`TOKENLESS_SLS_ENABLED`	覆盖 SLS 度量开关	不影响本地统计
`TOKENLESS_COMPRESSION_ENABLED`	覆盖真实压缩开关	false 是 dry-run，不是完全停用
`TOKENLESS_DATA_DIR`	存放 `stats.db` 和 `stash.db` 的目录	须为真实用户 home 下的绝对路径
`TOKENLESS_STATS_DB`	覆盖统计数据库路径	CLI 和随包 RTK 写入器都会校验真实用户 home 边界，并忽略无效值
`TOKENLESS_STASH_DB`	覆盖 Stash 数据库路径	必须位于真实用户 home 下
`TOKENLESS_SLS_PATH`	覆盖 SLS JSONL 路径	必须位于 `/var/log/` 或 `/tmp/` 下

Adapter 和诊断变量

变量	用途
`TOKENLESS_AGENT_ID`	Adapter 注入的 Agent 标识
`TOKENLESS_SESSION_ID`	Adapter 注入的 Session 标识
`TOKENLESS_TOOL_USE_ID`	Adapter 注入的工具调用标识
`TOKENLESS_TOOL_READY_SPEC`	覆盖 Tool Ready 依赖规范路径
`TOKENLESS_ENV_FIX_SCRIPT`	覆盖环境修复脚本路径
`TOKENLESS_PACKAGE_MANAGER`	覆盖包管理器探测，主要用于测试

后面三项会经过信任路径或运行环境校验，不建议普通用户修改。

数据库路径优先级如下：

统计库：TOKENLESS_STATS_DB > TOKENLESS_DATA_DIR/stats.db > ~/.tokenless/stats.db
stash 库：--stash-db > TOKENLESS_STASH_DB > TOKENLESS_DATA_DIR/stash.db > ~/.tokenless/stash.db

CLI 和随包 RTK 写入器都会按真实用户 home 校验 Stats 路径。无效的 TOKENLESS_STATS_DB 会被跳过；TOKENLESS_DATA_DIR 也必须通过相同的边界校验，否则使用默认路径。

空值视为未设置。TOKENLESS_DATA_DIR 可以指向尚不存在的目录；Tokenless 会先校验其最近的已存在父目录，再创建目标目录。该变量不会迁移 ~/.tokenless/config.json 或 SLS JSONL 输出。

本地与外部数据

数据	默认路径	默认内容	保留方式	如何停止新增
本地统计	`~/.tokenless/stats.db`	压缩前后完整文本、标识和度量	无自动 TTL，直到清理	`tokenless stats disable`
Stash	`~/.tokenless/stash.db`	截断时移除的原始字符串、数组尾部、深层子树和 Schema 描述	TTL 1 小时、最多 10,000 个有效条目，过期行延迟清理	CLI 使用 `--no-stash`；Agent 场景禁用 Adapter
配置	`~/.tokenless/config.json`	三个布尔开关	持续保留	不适用
SLS JSONL	`/var/log/anolisa/sls/ops/tokenless.jsonl`	度量和标识，不含压缩原文	由 SLS/Logtail 设施管理	`TOKENLESS_SLS_ENABLED=0` 或配置为 false

本地统计的敏感性

stats.db 的 before_text 和 after_text 保存完整内容。tokenless stats show 会输出这些内容，单记录和 tool-use 级别的 tokenless stats diff 可以据此显示变化行。这些文本可能包含：

源代码和补丁。
命令输出中的路径、用户名或环境信息。
API 返回的业务数据。
日志中的访问令牌、Cookie 或凭证。

tokenless CLI 的 SQLite Recorder 每次打开 stats.db 时都会尝试设置 0600。随包提供的 RTK 统计补丁也可以直接创建或打开同一个文件，但它本身不会执行该权限修改。不要依赖进程 umask，应检查数据库及 sidecar 文件：

ls -l ~/.tokenless/stats.db*

Stash 的敏感性

Stash 保存压缩时被截断的原始内容，而不是摘要。仅因字段在黑名单中、值为 null 或为空而被移除的内容不会写入 Stash。tokenless CLI 会把路径限制在真实用户 home 下，但仍应确认数据库及 SQLite sidecar 文件不会被其他本机用户读取：

ls -l ~/.tokenless/stash.db*

TTL 表示条目超过一小时后不能再通过 retrieve 返回。过期行会在后续取回时延迟删除；TTL 不应被理解为立即安全擦除磁盘数据。当有效条目超过 10,000 个时，存储会优先淘汰到期时间最早的条目，因此高负载下可能不到一小时就无法取回。

SLS 不包含原文

Tokenless 的 SLS JSONL 只写入组件、Operation、Session/Tool Use 标识和字符/Token 度量，不写 before_text 或 after_text。但标识字段本身仍可能属于组织的运行元数据，应按照平台日志策略管理。

敏感工作负载建议

只压缩，不保存统计

TOKENLESS_STATS_ENABLED=0 \
TOKENLESS_SLS_ENABLED=0 \
  tokenless compress-response --no-stash -f response.json

这适用于独立 CLI。Agent Adapter 默认可能使用 Stash；如果框架没有合适的排除规则，应对敏感任务禁用 Adapter。

保留 Adapter，但不实际压缩

在启动 Agent 的环境中设置：

export TOKENLESS_COMPRESSION_ENABLED=0

这是 dry-run，仍可能写入本地统计或 SLS。若不希望落盘，还需同时关闭：

export TOKENLESS_STATS_ENABLED=0
export TOKENLESS_SLS_ENABLED=0

Dry-run 不会创建 Stash 条目，但也不会关闭 RTK 重写或 Tool Ready。需要停止这些行为时应禁用 Adapter。

完全停止 Agent 中的 Tokenless

anolisa adapter disable tokenless <framework>

禁用后重启 Agent。仅设置 compression_enabled=false 不会停止 Hook/Plugin 执行。

清理数据

清空本地统计记录：

tokenless stats clear --yes

该命令会清空当前环境解析到的统计库记录，但不会删除数据库文件或 SQLite sidecar。Tokenless 当前没有 Stash clear 子命令。需要不可逆地删除本地数据库时：

先禁用所有 Tokenless Adapter。
退出仍可能使用数据库的 Agent、MCP 服务和 Tokenless 进程。
确认不再需要历史统计和 Stash 取回。
备份需要保留的数据。
在启动 Agent、服务和 Tokenless 的实际环境中检查路径覆盖：

env | grep -E '^TOKENLESS_(DATA_DIR|STATS_DB|STASH_DB)='

统计库按 TOKENLESS_STATS_DB、TOKENLESS_DATA_DIR/stats.db、~/.tokenless/stats.db 的顺序解析；Stash 按命令行 --stash-db、TOKENLESS_STASH_DB、TOKENLESS_DATA_DIR/stash.db、~/.tokenless/stash.db 的顺序解析。把最终路径写成经过确认的绝对路径，不要把未经验证的环境变量直接展开到删除命令中。

下面的命令同时适用于默认路径和自定义路径。先替换并再次打印两个路径，确认它们都是需要删除的 Tokenless 数据库：

stats_db='/absolute/path/to/resolved/stats.db'
stash_db='/absolute/path/to/resolved/stash.db'
printf '%s\n' "$stats_db" "$stash_db"
rm -f -- \
  "$stats_db" \
  "$stats_db-wal" \
  "$stats_db-shm" \
  "$stats_db-journal" \
  "$stash_db" \
  "$stash_db-wal" \
  "$stash_db-shm" \
  "$stash_db-journal"

该操作不可恢复。不要把数据目录或 ~/.tokenless/ 作为递归删除目标，因为其中还可能包含希望保留的配置或其他文件。

OpenClaw 的细粒度控制

OpenClaw Plugin 还提供框架级选项：

选项	作用
`rtk_enabled`	命令重写
`tool_ready_enabled`	Tool Ready 检查
`response_compression_enabled`	响应压缩
`toon_compression_enabled`	TOON 编码
`skip_tools`	完全跳过压缩的工具名列表
`shell_tools`	按 Shell/exec 策略处理中等截断的工具名
`verbose`	Plugin 诊断日志

OpenClaw Adapter 当前未实现 Schema 压缩；需要时可以直接调用 tokenless compress-schema CLI 命令。

运行时代码默认开启 RTK、Tool Ready 和响应压缩，默认关闭 TOON。当前运行时代码把未提供的 verbose 当作开启，但 Plugin Schema 声明的默认值是关闭；在二者统一前应显式设置 verbose。

这些值由 OpenClaw Plugin 配置管理，不属于 ~/.tokenless/config.json。修改后按 OpenClaw 提示重启 gateway。

配置优先级​

配置文件​

环境变量​

用户常用变量​

Adapter 和诊断变量​

本地与外部数据​

本地统计的敏感性​

Stash 的敏感性​

SLS 不包含原文​

敏感工作负载建议​

只压缩，不保存统计​

保留 Adapter，但不实际压缩​

完全停止 Agent 中的 Tokenless​

清理数据​

OpenClaw 的细粒度控制​

相关文档​