等待的成绩单和 TTS 帮助程序

H历史记录键

使用 openclaw/plugin-sdk/session-store-runtime 中的 resolveTranscriptSessionKeyBySessionIdAsync 查找拥有确切转录本身份的会话密钥：

import { resolveTranscriptSessionKeyBySessionIdAsync } from "openclaw/plugin-sdk/session-store-runtime"; const sessionKey = await resolveTranscriptSessionKeyBySessionIdAsync({  agentId,  sessionId,  storePath,});

它返回 Promise<string | undefined> 并接受与同步助手相同的 agentId、env、sessionId 和 storePath 字段。当脚本属于已配置或共享存储时，传递 storePath。不存在的数据库或未知身份会返回 undefined，而不创建数据库。

查找包括当前会话重置为新身份后保留的历史记录窗口。 getSessionEntryByIdAsync 读取当前会话条目，并且不能替代此历史查找。帮助者解决所有权问题；呼叫者在披露记录内容之前仍会强制执行现有授权。

同步 resolveTranscriptSessionKeyBySessionId 仍可作为已弃用的适配器使用。调用会发出有限警告，引导作者寻找等待的替换。

TTS提示

对于一个提示，请等待公共 api.runtime.tts.buildSystemPromptHintAsync 方法。较老的主机可能缺乏这种附加功能；报告升级要求，而不是回退到同步数据库读取：

const prepareHint = api.runtime.tts.buildSystemPromptHintAsync;if (!prepareHint) {  throw new Error("Update OpenClaw to use async TTS prompt preparation.");} const hint = await prepareHint(config, agentId, {  messageToolOnly: true,});

结果仍然是 string | undefined：禁用的 TTS 不会产生任何提示。帮助器通过状态所有者准备机器拥有的首选项路径，并保留显式配置和 OPENCLAW_TTS_PREFS 优先级。

openclaw/plugin-sdk/tts-runtime 子路径是捆绑插件专用的。一次需要多个 TTS 帮助器的捆绑代码可以准备一次并将结果传递给每个调用。其同步重载与所需的 preparedTtsPreferences 仍然受支持：

import {  buildTtsSystemPromptHint,  prepareTtsPreferences,  resolveTtsConfig,  resolveTtsPrefsPath,} from "openclaw/plugin-sdk/tts-runtime"; const preparedTtsPreferences = await prepareTtsPreferences();const prefsPath = resolveTtsPrefsPath(resolveTtsConfig(config, agentId), preparedTtsPreferences);const hint = buildTtsSystemPromptHint(config, agentId, {  messageToolOnly: true,  preparedTtsPreferences,});

PreparedTtsPreferences 是私有只读类型。将返回值视为回合范围内的准备，并为下一回合获取新的准备。它保留选定的计算机路径，同时在每个帮助程序运行时读取首选项文件内容。提交的进程内路径更改对于下一个准备是可见的。

resolveTtsPrefsPath 和 buildTtsSystemPromptHint 的未准备同步重载保留其现有的返回值和行为，但已弃用。使用他们等待的替代品，或提供上述准备，以避免同步状态数据库读取和弃用警告。

移除时机

这些已弃用的适配器仍然受支持2026-12-31，最后的兼容日。拆除船舶在第一月2027稳定发布，没有插件SDK主要版本。准备好的SQL-自由的TTS重载仍受支持。请参阅完全的SQLite迁移指南和移除时间表。