Basic Use

ClawMagic is an AI agent that runs on your computer (or server). You give it tasks, it uses your AI provider API key to think, and it executes work using plugins and tools. There are two primary ways to interact with it:

• Remote (chat): message your agent from anywhere through Slack, Discord, Telegram, WhatsApp, or SMS.
• Direct (portal + CLI): use the web portal or terminal on the same machine ClawMagic is running on.

Both methods talk to the same ClawMagic server. Your agent remembers context across conversations, uses the same plugins, and works from the same memory — regardless of how you reach it.

You’re out — at a coffee shop, on the train, in a meeting. You open Slack on your phone and message your agent.

Your message goes through the chat connector plugin to your ClawMagic server. The agent processes it, calls your AI provider with your API key (BYOK), runs any tools or plugins needed, and sends the response back to your chat app.

Todd is a product manager. ClawMagic runs on his home Mac mini, always on.

1. 9:15 AM — Coffee shop. Todd opens Slack on his phone and types: “Summarize the 3 emails from the engineering team and draft replies.”
2. Agent works. ClawMagic reads Todd’s email plugin, retrieves the messages, calls his AI provider (Anthropic, using his API key), and drafts three replies.
3. 9:17 AM. Todd gets the summaries and drafts back in Slack. He approves two, edits one, and sends them — all from his phone.
4. 11:00 AM — Meeting. Todd messages: “What’s on my task list today?”The agent pulls his active checklist from memory and responds with priorities.
5. 2:00 PM — Walking. Todd messages via Telegram: “Research competitor pricing for AI tools and save to memory.”The agent runs a research task in the background and stores findings in long-term memory.

Todd never opened a laptop. His agent ran tasks, accessed plugins, and used his AI provider — all through chat messages on his phone. ClawMagic was running at home the entire time.

You’re at your desk, working on your computer. ClawMagic runs locally and you interact through the web portal in your browser or the CLI in your terminal — or both at once.

Everything runs on the same machine. The portal UI (localhost:5173) talks to the ClawMagic server (localhost:18790), which calls your AI provider. You can also use the CLI for terminal-based interaction and run coding agents like Claude Code or Codex alongside your ClawMagic agent.

Todd is home, building a side project. ClawMagic runs on the same machine.

1. 7:00 PM — Portal chat. Todd opens http://127.0.0.1:18790/ in his browser. He types: “Let’s build a landing page for my new SaaS idea. Start with a project plan.”
2. Agent plans. ClawMagic breaks the task into steps, creates a checklist in memory, and starts research on landing page best practices.
3. 7:10 PM — Coding side-by-side. Todd has Claude Code open in his terminal. He shares the project plan from ClawMagic and starts coding. ClawMagic handles research and copy; Claude Code handles the implementation.
4. 8:00 PM — Plugin workflow. Todd tells his agent: “Use the GitHub plugin to create a repo and push this project.” The agent creates the repo, commits files, and reports back.
5. 8:15 PM — Memory review. Todd checks the portal Memory tab to see what the agent learned during the session — decisions, preferences, and facts stored for next time.
6. 8:30 PM — CLI quick task. Before bed, Todd runs from terminal:clawmagic agent "Schedule a reminder to review the landing page copy tomorrow at 10am"

Todd worked directly alongside his agent — portal for chat and memory, CLI for quick commands, and Claude Code for implementation. All running on the same machine, all using the same agent memory.

Connectors are bundled plugins. Enable them during onboarding (Advanced mode) or from the portal Settings page. Additional connectors are available on the marketplace.