clawmaster · OpenClaw Control Plane

A guided desktop app and self-hosted web console for OpenClaw.

📦 Releases  ·  💬 Discussions  ·  🐛 Issues  ·  Discord   |   English  ·  中文  ·  日本語

ClawMaster vs. CLI Only

Who It Is For

"I manage OpenClaw for my team."
One place to configure channels, rotate API keys, and monitor token spend — no SSH, no JSON editing.

"I'm building agents with LangChain."
Quick observability into context usage, memory snapshots, and cost-per-session without writing monitoring code.

"I'm setting up OpenClaw for the first time."
The setup wizard walks you through provider, model, gateway, and channel in one flow. No docs required to reach a working state.

What You Can Do

• Setup and profiles — Detect OpenClaw, install missing pieces, create or switch profiles, bootstrap a local environment.
• Models and providers — Configure OpenAI-compatible and provider-specific endpoints, validate API keys, set runtime defaults.
• Gateway and channels — Bring up the gateway, follow guided setup for Feishu, WeChat, Discord, Slack, Telegram, and WhatsApp.
• Plugins, skills, and MCP — Enable or disable capabilities, install curated items, add MCP servers, import MCP definitions.
• Sessions, memory, and observability — Inspect sessions, manage memory backends, track token usage and estimated spend.

Quick Start

Download the latest installer from GitHub Releases.

[!NOTE]
CI also uploads per-platform artifacts for every push to main (7-day retention) if you need an unreleased build.

git clone https://github.com/clawmaster-ai/clawmaster.git
cd clawmaster
npm install
npm run dev:web     # web app + backend
npm run tauri:dev   # desktop app

Requirements: Node.js 20+. For Tauri desktop builds, also Rust — see tauri.app/start/prerequisites.

npm i -g clawmaster
clawmaster doctor
clawmaster serve --daemon
clawmaster status

Default service URL: http://127.0.0.1:3001. clawmaster serve prints a service token — enter it in the browser UI when prompted.

Common flags:

clawmaster serve --host 127.0.0.1 --port 3001 --daemon
clawmaster serve --host 127.0.0.1 --port 3001 --token your-own-token
clawmaster stop
clawmaster doctor

First Run

1. Launch ClawMaster.
2. Choose an existing OpenClaw profile or create a new one.
3. Connect at least one model provider and set a default model.
4. Enable gateway or observability if you need runtime inspection.
5. Add channels, plugins, skills, or MCP servers as needed.

Roadmap

Six capabilities — tracked as labeled issues:

Browse label:roadmap to pick up an item. Leave a comment before starting — core contributors who land roadmap features can claim model credits from the OpenClaw team.

📰 News

• 2026-04-13 🏗️ Contribution workflow tightened with issue forms, a stronger PR template, PR description validation, and architecture boundary tests.

Development

npm install
npm run dev:web       # frontend + backend
npm run dev           # frontend only (port 3000)
npm run dev:backend   # backend only (port 3001)
npm run tauri:dev     # desktop app

npm test              # unit tests (Vitest)
npm run build         # type check + production build
npm run test:desktop  # desktop smoke (macOS: real Tauri build; Linux/Win: WebDriver)

[!TIP]
Run npm test && npm run build before opening a PR — the same steps run in CI.

CI covers: TypeScript check, unit tests, backend integration smoke, web smoke, desktop smoke, and multi-platform Tauri builds.

• Test Suite
• Desktop Bundles

clawmaster/
├── packages/web/          React + Vite frontend
├── packages/backend/      Express backend for web mode
├── src-tauri/             Tauri desktop host
├── tests/ui/              YAML-based manual UI flow specs
└── bin/clawmaster.mjs     CLI entry point

Runtime model: Desktop — React calls Tauri commands via invoke(); Web — React proxies /api to Express.

Contributing

Using an AI coding agent? Point it at AGENTS.md first — it covers the full contribution workflow, module patterns, and hard rules in agent-readable form.

See CONTRIBUTING.md for setup, testing requirements, dependency policy, commit convention, and PR checklist.

[!IMPORTANT]
PRs must pass npm test locally before opening. No screenshots, test logs, or generated files in commits. Node.js is the only permitted runtime — no new language dependencies.

Community: GitHub Discussions · Discord · Feishu

Contributors

License

MIT. See LICENSE.