Getting Started
How To Install ClawMagic
ClawMagic is free, open-source software that runs on your computer. Follow the steps below to get up and running — no coding experience required.
What Is ClawMagic?
Think of it as a smart app that lives on your machine — no accounts, no monthly fees.
Runs Like a Website
ClawMagic runs as a website on your own computer. No cloud account needed.
Powered by Node.js
You’ll install Node.js first. This is what allows ClawMagic to do its magic.
Your Personal AI Agent
Once running, ClawMagic becomes your AI collaboration team.
Let AI Guide You
We recommend using an AI assistant to walk you through the install process. Open ChatGPT, Claude, or any similar tool, paste our docs page, and follow along step-by-step.
Works on Mac, Windows, and Linux — the AI will adapt the instructions to your system.
Open Full Docs# Install and launch in one line
$ █Or use the one-liner: curl -fsSL https://clawmagic.ai/install.sh | bash
Security Is Built In
ClawMagic runs on localhost — which means the AI can run commands, open browsers, and take action on your computer. We built security controls into every layer, but you are responsible for your own environment.
Portal Password Authentication
Secure your ClawMagic portal with a password you choose. Scrypt-hashed, rate-limited login keeps your system protected.
Encrypted Secret Storage
All API keys and credentials are encrypted with AES-256-GCM. A master key system with backup and restore keeps your secrets safe.
Security Scanning
Built-in security scanner checks firewall, SSH, TLS, system updates, and more. Auto-fix for low-risk issues with a 0–100 security score.
Approval-Gated Actions
Risky operations require your approval before execution. You control what the AI can and cannot do on your machine.
We also recommend treating ClawMagic like a real person.
Give it its own email, its own permissions, and its own accounts. For example, if you share Dropbox, ClawMagic would create its own Dropbox account — and you provide only the access you want to give.
How Onboarding Works
After install, a guided wizard walks you through setup in about 5 minutes. Choose QuickStart for fast defaults or Advanced for full control.
Install & Launch
Run the one-command install script. It handles Node.js, builds the project, installs the browser runtime, and starts the gateway.
Security & Portal Setup
Acknowledge the security risk warning, set your portal password, and confirm security checks pass.
Connect Your AI Provider
Add your API key (OpenAI, Claude, etc.), select your model, and test the connection.
Create Your Agent
Name your agent, set its primary goal, choose autonomy level (ask-first, balanced, or autonomous), and select top tools.
Plugins & Channels
Free plugins are auto-activated. Optionally connect messaging channels (Telegram, Slack, Discord), GitHub, and Google Brain.
Review & Go
Review your agent contract, confirm settings, and start using ClawMagic. The whole process takes about 5 minutes with QuickStart.
You can always change settings later from the portal. The wizard is just the starting point.
Ready to get started?
Explore the docs, browse the marketplace, or jump straight into the code.