Skip to content

Maximilien-ai/clawmax

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

1,178 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

ClawMax

Multiagent orchestration platform for OpenClaw

ClawMax provides a web-based platform to manage, monitor, and orchestrate OpenClaw AI agent teams. Deploy team templates, visualize workflow DAGs, track progress, and coordinate agents across your entire ecosystem.

License: MIT Version Tests


πŸ”₯ Recent Stability Work (v1.3.12–v1.3.14 line)

  • Setup, auth, and operator hygiene improved:
    • first-run token generation no longer prints the full dashboard API token into stdout/container logs
    • setup.sh now writes DASHBOARD_PUBLIC_URL, documents CLAWMAX_WORKFLOW_AGENT_TIMEOUT_MS, and normalizes OPIK_PROJECT_NAME=clawmax
    • Communications now defaults to the card/grid view on fresh dashboards
  • Workflow and template reliability improved:
    • organization template markdown round-trip now preserves agent communities and groups
    • heavier workflows use a safer default agent timeout (10 minutes) with CLAWMAX_WORKFLOW_AGENT_TIMEOUT_MS override support
    • workflow-created artifact notifications are moving away from fake asset-dir actors toward real agent attribution where the runner can identify the writer
  • Activity, metering, and day-to-day dashboard use improved:
    • metering no longer drops valid OPIK traces just because dashboard_instance_id is missing from the trace metadata
    • Activity & Budget refreshes when you switch back to it instead of requiring a browser refresh
    • DocHub now shows created/updated timestamps and light new / updated hints for asset files
    • Communications selection mode now supports bulk clear-history in addition to bulk delete
    • a generic env-driven maintenance banner contract is available for planned maintenance messaging without hardcoding ClawMax.ai-specific behavior
  • Validation is safer by default:
    • plain ./SYSTEM/test.sh is now read-only against a live dashboard
    • destructive/live mutation coverage remains under ./SYSTEM/test.sh integration
    • the visible default-safe test summary continues to grow as focused suites are added

πŸ”₯ Latest Release: v1.3.14

  • Workflow/operator reliability improved:
    • workflow-created artifact notifications now attribute files to the actual agent when possible and suppress duplicate generic follow-up notifications
    • agent status surfaces concrete gateway restart-loop and session-drift diagnostics instead of vague unavailable/auth wording
  • Dashboard day-to-day UX improved:
    • Activity & Budget refreshes automatically when you switch back to it
    • Communications supports bulk clear-history and now uses the current communities/groups API paths
    • the maintenance banner is env-driven, renders correctly in dev, and dismisses only until refresh
  • Safer runtime behavior:
    • production static serving is separated from local Vite dev serving
    • SYSTEM/start.sh --restart -f now reliably restarts old frontend/backend processes before tailing logs

πŸ”₯ Previous Release: v1.3.13

  • Gateway-config hardening on dashboard-managed openclaw.json writes:
    • protected gateway fields are preserved instead of replaying stale in-memory values
    • covered write paths now include model overrides, skills updates, transfer/import writes, and profile-mode registration
  • Better artifact visibility:
    • uploaded AGENTS asset directories like cw-items no longer appear as fake agents in notifications
    • DocHub shows created / last updated timestamps and compact freshness hints for asset files
  • More visible tests:
    • SYSTEM/test.sh now surfaces dedicated workspace-artifact notification coverage

πŸ”₯ Previous Release: v1.3.12

  • Dashboard token logging is safer:
    • first-run token generation logs only token creation, token file path, and a redacted preview
  • Setup/bootstrap defaults are more current:
    • setup.sh aligns with the current v1.3.x line and current runtime guidance
  • Release/test hygiene improved:
    • visible SYSTEM/test.sh coverage expanded again to include newer focused suites

Hosted/operator-managed runtime note:

  • The container image now expects persistent OpenClaw state under ~/.openclaw in addition to workspace files.
  • If you deploy via Docker or Kubernetes, persist both the workspace path and the OpenClaw state path; agent registration and sessions will not survive otherwise.
  • For GitHub issue/PR workflows in non-interactive deployments, prefer a runtime GITHUB_TOKEN/GH_TOKEN plus a default repo in Workspaces Integrations. Keep gh auth login for local/dev and operator-managed environments.

🌟 Features

Agent Management

  • Visual Agent Roster - View all agents with status, tags, and activity
  • Agent Creation - Bootstrap new agents from templates or use built-in system agents to generate your agents passing description
  • Organization Templates - Import pre-configured agent teams or organizations
  • Skills Assignment - Assign 50+ built-in skills to agents or import your own skill and assign
  • Tag-based Filtering - Organize agents by role, project, or capability

Communication & Monitoring

  • Real-time Chat - Interactive chat with any agent via CLI proxy
  • Group Conversations - Multiagent group chats and communities
  • Activity Feed - Track agent actions, file changes, and workflow executions
  • Status Dashboard - System health, agent count, workspace metrics, and optionally costs and budget via Opik (requires Comet Opik service)
  • Budget Controls - Workspace-level budget visibility and enforcement to pause costly execution before spend drifts
  • Opik Trace Attribution - Manual chats and workflow runs now stamp workspace, agent/workflow, and real dashboard user identity into trace metadata so shared projects can still be filtered cleanly by user and workspace

Authentication & Keys

  • GitHub OAuth Login - GitHub remains the primary general-purpose dashboard login path
  • Email OTP Login - Single-user hosted/operator-managed login mode with allowlisted email(s), short-lived codes, and persistent session cookies after verification
  • Workspaces Integrations / BYOK - Users can configure hosted and local model providers plus optional integrations for their agents and workflows
  • Keys & Secrets Browser Vault - A central browser-local vault can capture reusable provider and partner keys once, then prefill matching template, workflow, skill, and integration inputs
  • Browser-Local Runtime Secrets - Templates, workflows, and skills can request browser-local secrets like API keys, event slugs, or export paths without persisting them to the server by default
  • Separated Key Policy - Dashboard/system actions use SYSTEM_* keys; user execution prefers BYOK or USER_* keys

Keys & Secrets safety model:

  • Values in Keys & Secrets are stored in the current browser only. They are meant to centralize capture and reuse across dashboard forms, not to act as a secure remote secrets manager.
  • ClawMax uses the browser vault to prefill matching inputs for templates, workflows, skills, and visible partner integrations. Users can still override values locally for a specific apply/run/edit flow.
  • Browser-local values are not a substitute for proper server-side or infrastructure secret management. For production hosted or operator-managed deployments, keep system/runtime secrets in environment variables, secret stores, or your platform’s native secret manager.
  • If you share a browser profile or machine, treat browser-local vault contents as locally accessible to that profile. Clear or rotate values when changing environments or handing a machine to someone else.

Workflows & DAG

  • Workflow DAG Visualization - Interactive dependency graph with parallel lanes and connecting lines
  • DAG Execution Engine - Auto-advance pipeline: complete β†’ check deps β†’ trigger next
  • Workflow Designer - Create scheduled or manual workflows
  • Progress Tracking - Real-time progress bars from agent stdout activity
  • Blocker Surfacing - Agents declare blockers, rendered as actionable notifications
  • Agent Targeting - Route workflows by tags, groups, or communities
  • Execution History - Track workflow runs and results
  • Structured Workflow Inputs - Persist kickoff/start input summaries in execution records for better dashboards and traceability
  • Cron Scheduling - Set recurring workflows with flexible schedules
  • WORKFLOW.md Format - Define workflows as YAML frontmatter + markdown

Templates

  • 50+ Organization Templates - Business, technical, personal, science, travel, hobbies, family, events, markets, product research, and launch proposal templates
  • 25 Reusable Agent Templates - Leadership, engineering, research, events, testing, market, product, competitive, astronomy, and prototype roles that can be reused independently
  • Editable Workspace Variants - Start from built-in agent and organization templates, refine them, and save workspace-local variants without overwriting system templates
  • 5-Step Template Wizard - Team Type β†’ Composition β†’ Communication β†’ Workflows β†’ Preview
  • Secrets Step for Secure Inputs - Templates with secret or runtime-input requirements now get a browser-local Secrets step during apply
  • AI Generate - Describe a team, AI fills all wizard steps
  • Local-First Template Feedback - Templates can collect star ratings and short optional feedback locally in the active workspace, and can optionally proxy the same payload to a remote web sink when configured
  • Smart Workflow Customization - Dynamic form fields (dropdowns, checkboxes) from template placeholders
  • GitHub Coordination - Toggle to add github skills and inject repo instructions into all workflows
  • Category Filters - Business, Technical, Personal, Events, Science, Travel, Hobbies, and Family template categories
  • Collapsible Template Sections - Collapse or expand Agent / Organization / Workflow sections while browsing
  • TEMPLATE.md Format - Lean markdown format with structured body sections
  • Import/Export - Download and upload templates and workflows as .md files

Local template feedback for developers:

  • Template ratings and short feedback are stored in the active workspace at WORKSPACE/SYSTEM/template-feedback.json by default
  • This is intentional for local dev and OSS use: you can inspect, back up, diff, or clear that file directly
  • If you set all three remote feedback env vars below, the dashboard will submit feedback to the remote sink instead of the local workspace file:
    • TEMPLATE_FEEDBACK_REMOTE_URL
    • TEMPLATE_FEEDBACK_SUMMARY_URL
    • TEMPLATE_FEEDBACK_TOKEN
  • The dashboard client still uses the same local /api/templates/.../feedback routes either way; the server decides whether to use local workspace JSON or the configured remote sink

Workspace Visibility

  • Shareable Workspace Dashboards - Generate public read-only links for workspace status, workflows, costs, results, and group chats
  • Compact Summary Charts - Dense compact-mode agent/workflow/notification visual summaries
  • Display Modes - Compact, Standard, and Detail views for different audiences
  • Live Theme Toggle - Shared dashboards follow ClawMax light/dark preference with a top-right toggle

Skills Marketplace

  • 50+ Built-in Skills - github, slack, web-search, code-review, and more
  • Shipables.dev Registry - Search, browse, and install from 1,000+ skills
  • Bulk Assignment - Add skills to multiple agents at once
  • Custom Skills - Import from local directory or GitHub
  • Partner Skills - Surface partner-backed skill references and curated install actions from Workspaces Integrations
  • AI Skill Creation - Generate a new skill scaffold from intent, refine it iteratively, and fill missing SKILL.md sections with guidance

Notifications

  • Dynamic Blocker UI - Approval buttons, choice pills, input fields, delegation picker
  • Agent Actions - Restart, pause agents directly from notifications
  • Progress Bars - Workflow progress in notification dropdown
  • Search - Filter notifications by title, message, or type

Open Template & Workflow Registries

ClawMax templates and workflows are open source and community-driven:

Contribute your own! Submit a PR with your TEMPLATE.md or WORKFLOW.md β€” help the community build better multiagent teams.

Multi-Workspace Support

  • Workspace Switching - Manage multiple isolated agent environments
  • Workspace Tagging - Color-code and label workspaces
  • Independent Configs - Each workspace has its own agents and settings

πŸš€ Quick Start

Prerequisites

  • OpenClaw installed and running (Installation Guide)
    • Tested Version: commit 55c2aaf (March 2026)
    • Version Note: ClawMax evolves quickly with OpenClaw. Prefer a recent OpenClaw build from March 2026 or later.
  • Node.js 18+ and npm
  • Git for cloning the repository
  • API Keys (required for agents):
    • Anthropic API key (ANTHROPIC_API_KEY) for Claude models
    • OpenAI API key (OPENAI_API_KEY) for GPT models

Automated Installation (Recommended)

# Clone the repository
git clone https://github.com/Maximilien-ai/clawmax.git
cd clawmax

# Run automated setup
./setup.sh

The setup script will:

  • βœ… Check prerequisites (Node.js, Git, OpenClaw)
  • βœ… Verify OpenClaw version compatibility
  • βœ… Install dashboard dependencies
  • βœ… Configure workspace structure
  • βœ… Offer auth setup choices for local dev and production
  • βœ… Generate authentication token
  • βœ… Set up environment variables
  • βœ… Verify API keys (with instructions if missing)
  • βœ… Optionally install OpenClaw Gateway for chat

For local development, ./setup.sh now offers:

  • Email OTP dev mode, which asks what login email you want in SYSTEM/dashboard/.env
  • bypass mode, if you explicitly do not want auth

When you choose local dev Email OTP, the latest login code is written to:

  • .clawmax-otp-dev.json

Manual Installation (Alternative)

# Clone the repository
git clone https://github.com/Maximilien-ai/clawmax.git
cd clawmax

# Install dependencies
cd SYSTEM/dashboard && npm install && cd ../..

# Set up workspace directories
mkdir -p WORKSPACES/default/{AGENTS,WORKFLOWS,ORG,TEMPLATES,PARTNERS,SYSTEM}
mkdir -p WORKSPACES/default/SKILLS/custom

# Configure dashboard-local env
cp SYSTEM/dashboard/.env.example SYSTEM/dashboard/.env
# Then edit SYSTEM/dashboard/.env with your auth mode and provider keys

# Start the dashboard
./SYSTEM/start.sh

# Dashboard will be available at http://localhost:5173
# API server runs on http://localhost:3001

# Alternate local ports when another instance is already running:
DASHBOARD_PORT=3002 DASHBOARD_CLIENT_PORT=5174 DASHBOARD_APP_URL=http://localhost:5174 ./SYSTEM/start.sh

Auth options:

# GitHub OAuth
DASHBOARD_AUTH_MODE=github_oauth

# Email OTP for single-user hosted/operator-managed installs
DASHBOARD_AUTH_MODE=email_otp
OTP_ALLOWED_EMAILS=you@example.com
RESEND_API_KEY=your_resend_api_key
OTP_FROM_EMAIL=max@clawmax.ai

# Local developer OTP flow without live email
OTP_DEV_MODE=log
# Latest code is written to .clawmax-otp-dev.json

# Optional partner visibility in Workspaces Integrations
WORKSPACES_INTEGRATIONS_THIRD_PARTIES=senso,opik,github

# Optional Ollama visibility override for Workspaces Integrations.
# Default:
# - local/native or operator-managed runtime with dashboard .env present: enabled
# - non-interactive hosted runtime with no dashboard .env: hidden
DASHBOARD_ENABLE_OLLAMA=false

# Optional extra partner roots
CLAWMAX_EXTRA_PARTNER_DIRS=$PWD/WORKSPACES/default/PARTNERS

Notes:

  • Built-in partner definitions ship in the repo-level PARTNERS/ directory.
  • WORKSPACES/default/PARTNERS is a good place for local or experimental partner definitions without editing built-ins.
  • If you build or deploy the dashboard in a container, make sure the image includes the repo PARTNERS/ directory.
  • DASHBOARD_ENABLE_OLLAMA controls only whether Ollama appears in the dashboard UI. It does not provision an Ollama runtime for hosted deployments.

First Steps

  1. Create Your First Agent

    • Open http://localhost:5173
    • Navigate to Templates β†’ Organizations
    • Import "Small Startup Team" to get CEO, Engineer, and Product Manager agents
  2. Assign Skills

    • Go to Skills tab
    • Select an agent
    • Click skills to assign (github, web-search, email, etc.)
  3. Start a Conversation

    • Go to Agents tab
    • Click on an agent
    • Click the πŸ’¬ Chat icon to start a conversation
  4. Create a Workflow

    • Go to Workflows tab
    • Click "New Workflow"
    • Set schedule, target agents, and content
    • Save and enable
  5. Explore Templates & DAG

    • Go to Templates and browse 35+ team templates by category (Business, Technical, Personal, Science, Travel, Hobbies, Family)
    • Try "Technical Writing" β€” creates a full writing team with editor, writers, reviewer, and publisher
    • Try "ClawMax System Test" β€” a test template with 3 agents and a 5-step workflow DAG (kickoff β†’ sequential β†’ parallel β†’ final)
    • After applying a template, go to Workflows β†’ click the β—‡ DAG view button to see the dependency graph
    • Each template creates a complete team: agents, communities, groups, and interconnected workflows with kickoff

πŸ”‘ API Key Configuration

ClawMax has two key scopes and one explicit precedence policy:

  • SYSTEM/dashboard/.env system keys: used by dashboard-owned features such as agent generation, workflow generation, cron/system agents, and future platform automations.
  • user BYOK/default user keys: used by the logged-in user's own agents and workflows by default.

Important:

  • provider keys are resolved from SYSTEM/dashboard/.env policy, not from shell exports like ~/.zshrc
  • user execution precedence is:
    1. BYOK keys provided in-app
    2. USER_* defaults from SYSTEM/dashboard/.env
    3. system keys only if ALLOW_SYSTEM_KEYS_FOR_USER_EXECUTION=true
  • system/dashboard-owned execution precedence is:
    1. SYSTEM_* keys from SYSTEM/dashboard/.env
    2. USER_* fallback only if no system key is configured

Recommended SYSTEM/dashboard/.env setup:

SYSTEM_ANTHROPIC_API_KEY=sk-ant-your-system-key
SYSTEM_OPENAI_API_KEY=sk-your-system-key
# Optional default user keys
# USER_ANTHROPIC_API_KEY=sk-ant-your-user-key
# USER_OPENAI_API_KEY=sk-your-user-key
# Optional temporary fallback for user execution
# ALLOW_SYSTEM_KEYS_FOR_USER_EXECUTION=false
Variable Provider Required
SYSTEM_ANTHROPIC_API_KEY Anthropic system key At least one system key
SYSTEM_OPENAI_API_KEY OpenAI system key At least one system key
USER_ANTHROPIC_API_KEY Optional default user Anthropic key Optional
USER_OPENAI_API_KEY Optional default user OpenAI key Optional
ALLOW_SYSTEM_KEYS_FOR_USER_EXECUTION Lets user agents/workflows fall back to system keys Optional, defaults to false
GITHUB_CLIENT_ID GitHub OAuth client ID Required for GitHub auth
GITHUB_CLIENT_SECRET GitHub OAuth client secret Required for GitHub auth
CORS_ORIGIN Frontend app origin Required for local/proxied OAuth correctness
DASHBOARD_APP_URL Frontend redirect target after login/logout Optional but recommended

Without system keys, the dashboard may still boot, but system-generated flows such as agent/workflow generation will be limited. Without user keys, end-user agents should eventually rely on BYOK capture after login.

πŸ” Dashboard Auth Setup

ClawMax supports three dashboard auth modes:

  • github_oauth
  • email_otp
  • bypass

If DASHBOARD_AUTH_MODE is omitted, ClawMax defaults to:

  • github_oauth

Use:

  • github_oauth for normal multi-user or GitHub-based owner access
  • email_otp for single-user hosted or operator-managed installs
  • bypass only for solo local development when you intentionally do not want auth

GitHub OAuth

GitHub OAuth is the primary dashboard login path.

Minimum local setup in SYSTEM/dashboard/.env:

CORS_ORIGIN=http://localhost:5173
GITHUB_CLIENT_ID=your-github-client-id
GITHUB_CLIENT_SECRET=your-github-client-secret

Recommended when you want redirects to be explicit:

DASHBOARD_PORT=3001
DASHBOARD_APP_URL=http://localhost:5173
# DASHBOARD_PUBLIC_URL=http://localhost:3001

GitHub OAuth app values:

  • Homepage URL: http://localhost:5173
  • Callback URL: http://localhost:3001/api/auth/github/callback

If you run on alternate local ports, keep the pair aligned. Example:

DASHBOARD_PORT=3002
DASHBOARD_CLIENT_PORT=5174
DASHBOARD_APP_URL=http://localhost:5174
CORS_ORIGIN=http://localhost:5174

Email OTP

Email OTP is the recommended login mode for single-user hosted and operator-managed installs.

Minimum setup in SYSTEM/dashboard/.env:

DASHBOARD_AUTH_MODE=email_otp
OTP_ALLOWED_EMAILS=you@example.com
RESEND_API_KEY=your_resend_api_key
OTP_FROM_EMAIL=ClawMax <onboarding@your-verified-domain.com>
OTP_EMAIL_SUBJECT=Your ClawMax login code

Recommended:

OTP_EXPIRY_MINUTES=15
DASHBOARD_APP_URL=http://localhost:5173
# DASHBOARD_PUBLIC_URL=http://localhost:3001

Developer mode:

DASHBOARD_AUTH_MODE=email_otp
OTP_ALLOWED_EMAILS=dev@example.com
OTP_DEV_MODE=log

OTP_DEV_MODE currently supports only:

  • log

If OTP_DEV_MODE is unset, or set to any other value:

  • dev OTP logging is disabled
  • email_otp then requires real email delivery such as RESEND_API_KEY

When OTP_DEV_MODE=log is enabled:

  • no live email is sent
  • the OTP is logged to the main dashboard server stdout/stderr stream
  • the latest code is written to .clawmax-otp-dev.json
  • the login UI shows the path after requesting a code

For real email delivery:

  • set RESEND_API_KEY
  • set a verified sender in OTP_FROM_EMAIL
  • or let OTP fall back to SIGNUP_FROM_EMAIL if you intentionally share the sender config with the web app

Recommended local-tool/bootstrap defaults:

DASHBOARD_AUTH_MODE=email_otp
OTP_ALLOWED_EMAILS=developer@example.com
OTP_DEV_MODE=log
OTP_EXPIRY_MINUTES=15

Bypass Auth

Use bypass only for local-only development when you explicitly want no login wall:

DASHBOARD_AUTH_MODE=bypass

Legacy compatibility still exists:

BYPASS_OAUTH=true

But prefer DASHBOARD_AUTH_MODE=bypass going forward.

Detailed setup and troubleshooting:


πŸ“– Documentation

User Guides

Developer Resources

Specifications

OpenClaw Integration


πŸ§ͺ Testing

ClawMax includes 212+ tests across unit, API, and integration suites:

# Unit + API tests (134 tests, fast, no LLM cost)
./SYSTEM/test.sh

# + Integration tests with live agents (~$0.03, requires keys)
./SYSTEM/test.sh integration

# Check dashboard status
./SYSTEM/status.sh

Test Suites:

  • 78 unit tests (notifications, workflows, validator, templates, skills, and more)
  • 134 API tests (26 sections covering all endpoints)
  • Integration tests with ClawMax System Test template (live agent DAG execution)

See TESTING_GUIDE.md for full details.


πŸ› οΈ Development

Project Structure

clawmax/                        # ClawMax repo root
β”œβ”€β”€ WORKSPACES/                 # All ClawMax-managed workspaces (v1.0.2+)
β”‚   β”œβ”€β”€ default/                # Default workspace
β”‚   β”‚   β”œβ”€β”€ AGENTS/             # Agent configurations
β”‚   β”‚   β”œβ”€β”€ WORKFLOWS/          # Workflow definitions
β”‚   β”‚   β”œβ”€β”€ ORG/                # Organization files
β”‚   β”‚   └── TEMPLATES/          # Workspace-local templates (optional)
β”‚   └── TEMPLATES/              # Shared workspace templates
β”œβ”€β”€ TEMPLATES/                  # Global system templates (shared across all workspaces)
β”‚   β”œβ”€β”€ agents/                 # System agent templates
β”‚   └── organizations/          # System organization templates
β”œβ”€β”€ SYSTEM/
β”‚   β”œβ”€β”€ dashboard/              # Main dashboard application
β”‚   β”‚   β”œβ”€β”€ server/             # Express API server
β”‚   β”‚   β”‚   β”œβ”€β”€ index.ts        # Server entry point
β”‚   β”‚   β”‚   β”œβ”€β”€ routes/         # API routes
β”‚   β”‚   β”‚   └── lib/            # Business logic
β”‚   β”‚   └── client/             # React frontend
β”‚   β”‚       └── src/
β”‚   β”‚           β”œβ”€β”€ pages/      # Main page components
β”‚   β”‚           └── components/ # Reusable components
β”‚   β”œβ”€β”€ docs/                   # Documentation
β”‚   β”œβ”€β”€ start.sh                # Start dashboard
β”‚   β”œβ”€β”€ stop.sh                 # Stop dashboard
β”‚   β”œβ”€β”€ status.sh               # Check status
β”‚   └── test.sh                 # Run tests
β”œβ”€β”€ setup.sh                    # Automated installation script
β”œβ”€β”€ LICENSE                     # MIT License
└── README.md                   # This file

Development Commands

# Start in development mode (hot reload)
./SYSTEM/start.sh --follow

# Stop the dashboard
./SYSTEM/stop.sh

# Check if dashboard is running
./SYSTEM/status.sh

# Run tests
./SYSTEM/test.sh

# Build the dashboard bundle
cd SYSTEM/dashboard
npm run build

Tech Stack

  • Frontend: React 18, TypeScript, Tailwind CSS, Vite
  • Backend: Node.js, Express, TypeScript
  • Storage: File-based (markdown files with YAML frontmatter)
  • Communication: WebSocket (via OpenClaw Gateway), REST API
  • Testing: Custom test framework with curl + jq

πŸ”’ Security

ClawMax follows security best practices:

  • Token Authentication - Dashboard token required for API access
  • Local-first - All data stored locally, no external services
  • Workspace Isolation - Each workspace is completely independent
  • Input Validation - All user inputs validated and sanitized
  • No Secret Commits - .env and token files in .gitignore

For detailed security information, see SECURITY.md.

To report security issues: Please email security@clawmax.ai (do not open public issues).


πŸ› Known Issues

See KNOWN_ISSUES.md for active issues and workarounds.


πŸ—ΊοΈ Roadmap

  • Now β€” Workflow v2 polish (DAG run buttons, per-workspace budget, cron cascade)
  • Next β€” Agent-to-agent messaging, community rules, workflow DAG visualization improvements
  • Later β€” Secure multi-user BYOK storage, broader hosted/operator-managed packaging, public template registry

Full backlog: BACKLOG.md


🀝 Contributing

We welcome contributions! Whether it's bug fixes, new features, or documentation improvements.

How to Contribute

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Make your changes
  4. Run tests (./SYSTEM/test.sh)
  5. Commit your changes (git commit -m 'Add amazing feature')
  6. Push to branch (git push origin feature/amazing-feature)
  7. Open a Pull Request

Development Guidelines

  • Write tests for new features
  • Follow existing code style (TypeScript, React best practices)
  • Update documentation for user-facing changes
  • Keep commits focused and descriptive

πŸ“„ License

ClawMax is released under the MIT License.

Copyright (c) 2026 ClawMax AI LLC

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

πŸ™‹ Support

Getting Help

Commercial Support

Visit ClawMax.ai for commercial offerings:

ClawMax Cloud

  • Fully managed multiagent orchestration platform
  • Deploy teams from 35+ templates in minutes
  • Built-in workflow DAG visualization and monitoring
  • Shipables.dev skill marketplace integration
  • No infrastructure to manage

ClawMax On-Premise

  • Run ClawMax entirely on your own infrastructure
  • Full data sovereignty β€” all agent data, conversations, and API keys stay within your network
  • Works behind corporate firewalls with no external dependencies
  • Deploy via Docker, Kubernetes, or bare metal
  • Connect to your own LLM endpoints (Azure OpenAI, AWS Bedrock, self-hosted models)
  • Integrate with internal tools (Jira, Confluence, Slack, custom APIs) via skills
  • Ideal for personal use and regulated industries (finance, healthcare, government) requiring data residency

ClawMax Enterprise

  • Everything in On-Premise, plus:
  • Custom agent templates and workflows tailored to your organization
  • Priority support with SLA
  • SSO/SAML authentication
  • Dedicated success manager
  • Training and onboarding for your teams

For pricing and inquiries: contact@clawmax.ai | clawmax.ai


🌟 Acknowledgments

ClawMax is built on top of OpenClaw, the open-source AI agent platform.

Special thanks to:

  • The OpenClaw team for the core agent framework
  • All contributors who helped shape ClawMax
  • Early adopters who provided valuable feedback

Built with ❀️ by the Maximilien.ai ClawMax team

🦞 Powered by OpenClaw | πŸš€ Ready to take for a spin | πŸ“– Well Documented

About

ClawMax is OpenClaw to the Max! πŸš€ A web orchestration layer for OpenClaw agents, teams, workflows, and templates.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors