Clawdbot异常需通过日志定位：默认日志在~/.clawdbot/logs/，支持终端查看、CLI实时流、Docker日志提取、debug级别增强及iMessage数据库专项排查。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您在运行 Clawdbot 时遇到异常行为、命令无响应或网关启动失败，需通过日志文件定位具体错误来源。Clawdbot 默认将运行时输出、通道事件、模型调用及系统级错误写入本地日志文件，其路径取决于操作系统与部署方式。以下是查找日志文件并分析报错原因的多种方法：
一、查看默认日志目录位置
Clawdbot 的日志文件默认保存在用户主目录下的 ~/.clawdbot/logs/ 子目录中。该路径为所有标准安装（包括 Docker、npm 全局安装、源码运行）的统一日志根目录。日志按日期滚动命名，例如 2026-01-28.log、2026-01-29.log。
1、打开终端（macOS/Linux）或 WSL2 终端（Windows）
2、执行命令进入日志目录：cd ~/.clawdbot/logs
3、列出最新日志文件：ls -lt | head -n 5
4、使用 less 查看当日完整日志：less $(ls -t | head -n1)
二、通过 CLI 命令实时输出日志
Clawdbot 提供内置日志流接口，可绕过文件系统直接捕获当前进程输出，适用于调试网关、通道或模型服务的即时状态。该方法不依赖磁盘日志是否启用，且能显示未落盘的缓冲日志。
1、确保 Clawdbot 正在运行（如已停止，请先执行 clawdbot gateway start）
2、在新终端窗口中运行：clawdbot logs –follow
3、触发一次 iMessage 或 Telegram 消息，观察控制台中是否出现 [imessage] ERROR、[gateway] token invalid 或 [model] timeout 等关键词
4、按下 Ctrl+C 停止流式输出
三、检查 Docker 容器内日志（Docker 部署专用）
当使用 Docker 运行 Clawdbot 时，日志不写入宿主机 ~/.clawdbot/logs，而是由容器 stdout/stderr 输出，需通过 Docker CLI 提取。容器日志包含更底层的 Node.js 启动错误、权限拒绝堆栈和模块加载失败详情。
1、查询正在运行的 Clawdbot 容器名称：docker ps –filter “name=clawdbot” –format “{{.Names}}”
2、获取最近 200 行日志：docker logs –tail 200 clawdbot-main（若容器名为 clawdbot-main）
