ClassFlow Skill for OpenClaw

Give your AI agent a scheduling brain — schedule schools, meetings, clinics and conferences with one prompt.

Website · Web Demo · API Docs · MCP Server

---

This is the official OpenClaw skill for ClassFlow. Drop it into any OpenClaw-compatible agent and it gains the ability to schedule anything — schools, meetings, medical clinics, conferences, training — by calling the ClassFlow API in the background.

It also works as an MCP-compatible skill for Claude, ChatGPT, or any other agent that speaks the Model Context Protocol.

✨ What It Does

Once installed, your agent understands prompts like:

• 📅 "Schedule my school" — turns a list of teachers, courses and rooms into an optimized timetable
• 🤝 "Ms. Chen is sick today, who can substitute?" — finds the best replacement teachers
• 🏫 "Which rooms are free on Wednesday?" — checks availability across the week
• ✅ "Is this schedule feasible?" — pre-flights a problem before solving
• 🔄 "Move the math lab to Thursday and reschedule" — incremental rescheduling

📦 Install

From ClawHub (recommended)

clawhub skill add classflow-scheduling

Manually

mkdir -p ~/.openclaw/skills/classflow-scheduling
cp SKILL.md ~/.openclaw/skills/classflow-scheduling/SKILL.md

🔑 Setup

The skill needs a CLASSFLOW_API_KEY. You have two ways to get one:

Option A — Free API key

1. Sign up at classflowapi.com/en/register
2. Verify your email; you'll receive a key starting with cf_
3. Export it:

export CLASSFLOW_API_KEY=cf_your_key_here

Option B — Browser OAuth (recommended)

If you already have a ClassFlow account, authorize directly from your browser:

1. Open https://classflowapi.com/en/oauth?client_name=OpenClaw+Agent&redirect_uri=http://localhost
2. Log in (or register) and click Authorize Access
3. Copy the access token from the callback URL
4. Export it:

export CLASSFLOW_API_KEY=mcp_your_token_here

Both cf_ (API key) and mcp_ (OAuth token) prefixes work with all endpoints.

Verify

curl https://api.classflowapi.com/api/v1/usage \
  -H "X-API-Key: $CLASSFLOW_API_KEY"

If you see {"data": {"plan": "FREE", ...}}, you're ready.

🚀 Usage

After installation, just talk to your agent normally:

> Schedule a 10-classroom elementary school. Each teacher teaches 25 hours/week,
> there are 6 grades and Wednesday afternoons are off for assemblies.

The agent will gather what it needs, call ClassFlow, and return a complete timetable plus an explanation of the constraints it satisfied.

For the full prompt surface — supported operations, plan limits, constraint tiers and domain templates — see SKILL.md.

📤 Publishing Updates

To publish a new version to ClawHub:

clawhub skill publish ./

Bump the version field in the frontmatter of SKILL.md first (semver).

🗺️ Project Files

SKILL.md     # The skill — frontmatter + system prompt the agent loads
README.md    # You are here
LICENSE      # MIT

🤝 Contributing

PRs welcome — improvements to the prompt, new domain templates (medical, conference, training), translations. Open an issue first for non-trivial changes, then send a PR against main. Security issues should go to security@classflowapi.com.

📄 License

MIT — © ClassFlow Inc.

🔗 Related

• classflow-api/api — The API the skill calls
• classflow-api/sdks — Official SDKs (TypeScript, Python, Go, Java)
• classflow-api/docs — Public developer documentation
• openclaw.ai — The OpenClaw agent platform