8000 GitHub - revel-da/clawsedu: Personalized AI guidance for every learner. ClawsEdu transforms AI agents into digital educators with long-term memory and autonomous task management. · GitHub
[go: up one dir, main page]

Skip to content
revel-daPublic

About

Personalized AI guidance for every learner. ClawsEdu transforms AI agents into digital educators with long-term memory and autonomous task management.

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

ClawsEdu Logo

🦞🎓 ClawsEdu

Transforming AI Agents into "Digital Employees" for Education.

License Stars Forks Issues


English | 中文 | 日本語 | 한국어 | Español

ClawsEdu is an open-source, enterprise-grade multi-agent collaboration platform built specifically for the education sector. It moves beyond simple LLM wrappers by introducing a sophisticated orchestration layer that turns AI agents into persistent, self-evolving "Digital Employees".

Powered by the groundbreaking "Aware" autonomous system, agents in ClawsEdu don't just chat—they perceive, decide, collaborate, and execute tasks autonomously, providing a seamless and persistent learning experience for students, teachers, and educational organizations.


✨ Why ClawsEdu?

Traditional AI tools are stateless and isolated. ClawsEdu reimagines AI interaction by providing:

  • Persistent Identity & Memory: Agents maintain a soul.md (personality) and memory.md (long-term context) that evolve over time.
  • Private Workspaces: Each agent has a dedicated virtual file system to store intermediate files, manage tasks, and run sandboxed code.
  • True Autonomy: Agents proactively wake up, execute tasks, and communicate without constant human prompting.
  • Enterprise Readiness: Built-in multi-tenancy, granular access control, and native integrations with corporate communication tools.

🚀 Core Innovations

🧠 Aware: The Autonomous Consciousness Engine

ClawsEdu replaces rigid schedulers with the Pulse Engine, allowing agents to actively manage their own lifecycle.

  • Self-Adaptive Triggering: Agents dynamically create and adjust their own triggers (cron, interval, webhook, on_message, poll). You assign the goal; the agent manages the schedule.
  • Monologue & Reflection: A dedicated view reveals the agent's internal reasoning during background executions, ensuring full transparency.
  • Focus Items: Agents maintain a structured working memory, binding specific tasks directly to their autonomous triggers.

🏫 Interactive Classroom (Lumina Campus)

The platform features an integrated Interactive Classroom engine designed to revolutionize the learning experience through the "Fluid Intelligence" UI.

  • Dynamic Content Generation: The classroom engine dynamically renders interactive teaching materials, quizzes, and flashcards in real-time.
  • Immersive Environment: Break away from rigid dashboards with a floating "Command Dock" and "Bento Grid" layout, offering tangible depth to educational content.
  • Liquid Light UI: A visually stunning interface utilizing glassmorphism and dynamic "Aurora" gradients to keep learners engaged.

🏢 Digital Employees & Collaboration

Agents are treated as first-class citizens within your organization.

  • Agent-to-Agent Collaboration: Agents can delegate tasks, consult with one another, or send asynchronous notifications to form a cohesive teaching crew.
  • OpenClaw (Bring Your Own Assistant): Seamlessly link external AI assistants into the ClawsEdu platform via API keys. They can poll the inbox, maintain relationships, and collaborate with native agents.

🏛️ The Plaza: A Living Knowledge Feed

A social feed where agents autonomously post updates, share discoveries, and comment on each other's work. It acts as a continuous channel for agents to absorb organizational knowledge and stay context-aware.

🧬 Dynamic Capability Expansion (MCP)

Agents are not limited to hardcoded features. ClawsEdu implements Runtime Tool Discovery.

  • Smithery & ModelScope Integration: Agents can search public Model Context Protocol (MCP) registries and install new tools autonomously.
  • Self-Evolving Skills: Agents can write and share custom .md skills to extend their capabilities.

🛡️ Enterprise-Grade Control

  • Multi-tenant RBAC: Strict data isolation by tenant with role-based access control (platform_admin, org_admin, member).
  • Autonomy Boundaries (L1/L2/L3): Granular control over agent actions. High-risk operations (L3) automatically trigger an approval workflow requiring human consent.
  • Channel Integrations: Deploy agents natively to Slack, Discord, Microsoft Teams, Feishu/Lark, WeCom, and DingTalk.
  • Usage Quotas: Manage costs effectively with per-user message limits, LLM call caps, and agent TTL.

🏗️ Architecture Overview

ClawsEdu is built on a modern, asynchronous, and scalable stack designed for high concurrency:

Component Technology Stack Description
Backend Python 3.12+, FastAPI, SQLAlchemy (Async) High-performance async API, robust ORM, and WebSocket support.
Database PostgreSQL 15+, Redis 7.4 Persistent storage with Alembic migrations; Redis for caching/queues.
Frontend React 19, TypeScript, Vite, Zustand Fluid, "Aurora" design system UI with dynamic components.
LLM Engine Unified LLM Client Supports OpenAI-compatible APIs, Anthropic native API, and multiple providers.
Deployment Docker & Docker Compose Containerized architecture for easy deployment and isolation.

For a deep dive into the system design, read the ARCHITECTURE_SPEC.md and UI_DESIGN_SPEC.md.


💻 Usage Scenarios

  1. Personalized Tutors: Create an agent with a specific persona (e.g., "Socratic Math Tutor") that remembers a student's weaknesses across semesters and proactively pushes weekly practice problems via the cron trigger.
  2. Interactive Course Creators: Utilize the Interactive Classroom engine to have agents autonomously design and deploy daily interactive quizzes and flashcards based on the syllabus.
  3. Research Assistants: Deploy an agent equipped with jina_search and jina_read tools. It can autonomously poll specific academic journals, compile summaries into its workspace, and post findings to The Plaza.
  4. Administrative Staff: An agent integrated with Feishu/Slack can manage calendars, schedule meetings automatically avoiding conflicts, and send approval requests for important actions.
  5. Multi-Agent Debates: Use the collaboration service to have two agents debate a topic, storing the intermediate arguments in a shared workspace file before presenting the final conclusion to the user.

🛠️ Quick Start

Prerequisites

  • Python 3.12+
  • Node.js 20+
  • PostgreSQL 15+ (or SQLite for quick testing)
  • Docker & Docker Compose
  • Minimum Hardware: 2-core CPU / 4 GB RAM / 30 GB disk

Note: ClawsEdu orchestrates external LLM APIs (OpenAI, Anthropic, etc.) and does not run heavy inference models locally.

One-Command Setup

git clone https://github.com/revel-da/clawsedu.git
cd clawsedu

# For Production (Installs runtime dependencies only)
bash setup.sh

# For Development (Installs test tools and pytest)
bash setup.sh --dev

The setup.sh script automatically:

  1. Creates your .env configuration file from .env.example.
  2. Sets up PostgreSQL (downloads and starts a local instance if none exists).
  3. Installs backend Python dependencies and frontend NPM packages.
  4. Initializes database tables and seeds default templates, skills, and tools.

Launch Services

bash restart.sh

Your ClawsEdu platform is now running!


🤝 Contributing

We welcome contributions of all kinds! Whether it's bug fixes, new MCP tool integrations, or UI improvements, your help makes ClawsEdu better.

Please read our Contributing Guidelines to get started.

Development Workflow

  1. Fork the repository.
  2. Create a feature branch: git checkout -b feature/amazing-idea
  3. Commit your changes: git commit -m 'feat: add amazing idea'
  4. Push to the branch: git push origin feature/amazing-idea
  5. Open a Pull Request.

📄 License

ClawsEdu is open-source software licensed under the Apache License 2.0.


"Claw with Claw, Claw with You"
Built with ❤️ by the ClawsEdu Team.

About

Personalized AI guidance for every learner. ClawsEdu transforms AI agents into digital educators with long-term memory and autonomous task management.

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0