日志记录

文档

网关（Gateway）

日志记录

适用范围

此页面是 Moltbot 日志记录的操作员视图：日志去向、如何跟踪以及调试时重要的旋钮。

对于面向用户的概述（CLI + 控制 UI），请参阅 /docs/logging/。

两个日志表面

控制台输出：你在终端中看到的内容（TTY 感知、已格式化）。
文件日志：由网关记录器编写的 JSONL 记录（最适合支持/取证）。

文件日志（默认）

默认情况下，网关在 /tmp/moltbot/ 下每天写入一个滚动日志文件：

moltbot-YYYY-MM-DD.log

配置键（在 ~/.moltbot/moltbot.json 中）：

logging.file
logging.level

跟踪日志：

moltbot logs --follow

`--verbose` vs `logging.level`

--verbose 增加控制台详细程度（和 WS 协议日志记录样式）。
文件日志详细信息由 logging.level 控制（如果需要文件中的深度详细信息，设置为 debug/trace）。

控制台捕获（CLI）

CLI 可以从正在运行的进程中捕获 console.* 并将其镜像到文件日志，同时仍然打印到 stdout/stderr。

常用旋钮：

logging.consoleLevel（仅控制台详细程度）
logging.consoleStyle (pretty | compact | json)

编辑（工具摘要）

详细的工具摘要可以在敏感字符串到达终端流之前对其进行编辑：

logging.redactSensitive (off | tools)
logging.redactPatterns（自定义正则表达式列表）

这是一个控制台 UX 功能；它不会重写历史文件日志。

网关 WebSocket 协议日志

网关以两种实用模式打印 WS 协议日志：

normal：显示错误 / 慢调用 / 解析失败
verbose：显示所有请求/响应流量

示例：

moltbot gateway                 # 优化输出
moltbot gateway --verbose       # 显示所有 WS 流量
moltbot gateway --verbose --ws-log compact
moltbot gateway --verbose --ws-log full

收集 bug 报告的内容

moltbot status --json（或 moltbot gateway status --json）
来自 moltbot logs 的故障周围约 200 行
你运行的确切命令（包括 --dev / --profile）