Clawforge

README

<p align="center">
  <img src="docs/images/logo.png" alt="ClawForge" width="200" />
</p>

<h1 align="center">ClawForge</h1>

<p align="center">
  <img src="docs/images/demo.gif" alt="ClawForge Demo" width="700" />
</p>

<p align="center">
  <strong>One dashboard to govern all your AI assistants.</strong>
</p>

<p align="center">
  ClawForge is the admin layer for <a href="https://github.com/openclaw/openclaw">OpenClaw</a>. It gives organizations centralized control over authentication, tool policies, skill governance, audit trails, and a remote kill switch — across every OpenClaw instance in the fleet.
</p>

---

<p align="center">
  <img src="docs/images/architecture.png" alt="How ClawForge Connects Everything" width="700" />
</p>

## Features

- **Centralized Policy Enforcement** — Define tool allow/deny lists and enforcement profiles from one place
- **Skill Governance** — Employees submit skills for admin review; only approved skills run in production
- **Audit Trail** — Every tool call, session, and LLM interaction is logged and queryable
- **Kill Switch** — Instantly disable all AI tool access across the entire org in an emergency
- **SSO / OIDC** — Okta, Auth0, Entra ID, or any OIDC provider, alongside email/password auth
- **Enrollment Tokens** — Generate invite tokens to onboard new users without SSO
- **Heartbeat Monitoring** — Know which instances are online and what policy version they're running
- **`/clawforge-status`** — Users can see their auth state, org, policy version, and kill switch status

## Quick Start

```bash
git clone https://github.com/ClawForgeAI/clawforge.git
cd clawforge
docker compose up --build
```

Once running:

- **Admin Console** — [localhost:4200](http://localhost:4200)
- **API** — [localhost:4100](http://localhost:4100)
- **Login** — `[email protected]` / `clawforge`

> For manual setup, SSO configuration, and connecting an OpenClaw gateway, see the [Setup Guide](docs/setup.md).

## Documentation

| Guide | Description |
| --- | --- |
| [Setup Guide](docs/setup.md) | Docker, manual setup, SSO, connecting OpenClaw |
| [Architecture & How It Works](docs/architecture.md) | Package structure, core concepts, data flows, database schema |
| [API Reference](docs/api-reference.md) | Every endpoint with request/response examples |
| [Configuration](docs/configuration.md) | Plugin config, server env vars, admin console env vars |
| [Roadmap](docs/roadmap.md) | What's next for ClawForge |

## Contributing

Contributions are welcome! Please open an issue or submit a pull request.

## License

MIT