常见问题

问题排查

按运行时路径逐层排查

MathClaw 的问题通常出在 workspace、配置解析、通道凭据或定时任务状态的某一层。按连接顺序排查最为高效。

常见问题类型

控制台指向了错误配置

确认 console 解析的是 ~/.mathclaw/config.json，并在需要时显式传入 workspace。

图谱为空或长时间不更新

检查 session 写入、memory 生成和 graph JSON 的更新时间，确认数据仍在正常同步。

定时任务停止执行

查看 workspace/cron/jobs.json，对比页面显示时间与最近一次成功执行时间。

推荐排查顺序

01

检查运行状态

确认 gateway、console、模型 provider 和通道是否正常。

02

检查定时任务

对比 next run、last run 和 recent result，判断是短时波动还是已经中断。

03

检查 workspace 文件

查看 sessions/、memory/graphs/ 和 cron/ 是否有持续写入。

04

定位到具体通道

如果只有某一个入口异常，优先检查该通道的凭据和日志。

可移植启动提醒

建议使用仓库相对路径，方便 console、gateway 和文档在不同机器之间保持一致。

• 主配置路径：~/.mathclaw/config.json
• 控制台启动：cd console && MATHCLAW_CONSOLE_WORKSPACE=../workspace python serve.py
• 图谱文件：workspace/memory/graphs/knowledge_graph.json 和 error_graph.json