用途：在本地以文本模式运行用户的 LiveKit 智能体，作为后台进程逐轮推进对话，用于交互式调试智能体行为。
主要能力：关闭语音，不接入 LiveKit 房间，因此每轮只消耗智能体自身的 LLM 与工具调用。每条 say 会打印智能体所做的全部动作（含工具调用及参数和结果、handoff、错误）以及回复；轮次之间可查看聊天历史、实时事件流、进程日志和状态。
必要用法：首次使用前先确认命令存在并阅读帮助，即运行 lk agent debugger --help，帮助是子命令与标志的权威来源。若命令缺失，说明所装 CLI 版本较旧，应让用户更新 lk，在此之前改用 testing-livekit-agents。基本循环示例： lk agent debugger start lk agent debugger say "Hi, what can you do?" lk agent debugger say "Book me a table for two tonight" lk agent debugger stop 每次修改代码后都要重启，运行中的会话仍使用旧代码。
调试要点：同时阅读工具调用与回复，错误参数通常指向提示词或工具描述问题，完全没有调用通常说明工具描述未说明何时使用；工具异常时可交错查看日志，把日志行归入所属轮次；查看聊天历史而非依赖记忆；先复现再修复并重跑相同 say 序列；用完整多轮对话触发需多轮才出现的缺陷；若由程序决定轮次，可使用机器可读输出与退出码，具体格式以 --help 为准。
适用场景：需要交互式发现智能体缺陷时。想实际收听或交给他人试用，用 lk agent console；同一故障反复出现，写轮次级回归测试；需要大规模评估整段对话结果，用仿真；涉及语音（轮次切换、打断、转录）的缺陷，需用音频仿真，文本调试器无法覆盖。找到缺陷后应写测试防止回归。
限制：仅文本模式，看不到语音相关问题；资料未提供收费或价格信息，亦未提供除上述命令外的更多子命令细节。