OpenMAIC: uma plataforma de código aberto para a geração de salas de aula interativas corporais multiinteligentes com um clique

O OpenMAIC (Open Multi-Agent Interactive Classroom) é uma plataforma de código aberto de sala de aula interativa com corpo multiinteligente lançada pela equipe de pesquisa da Universidade de Tsinghua (THU-MAIC). Ela foi desenvolvida com base no modelo de linguagem grande (LLM) de ponta e na arquitetura de orquestração multiagente, e é capaz de transformar automaticamente qualquer tópico de conhecimento inserido pelo usuário ou documento carregado em uma sala de aula digital interativa visual e estruturada com um clique. Na sala de aula gerada pelo OpenMAIC, os professores e colegas de classe interpretados por IAs assumirão o processo de ensino e poderão não apenas ler o material didático em voz alta, mas também desenhar diagramas à mão e escrever fórmulas matemáticas em tempo real no quadro branco compartilhado, além de participar de perguntas e respostas em tempo real e debates em mesas redondas com alunos humanos.

Para romper as limitações da audição passiva na educação on-line tradicional, o OpenMAIC introduziu o “Deep Interactive Mode” (Modo interativo profundo). Esse modo suporta a renderização de modelos de visualização 3D diretamente no navegador, o fornecimento de parâmetros ajustados dinamicamente para a simulação de processos físicos, o editor de código integrado para verificação de programação on-line e a geração automática de mapas mentais relacionados à estrutura de conhecimento. Além disso, a plataforma suporta uma interface perfeita com plug-ins inteligentes OpenClaw, permitindo que os usuários comandem o assistente de IA para gerar links de ensino diretamente no software de bate-papo diário, como Flybook, Slack e Telegram. A plataforma oferece a máxima flexibilidade de dados: seja acoplando modelos internacionais de IA convencionais ou implantando modelos locais completamente off-line, o OpenMAIC pode atender com eficiência às necessidades de ensino de cenários diversificados, como autoestudo fragmentado, pesquisa de tese profissional e treinamento corporativo.

Lista de funções

• Gerar cursos estruturados com um cliqueInsira um tópico de aprendizado ou carregue um documento de referência (compatível com PDF) e o algoritmo de back-end executará automaticamente um processo de dois estágios que gera um esboço completo do curso, slides gráficos e conteúdo de questionário pós-curso em minutos.
• Sistema de interação de corpo e sala de aula com inteligência múltiplaProfessores e alunos de IA integrados com diferentes configurações. Ele oferece suporte a cenários de interação na vida real, como explicação automática, início de debates em mesas-redondas com vários personagens, resposta a perguntas em tempo real em sala de aula e exploração livre.
• Modo de renderização de cena interativa profunda：
  • Visualização 3DRenderização automática de modelos de visualização 3D para estruturas abstratas, com suporte para arrastar e soltar o mouse para visualização completa.
  • Simulação dinâmicaGeração automática de ambientes experimentais com mecanismos físicos ou de processo, com parâmetros ajustáveis para observar mudanças em tempo real.
  • Jogos interativos de aprendizagemMini-níveis integrados para consolidar o conhecimento e aprofundar os pontos de memória em desafios interativos.
  • Laboratório de programação on-lineFornecimento de um ambiente de compilação para escrever, modificar e executar instantaneamente o código diretamente no lado da Web.
  • Mapas mentais automatizadosGera instantaneamente um mapa escalável da estrutura de conhecimento do sistema com base na lógica do conhecimento.
• Quadro branco dinâmico inteligente com síntese de falaIA: a IA é capaz de explicar o conhecimento em uma voz humana com a tecnologia TTS integrada e pode usar indicadores no quadro branco para destacar pontos-chave, fluxogramas desenhados à mão passo a passo e elaborar fórmulas complexas.
• Exportação de ativos em vários formatosExportação com um clique do curso completo gerado para um arquivo PowerPoint (.pptx) editável secundário que mantém o layout e a formatação, HTML off-line de uma página com interações ou um pacote ZIP de dados da sala de aula.
• Acesso ao LLM aberto altamente compatívelEle é compatível com as principais APIs nacionais e internacionais, como OpenAI, Google Gemini, Anthropic, DeepSeek, Smart Spectrum GLM, MiniMax, etc., e com a conexão de modelos privados locais por meio do Ollama.
• Integração de atalhos de software de bate-papo (OpenClaw)Acesso ininterrupto a mensageiros instantâneos, permitindo que os bots entrem automaticamente na fila para gerar links de sala de aula em segundo plano, enviando comandos de bate-papo no Flybook, Slack e Discord.

Usando a Ajuda

O OpenMAIC oferece um alto grau de flexibilidade, seja você um usuário que espera experimentar rapidamente a capacidade de geração ou um desenvolvedor que precisa realizar uma implantação de isolamento de dados privados, você pode encontrar o caminho de uso correspondente. Abaixo, você encontrará um guia completo sobre a instalação, a configuração e a funcionalidade principal do OpenMAIC. Siga as etapas para iniciar sua jornada de aprendizado interativo inteligente.

I. Guia de instalação rápida e implantação de localização

Para obter o recurso de interação profunda mais completo sem demora, é altamente recomendável que os usuários com alguma base de desenvolvimento usem um ambiente local para a implementação.

1. preparação do ambiente básico
Antes de clonar o projeto, certifique-se de que o software básico a seguir esteja instalado e configurado corretamente no ambiente do seu sistema operacional:

• Node.jsRequisitos de controle de versão: Os requisitos de controle de versão devem >= 20.9.0A equipe de suporte ao cliente é responsável por fornecer suporte operacional para os componentes de back-end e front-end.
• pnpmFerramenta avançada de gerenciamento de pacotes front-end, requisitos de versão >= 10。

2. obter o código-fonte e instalar as dependências
Abra seu terminal (Terminal / PowerShell / iTerm2) e execute os seguintes comandos em sequência para clonar o código-fonte oficial do projeto localmente e automatizar a instalação de todos os pacotes de ambiente dependentes necessários:

git clone https://github.com/THU-MAIC/OpenMAIC.git
cd OpenMAIC
pnpm install

3. configuração de variáveis de ambiente e do modelo de linguagem grande (LLM)
O núcleo da interação de inteligência múltipla se baseia na capacidade lógica avançada de modelos de linguagem grandes, e o OpenMAIC oferece suporte a interfaces de modelo avançadas.
Primeiro, copie o arquivo de variáveis de ambiente gerado no diretório raiz:

cp .env.example .env.local

Abrir com um editor de texto .env.local preencha a chave da API do Big Model que você está usando.
Exemplos de configurações comuns de modelos grandes:

• OpenAI：OPENAI_API_KEY=sk-...
• Espectro inteligente GLM：GLM_API_KEY=您的密钥 e configurado abaixo de GLM_BASE_URL=https://open.bigmodel.cn/api/paas/v4
• modelo de desconexão localSe você tiver necessidades extremamente altas de privacidade de dados, também poderá vincular no arquivo de ambiente a execução local do Ollama Endereço da porta de serviço.

💡 Recomendações de melhor experiênciaPara obter um equilíbrio ideal entre a qualidade da geração de conteúdo e a velocidade de raciocínio, é recomendável usar a função Google Gemini 3 Flash. Se você precisar definir esse modelo como o padrão global, poderá adicionar um arquivo de configuração ao DEFAULT_MODEL=google:gemini-3-flash-preview。

4. lançamento dos serviços da plataforma
Execute o comando de inicialização do ambiente de desenvolvimento no terminal:

pnpm dev

Nesse momento, o sistema iniciará o servidor local em segundo plano. Abra um navegador moderno (recomenda-se o Chrome ou o Edge) e acesse o endereço http://localhost:3000Se quiser usar o OpenMAIC, você poderá ver a interface principal do OpenMAIC.

📌 Complementado por outras modalidades de implantação：

• Implantação do Docker em um clique: Modificado .env.local Após a tecla, o terminal executa o comando docker compose up --build É possível obter uma operação estável em contêineres com isolamento ambiental.
• Configuração da proteção de criptografia de acessoSe você estiver implantado em um ambiente de acesso público, o .env.local tornar-se um membro ACCESS_CODE=您的专属安全密码. Dessa forma, todos os visitantes externos são bloqueados para solicitar autenticação, evitando o roubo de créditos da interface.

II. Gerar e experimentar uma sala de aula interativa rapidamente a partir de uma base zero

Depois de configurado e inserido com êxito na interface da Web, você verá o Course Workbench minimalista. Siga os três processos padrão abaixo:

Etapa 1: Insira um tópico principal ou carregue um documento de conhecimento
Na grande área de entrada de texto na página inicial, digite explicitamente o que você deseja aprender. Por exemplo: “Explique-me o princípio da oferta e da demanda em macroeconomia” ou “Como desenvolver um script de rastreamento usando Python”.
Se você tiver um livro didático especial ou um trabalho profissional, poderá carregar um documento PDF clicando no botão “Attachments” (Anexos) no canto inferior esquerdo, e o sistema usará algoritmos incorporados para identificar e extrair texto, tabelas e fórmulas matemáticas complexas do documento.

Etapa 2: Revise e ajuste o esboço do curso gerado
Clique no botão “Generate” (Gerar) e a IA produzirá uma cópia em alguns segundos.Esboço do curso estruturado (Esboço)。
O esboço é apresentado como um nó de árvore, onde você pode manipulá-lo diretamente como se estivesse editando um catálogo:

• Clique no sinal “+” para adicionar uma nova subseção de extensão de conhecimento.
• Clique no ícone da lixeira para excluir tópicos que não precisam ser discutidos.
• Clique duas vezes em um nó para modificar a direção da exploração do conteúdo específico do capítulo.

Etapa 3: Renderização do conteúdo e entrada na sala de aula
Após confirmar o esboço, o sistema entra automaticamente emEstágio de renderização de cenas (Scenes).. As inteligências múltiplas trabalharão em paralelo para gerar roteiros de leitura de voz, ilustrações de layout de slides e perguntas de questionários, respectivamente.
Aguarde até que a barra de progresso seja preenchida e clique em “Start Class” (Iniciar aula) na interface. Nesse momento, você entrará em uma sala de aula virtual digital.

• Audição imersivaO visual principal da tela mostra uma apresentação de slides com um ponteiro a laser destacando a animação, e o professor de IA usa automaticamente a tecnologia TTS para explicar os pontos principais página por página com uma voz humana.
• Interrupção do mecanismo de questionamentoAI Teacher: Quando você ouvir um conceito que não é fácil de entender, digite uma pergunta na caixa de bate-papo abaixo (ou use o microfone para falar) e o AI Teacher pausará a apresentação de slides para responder à sua pergunta diretamente em termos leigos. Se você precisar de uma demonstração, ele também cortará ativamente oQuadro branco dinâmico (Whiteboard)Além disso, você pode desenhar fluxogramas de dados ou derivar fórmulas complexas manualmente.

III. exploração do modo interativo profundo (DIM)

Ao se deparar com disciplinas que exigem prática, como programação, física ou estruturas tridimensionais, o OpenMAIC exibe automaticamente uma IU interativa profunda na seção correspondente:

• Ao aprender sobre processos físicos: ele apareceráSimulador de Física. Você pode deslizar os controles deslizantes numéricos na página (por exemplo, para alterar a aceleração da gravidade, a temperatura) e observar a dinâmica experimental do sistema em tempo real para obter feedback.
• Ao aprender programação de computadoresTela dividida: A tela será cortada automaticamente em uma tela divididaEditor de código on-line (Programação on-line)O sistema inicializa um código base para você. O sistema inicializa um código base para você, que pode ser reescrito diretamente na página da Web e clicar em “Run” (Executar) para ver a saída do terminal, e a IA também fornecerá orientação em tempo real sobre como corrigir o código quando ele relatar um erro.
• Ao estudar o corpo humano ou a estrutura molecular: através deVisualização da estrutura em 3DNo controle, você pode arrastar e soltar com o botão esquerdo do mouse para obter uma visualização de 360° do perfil.
• Quando se trata de resumos de revisão de capítulosAcionar o modo **Global Mind Map**, exibindo claramente a rede de mapeamento de conhecimento dessa seção e revisando o conteúdo de ensino anterior clicando no nó.

📤 IV. Compartilhamento e exportação de arquivos de sala de aula em vários formatos com um clique

Ao final de uma ótima sessão interativa, é fundamental que ela seja registrada e compartilhada. Clique no canto superior direito da página para Exportação para exibir as opções de exportação:

1. Exportar como PowerPoint (.pptx)O sistema converte cada slide em um PPT nativo totalmente formatado, os elementos gráficos e as imagens não são convertidos em imagens mortas e as fórmulas do curso são convertidas com precisão em fórmulas nativas do Office Math, o que torna extremamente fácil modificá-las para uso posterior em defesas escolares ou apresentações em conferências.
2. Exportar para HTML interativoSe quiser manter as simulações, os testes interativos etc., você pode exportar esse arquivo HTML autônomo de uma página. Ele funciona perfeitamente em seu navegador local sem a necessidade de Internet, o que o torna a biblioteca de revisão off-line ideal.
3. Exportar como ZIP de sala de aulaO sistema será empacotado com um pacote de código-fonte completo, incluindo estruturas de dados do curso, material de voz de mídia, e é adequado para ser compartilhado com amigos para importação em suas plataformas OpenMAIC para reprodução em sua forma original.

Seguindo o guia de ajuda acima, você poderá dominar a lógica do sistema do OpenMAIC sem nenhum obstáculo e liberar totalmente a incrível eficiência da educação multiinteligência!

cenário do aplicativo

1. Auto-estudo individual com base zero e exploração de imersão
   Seja para aprender uma nova linguagem de programação ou compreender princípios científicos complexos, os usuários simplesmente inserem seus objetivos de aprendizagem e a plataforma gera lições estruturadas com explicações gráficas, ambientes de código passo a passo e testes de conhecimento. O tutor de IA explica pacientemente a lição por voz e ajuda o usuário a aprender e praticar por meio do ambiente de programação integrado.
2. Leitura aprofundada de literatura profissional em língua estrangeira e análise de relatórios financeiros
   Pesquisadores ou analistas financeiros podem carregar diretamente centenas de páginas de artigos completos em inglês ou documentos PDF de relatórios financeiros. O sistema de inteligência múltipla pode extrair rapidamente a lógica dos dados principais, gerar uma sala de discussão com várias perspectivas e desenhar gráficos dinamicamente para demonstrar a relação entre os dados por meio do quadro branco, o que reduz significativamente o limiar de compreensão de informações complexas.
3. Treinamento empresarial padrão e orientação interativa
   Os gerentes corporativos podem transformar manuais longos e enfadonhos de integração de funcionários ou documentos SOP de operação de software em salas de aula on-line interativas com IA com um único clique. Os novos funcionários podem fazer perguntas ao tutor de IA a qualquer momento durante o processo de treinamento e verificar seus resultados de aprendizagem por meio dos testes de acompanhamento integrados da plataforma, aumentando a diversão e a taxa de retenção de conhecimento do treinamento.
4. Ciência para o ensino fundamental e médio Demonstração de ciência visual e laboratório virtual
   Os educadores podem usar essa ferramenta para transformar conceitos abstratos e complexos de livros didáticos em aulas de laboratório imersivas, vívidas e tridimensionais. Usando a “Visualização 3D” e o “Simulador de Física” no Modo de Interação Profunda, os alunos podem ajustar os parâmetros e observar as mudanças estruturais na tela, o que estimula totalmente o interesse deles em explorar o conhecimento científico.

QA

1. Quais modelos de linguagem grande (LLMs) são compatíveis com o OpenMAIC?
   O OpenMAIC tem uma forte compatibilidade de interface e, atualmente, suporta a chamada da maioria dos grandes modelos convencionais do mercado por meio da configuração de chaves de API, incluindo OpenAI (série GPT), Anthropic (Claude), Google Gemini, DeepSeek, Smart Spectrum GLM, MiniMax, Grok e ByteHopper Doubao etc. Ele também oferece suporte ao acesso a serviços locais, como o Ollama, para execução totalmente off-line.
2. Como as empresas podem conseguir uma ausência total de execução na nuvem se quiserem proteger a privacidade dos dados locais?
   A plataforma tem a capacidade de ser executada exclusivamente localmente. Você pode começar executando a plataforma localmente em seu dispositivo por meio do comando Ollama Implante modelos de idiomas grandes de código aberto (por exemplo, Llama 3) e, em seguida, implante o código de backbone do OpenMAIC localmente ou privatize-o com o Docker na LAN. Nessa arquitetura, todo o processo de análise de geração de cursos (incluindo análise e extração de documentos) é feito em um loop fechado dentro da LAN, e não há absolutamente nenhuma saída de dados.
3. Os arquivos PPT exportados pela plataforma são imagens estáticas que podem ser modificadas posteriormente?
   Os arquivos PowerPoint (.pptx) exportados são documentos totalmente editáveis e de alta qualidade, e o mecanismo de exportação do OpenMAIC preserva as caixas de texto nativas, as formas e os recursos de imagem inseridos. Além disso, os cálculos e as derivações matemáticas gerados no sistema podem ser convertidos no formato nativo LaTeX ou Office Math, para que você possa modificá-los, adicioná-los ou excluí-los como desejar no software local do seu computador.
4. Posso usá-lo imediatamente se não tiver a base técnica para implementar o código?
   O OpenMAIC se integra nativamente com o OpenClaw Ferramentas. Se você não souber como implantá-lo, poderá usar o modo hospedado, que exige que você obtenha um código de acesso único em open.maic.chat e, em seguida, envie um comando de linguagem natural para o bot de IA em aplicativos de bate-papo populares, como Flybook, Slack, Telegram ou Discord, e o sistema enfileirará um curso na nuvem e retornará um link direto para a página da Web onde você poderá abrir a aula. O sistema colocará o curso em fila de espera na nuvem e retornará um link para a página da Web onde você poderá abrir a aula on-line.
5. O sistema suporta a marcação e a avaliação automáticas de perguntas de questionários geradas em sala de aula?
   Oferece suporte à correção automática de avaliações. Quando a aula passa para a seção de questionários, o professor de IA apresenta automaticamente na tela perguntas de escolha única, múltipla escolha ou de resposta curta. Depois que você clicar nas opções e enviar suas respostas, o MultiIntelligence avaliará suas escolhas em segundo plano, não apenas pontuando em tempo real, mas também fornecendo explicações direcionadas e faladas sobre os princípios de correção de erros para as partes erradas de suas escolhas.