第 9 章:常见问题与参考
新手最容易卡的点和官方入口。
1常见问题
没有 GPU、没有本机环境,能用吗?
能。用 open.maic.chat 托管,或 OpenClaw + clawhub install openmaic。本机经典模式也不需要 GPU,只要有 LLM API。
必须 PostgreSQL 吗?
不必。默认浏览器存储。只有要服务端持久化或 Pro 工作台时才需要 Postgres。
pnpm 版本不对 / 安装很慢
需要 pnpm ≥ 10、Node ≥ 20。国内 Docker 构建可用清华 Alpine 镜像和 npmmirror,见第 2 章。这不会加速 Docker Hub 底包。
打开工作台是 404
没开 NEXT_PUBLIC_PRO_WORKBENCH_ENABLED 时,agent 路由就是 404。还要 OPENMAIC_AGENT_RUNTIME_ENABLED、DATABASE_URL,以及显式的 MODEL_ROUTES.maic-agent-driver。
首页提示持久化不可用
构建时开了 NEXT_PUBLIC_PERSISTENCE=1,运行时却没有配对的数据库或 token。要么补齐 DATABASE_URL / token,要么不要带着这个开关构建。
导出的课在内网打不开交互页
旧导出仍引用公网 CDN。重新导出 .maic.zip 或资源包,让资源内联成 data URI。
可以商用吗?
根项目 MIT,允许免费商用。合作可联系 thu_maic@mail.tsinghua.edu.cn。仓库里 packages/mathml2omml 是 LGPL-3.0-or-later,整体再分发时要遵守各包自己的条款。
2官方入口
论文:From MOOC to MAIC: Reimagine Online Teaching and Learning through LLM-driven Agents,JCST 2026,DOI 10.1007/s11390-025-6000-0。