Your Personal AI Agent

A long-lived AI agent that runs in Docker on your machine. Always on, always remembering, always ready to help. Chat via Telegram, browse the web, fill out forms, get proactive reminders, and let it work on your projects — all with persistent memory.

$MOBYCLAW
CA
0x4d6854a4981f56D1A3Eb9774A84458b6519a9201
Get Started → Read the Docs
$ mobyclaw up ✓ Moby is ready! 🐋 Listening on Telegram... 💓 Heartbeat: every 15m 🐋 Telegram Memory Scheduler

Why Mobyclaw?

A personal AI agent that goes beyond chat. It lives on your machine, remembers everything, and takes action.

Persistent Memory

Remembers your name, preferences, projects, and past conversations. Memory lives in plain Markdown files you can read and edit.

Runs in Docker

One ./mobyclaw up and you have a personal AI. Isolated, reproducible, portable. Your data stays on your machine.

Chat via Telegram

Message your agent from Telegram. Get streaming responses with real-time tool status. Discord and Slack support coming soon.

Proactive & Scheduled

Set reminders, schedule recurring tasks, and get a heartbeat that wakes the agent periodically to check on things.

Workspace Access

Mount your project folders. The agent reads, edits, and creates files in your actual codebase. Changes are instant and bidirectional.

Full Web Browser

Headless Chromium powered by Playwright. Navigate pages, fill forms, click buttons, take screenshots. Create accounts, complete multi-step flows — all automated.

Web Search & Reading

Search the web via DuckDuckGo, fetch and extract clean text from any URL. Research topics, read articles, check the weather — 19 tools total.

Self-Improving

Moby can modify its own configuration, personality, and even source code. It evolves based on your needs and feedback.

How It Works

Four Docker containers working together - a gateway for messaging, an AI brain powered by cagent, a tool gateway with a full headless browser, and a dashboard for web UI and maintenance. Code lives in the repo, data lives in your home directory.

Docker Compose Stack - 4 services, 1 data directory gateway :3000 🔌 Telegram 📡 Sessions ⏰ Scheduler 💓 Heartbeat 📬 Deliver 🔀 Routes HTTP moby :8080 cagent serve api 🧠 LLM (Anthropic / OpenAI) 🔧 Shell 📁 Files 🌐 Fetch 🔗 MCP MCP tool-gateway 🎭 Playwright 🔍 Web Search 📄 Page Fetch 🌤️ Weather Volumes: ~/.mobyclaw/ user data /workspace/* projects /source self-modify Tools: 19 MCP tools via tool-gateway — browser automation, web search, fetch, weather Built-in: shell, filesystem, fetch, think — directly in cagent

19 Tools at Moby's Fingertips

From quick web lookups to full browser automation — all exposed via MCP through the tool-gateway container.

🎭 Browser Automation

Full headless Chromium powered by Playwright. Navigate, click, type, fill forms, take screenshots, manage tabs.

You: "Create an account on example.com"

Moby:
  1. browser_navigate("example.com/signup")
  2. browser_fill_form(email, password, name)
  3. browser_click("Sign up" button)
  4. browser_screenshot() → "Done! ✅"

🔍 Web Search & Fetch

Search DuckDuckGo and extract clean, readable text from any URL — like reader mode.

You: "What's new with Docker Compose?"

Moby:
  1. browser_search("Docker Compose 2026")
  2. browser_fetch(top result URL)
  3. Summarizes the article for you

🌤️ Weather & More

Current weather and forecasts for any location via Open-Meteo. No API key needed.

You: "What's the weather in Lisbon?"

Moby: "16.9°C, overcast, 76% humidity
  with a light breeze from the NW.
  Tomorrow: 18°C and partly cloudy."

16 browser tools + 3 utility tools = 19 total. All connected via MCP protocol through a stdio↔HTTP bridge.

Get Started in 3 Steps

From zero to a running personal AI in under 2 minutes.

1

Clone the repo

git clone https://github.com/mobyclaw/mobyclaw.git
cd mobyclaw
2

Run the setup

Interactive wizard walks you through API keys, messaging, and workspaces.

./mobyclaw init
3

Start Moby

That's it. Moby is running, listening, and ready to chat.

./mobyclaw up

# Chat from the terminal
./mobyclaw chat

# Or send a one-shot prompt
./mobyclaw run "Hello, who are you?"

Configure Everything

All configuration lives in simple files. Edit with any text editor — Moby picks up changes automatically.

🔑 API Keys

Set your LLM provider key in .env. Anthropic or OpenAI — your choice.

# .env
ANTHROPIC_API_KEY=sk-ant-...
# or
OPENAI_API_KEY=sk-...

💬 Telegram

Create a bot with @BotFather, add the token.

# .env
TELEGRAM_BOT_TOKEN=123:ABC...

🧠 Personality

Edit ~/.mobyclaw/soul.yaml to customize Moby's personality, model, and behavior.

# ~/.mobyclaw/soul.yaml
agents:
  root:
    name: moby
    model: sonnet
    instruction: |
      You are a helpful agent...

📁 Workspaces

Mount your project folders so Moby can work on your code.

# Add a workspace
./mobyclaw workspace add ~/projects/myapp

# Moby sees it at /workspace/myapp

🔐 Credentials

Give Moby access to GitHub, AWS, and other services.

# ~/.mobyclaw/credentials.env
GH_TOKEN=ghp_...
AWS_ACCESS_KEY_ID=AKIA...

💓 Heartbeat

Configure how often Moby wakes up to check on things.

# .env
MOBYCLAW_HEARTBEAT_INTERVAL=15m
MOBYCLAW_ACTIVE_HOURS=07:00-23:00

CLI Reference

The mobyclaw CLI wraps Docker Compose with agent-aware commands.

./mobyclaw init                    # Interactive setup wizard
./mobyclaw up                      # Start Moby (auto-inits if needed)
./mobyclaw down                    # Stop everything
./mobyclaw chat                    # Interactive chat session
./mobyclaw run "your prompt"       # One-shot prompt
./mobyclaw logs                    # Tail container logs
./mobyclaw logs gateway            # Gateway logs only
./mobyclaw status                  # Show services, channels, health
./mobyclaw exec                    # Shell into the agent container
./mobyclaw workspace list          # Show mounted workspaces
./mobyclaw workspace add <path>    # Mount a project folder
./mobyclaw workspace remove <name> # Unmount a folder