# OpenClaw

Build and manage websites through your OpenClaw agent. Install the sitemd plugin and your agent gets 35 MCP tools for creating pages, generating content, and deploying sites — all from any messaging channel.

## What is OpenClaw?

[OpenClaw](https://openclaw.ai/) is an open-source AI agent framework that runs locally and connects to messaging platforms like WhatsApp, Telegram, Discord, Slack, and Signal. Agents run 24/7, remember context across conversations, and can use tools via [MCP](https://modelcontextprotocol.io/) (Model Context Protocol).

sitemd ships as both an OpenClaw skill and plugin. Once installed, your agent can build websites from a chat message.

## Install sitemd for OpenClaw

### Option 1: Plugin install (recommended)

Install from [ClawHub](https://clawhub.com):

```bash
openclaw plugins install sitemd-plugin
```

This registers the MCP server automatically. All 35 tools are available to your agents immediately.

### Option 2: Skill install

```bash
openclaw skills install sitemd
```

### Option 3: Manual MCP configuration

Add the sitemd MCP server to your `~/.openclaw/openclaw.json`:

```json
{
  "mcpServers": {
    "sitemd": {
      "command": "/path/to/your/site/sitemd/sitemd",
      "args": ["mcp"],
      "env": {
        "SITEMD_PROJECT_ROOT": "/path/to/your/site"
      }
    }
  }
}
```

Restart your gateway after adding the config:

```bash
openclaw gateway restart
```

## Build a site from chat

Once sitemd is installed, tell your agent what you want:

> "Build me a website for my photography portfolio"

Your agent will:

1. Create a new sitemd project with pages, navigation, and styling
2. Send you a preview link to review
3. Deploy to your hosting provider on your confirmation

You can also update your site through conversation:

> "Add a blog post about our latest project"

> "Update the pricing page — we raised the starter plan to $29"

> "Deploy the site"

Your agent handles the MCP tool calls behind the scenes. You just describe what you want.

## Authentication from messaging

sitemd uses email magic links for login. Your agent handles the flow:

1. Your agent calls `sitemd_auth_login` and gets a browser URL
2. It sends you the URL as a message in your chat
3. You tap the link on your phone and complete login
4. Your agent polls `sitemd_auth_poll` and detects when you're authenticated

Authentication persists across sessions. For fully automated deploys, create an API key:

> "Create an API key for automated deploys"

Your agent calls `sitemd_auth_api_key` and stores the resulting `SITEMD_TOKEN` in its environment. No more login prompts.

## SOUL.md template

The sitemd ClawHub plugin ships with a ready-to-use [SOUL.md](https://docs.openclaw.ai/reference/templates/SOUL) — it's included automatically when you install the plugin. Customize it to fit your agent's personality:

```markdown
# SOUL.md — Website Builder

You build and manage websites for people through conversation,
powered by sitemd.

## Identity

You are a website builder. When someone needs a website — a landing
page, a blog, documentation, a portfolio, a business site — you
make it happen.

## Core Capabilities

- Create websites from scratch — kickstart from a description
- Write and update content — blog posts, docs, changelogs, pages
- Clone existing websites — scrape and recreate as editable markdown
- Deploy to production — Cloudflare, Netlify, Vercel, GitHub Pages

## Behavior

When someone asks for a website:
1. Call sitemd_status to check project state
2. Create pages with sitemd_pages_create
3. Validate with sitemd_content_validate
4. Deploy with sitemd_deploy on confirmation

## Authentication

Send the login URL as a message. Poll sitemd_auth_poll until approved.
For hands-free deploys, use sitemd_auth_api_key.

## Voice

Be direct and practical. Show what you built rather than explaining
what you'll do. If something needs a paid feature, say so plainly.
```

Submit your own SOUL.md variations to [awesome-openclaw-agents](https://github.com/mergisi/awesome-openclaw-agents).

## Available MCP tools

sitemd exposes 35 tools through MCP. Here are the ones your agent will use most:

| Tool | What it does |
|---|---|
| `sitemd_status` | Check project state, pages, auth, and config |
| `sitemd_pages_create` | Create a new page with frontmatter and content |
| `sitemd_site_context` | Get writing brief, site voice, and syntax reference |
| `sitemd_content_validate` | Check page quality and fix issues |
| `sitemd_deploy` | Build and deploy to your hosting target |
| `sitemd_clone` | Scrape an existing website into editable markdown |
| `sitemd_auth_login` | Start email magic link login |
| `sitemd_auth_poll` | Poll for login completion |
| `sitemd_config_set` | Set deploy credentials, email keys, analytics IDs |

For the full tool reference, see [MCP Server](/docs/mcp-server).

## Bulk licensing

sitemd costs $79 one-time for 3 starter site slots, then $19 for each additional site slot. If your OpenClaw agent manages many sites — for clients, teams, or projects — purchase 50+ slots at once for a 15% bulk discount.

Check your current slots:

> "How many site slots do I have?"

Your agent calls `sitemd_auth_status` and reports your license count, total slots, and usage.

Visit [pricing](/pricing) for current rates and bulk tiers.