System Architecture

Med Desk AI Institute

Self-learning dental office assistant — powered by OpenClaw + GPT-4o-mini

Architecture
Self-Learning Loop
Business Model
Automated Jobs
File Structure
🧠

AI Engine

What powers the responses
  • Model: GPT-4o-mini via OpenAI API
  • Platform: OpenClaw (self-hosted gateway)
  • Persona: SOUL.md — 150-word cap, coworker tone
  • Cost: ~$5/month for student bot
📚

Knowledge Base

13 structured reference files from 4,290-line course
  • Phone techniques & scheduling
  • Insurance verification & billing
  • HIPAA compliance & patient records
  • Dental terminology & front-office workflows
💬

Delivery Channels

How students and staff interact
  • Telegram: Med Desk AI Student Assistant
  • Future: Per-clinic branded Telegram bots
  • Future: WhatsApp / iMessage integration
  • 24/7 availability — no human needed
🔒

Safety & Boundaries

What the bot will NOT do
  • No clinical advice — redirects to dentist
  • No insurance guarantees — plan-specific always
  • HIPAA-aware — flags privacy risks
  • No fabrication — says "I don't know" when unsure
💬

Student Asks a Question

A graduate messages the bot from their workplace. "How do I verify Cigna eligibility?" or "What's our lunch break policy?"

Real-time

Bot Answers — or Redirects

If it's in the knowledge base, the bot gives a fast, accurate answer. If not, it says "Check with your office manager" or "That's a clinical question."

Real-time
🔍

Gap Scanner Detects the Miss

An automated scanner reviews all conversations every 4 hours. When the bot redirected or couldn't answer, it logs the question to a gap tracking file with the topic and reason.

Every 4 hours
📊

Weekly Intelligence Report

Every Sunday, an AI analyzes all logged gaps and produces a report: "Top 5 unanswered questions this week. Recommended additions to knowledge files. Suggested new topics."

Every Sunday
👤

Human Reviews & Approves

The Med Desk team reviews the weekly report and decides what to add. This keeps accuracy high — no hallucinated content enters the knowledge base.

As needed
🚀

Knowledge Base Updated — All Bots Get Smarter

Approved updates go into the universal knowledge files. Because all bots (student + clinic) share these files via symlinks, every bot benefits instantly.

Instant propagation
↻   Cycle repeats forever — the bot gets smarter every week
Product 1 — Live Now

Student Bot

Shared bot for all Med Desk AI Institute graduates. Reinforces course knowledge on the job. Students access it free — funded through placement reimbursement.
UsersAll graduates (shared bot)
KnowledgeUniversal course material only
RevenueStudent placement reimbursement
ChannelTelegram
Operating Cost~$5/month
Product 2 — Ready to Launch

Clinic-Branded Bot

Dedicated bot per dental clinic with custom branding, office-specific policies, provider schedules, insurance panels, and phone scripts. Monthly SaaS subscription.
UsersOne clinic's staff (dedicated bot)
KnowledgeUniversal + clinic-specific
RevenueMonthly subscription per clinic
ChannelClinic's choice (Telegram/WhatsApp)
Operating Cost~$5-10/month per clinic
↗   Product 1 feeds Product 2 — graduates get placed at clinics, clinic sees the value, clinic subscribes
Status Job Schedule Purpose Est. Cost
Active Gap Scanner Every 4 hours Scans conversations for unanswered questions, logs to gaps file ~$0.02/run
Active Weekly Intelligence Sundays 8 PM ET Analyzes gaps, recommends knowledge updates ~$0.03/run
Active Local Backup Every 6 hours Archives workspace, config, and agent data locally $0.00
Active Drive Backup Daily 2 AM ET Uploads full backup to Google Drive (christien@medicaldesk.ai) ~$0.01/run
Active Backup Cleanup Daily 3 AM ET Removes local backups older than 7 days $0.00
Total estimated automation cost: ~$2-3/month
~/.openclaw/ ├── workspace/projects/ │ ├── meddesk-universal/ ← Single source of truth │ │ └── knowledge/ │ │ ├── phone-techniques.md │ │ ├── scheduling.md │ │ ├── insurance-billing.md │ │ ├── hipaa-compliance.md │ │ ├── ... (13 total course files) │ │ └── gaps.md ← Auto-populated gap log │ │ │ ├── meddesk-ai-institute/ ← Student Bot (Product 1) │ │ ├── SOUL.md │ │ ├── knowledge/ │ │ │ └── *.md → symlinks to meddesk-universal │ │ └── reports/ ← Weekly intelligence reports │ │ │ ├── meddesk-clinic-template/ ← Template for new clinics │ │ ├── SOUL.md ← {{CLINIC_NAME}} placeholders │ │ ├── ONBOARDING.md ← Step-by-step setup checklist │ │ ├── INTAKE-QUESTIONNAIRE.md ← Client intake form │ │ ├── knowledge/ ← Will symlink to universal │ │ └── clinic/ │ │ ├── office-info.md │ │ ├── office-policies.md │ │ ├── insurance-panels.md │ │ └── provider-schedule.md │ │ │ └── meddesk-{{clinic-id}}/ ← Future: one per paying clinic │ ├── SOUL.md (branded) │ ├── knowledge/ → symlinks to universal │ └── clinic/ (office-specific files) │ ├── agents/ │ └── meddesk/ │ └── auth-profiles.json ← API key (project-scoped) │ └── openclaw.json ← All agent configs
Folders
Files
Symlinks (shared)
Templates