预配置

首次启动之前

确认工作区、配置文件和通道凭据

MathClaw 是一套持续运行的学习系统。启动前请确保 workspace、配置路径和通道凭据指向同一个环境，避免启动后各页面数据不一致。

workspace配置文件模型通道

1个统一 workspace，保存会话、记忆、图谱和定时任务状态。

1个主配置路径：~/.mathclaw/config.json。

3项关键检查：路径可写、模型可用、通道凭据有效。

运行时基线

workspace 结构

所有页面共享同一个 workspace，确保读取到一致的学习历史。

• 原始会话日志
• 日记忆与周记忆快照
• 知识图谱与错题图谱 JSON
• 定时任务状态

配置解析

控制台默认读取标准用户配置目录，支持跨机器迁移。

• 主路径：~/.mathclaw/config.json
• 从 console/ 启动时可显式传入 workspace
• 建议使用仓库相对路径，避免机器专属的绝对路径

典型 workspace 结构：

workspace/
  sessions/
  memory/
    daily_conversations/
    daily_memory/
    weekly_memory/
    graphs/
  cron/

从仓库内启动控制台时，建议显式传入 workspace：

cd console
MATHCLAW_CONSOLE_WORKSPACE=../workspace python serve.py

首次启动检查清单

模型层

• 确认主模型和 provider 可连通
• 确认 API Key 已加载到预期配置源
• 如需解析 PDF / 图片，确认附件解析模型也可用

通道层

• 只启用实际需要的通道
• 先检查凭据，再启动 gateway
• 建议始终保留 console 作为管理入口

启动后优先检查的页面

运行状态 确认 gateway、console、provider 和通道是否正常。

定时任务 查看日总结、周总结等自动任务是否在正常执行。

图谱与技能面板 确认记忆页和技能配置是否按预期工作。