OpenMAIC 新手教程

第 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。
OpenMAIC 新手教程 · 清华大学 MAIC 团队开源的多代理交互课堂
GitHub 仓库 · 在线体验 · MIT 开源