Graph-Native
Multi-Agent AI

• Python 3.12 or 3.13. 3.14 is not supported by jaclang yet. If neither is found, the installer tries Homebrew on macOS or the deadsnakes PPA on Debian/Ubuntu.
• Git.
• A model key: OpenRouter (recommended, one key for Claude and others), Anthropic, or OpenAI. Ollama works with no key.
• The dashboard is a Jac client app; jac-client downloads its own Bun binary the first time, so Node is not required.

curl -fsSL https://raw.githubusercontent.com/zero-abd/graphclaw/main/install.sh | bash

It clones the source to ~/.graphclaw/source, creates a virtualenv at ~/.graphclaw/venv, and installs jaclang plus graphclaw[channels].

• Deployment mode: 1 Single-user (personal agent, no auth) or 2 Multi-user (JWT auth). Pick 1.
• LLM provider: 1 OpenRouter, 2 Anthropic, 3 OpenAI, 4 Ollama, 5 Skip. Paste your key when asked. The default model is openrouter/anthropic/claude-sonnet-4-6.
• First chat interface: 1 Telegram, 2 Discord, 3 Slack, 4 Skip. Each option prints a walkthrough for creating the bot token. Skip is fine: you can chat in the terminal.

It writes ~/.graphclaw/config.json, ~/.graphclaw/.env, a launcher at ~/.graphclaw/run.sh, and a graphclaw alias in your ~/.zshrc or ~/.bashrc.

source ~/.zshrc      # or ~/.bashrc, once
graphclaw

You should see:

[graphclaw] starting -- workspace: ~/.graphclaw/workspace
[graphclaw] dashboard: http://127.0.0.1:18789/
[graphclaw] no channels enabled -- running in CLI mode
[graphclaw] ready
Type your message (Ctrl+C to exit):
>

The dashboard opens at http://127.0.0.1:18789/ (its API is on port 18790). To run without it, set "dashboard": { "enabled": false } in the config or export GRAPHCLAW_DASHBOARD_DISABLE=1.

Edit ~/.graphclaw/config.json and restart graphclaw. Only the channels with "enabled": true start. Email uses IMAP and SMTP over SSL and polls unread mail; WhatsApp talks to a bridge that serves GET /messages and POST /send.

{
  "channels": {
    "telegram": { "enabled": true, "bot_token": "123456:ABC..." },
    "discord":  { "enabled": true, "bot_token": "..." },
    "slack": {
      "enabled": true,
      "bot_token": "xoxb-...",
      "app_token": "xapp-..."
    },
    "email": {
      "enabled": true,
      "imap_host": "imap.example.com",
      "smtp_host": "smtp.example.com",
      "username": "bot@example.com",
      "password": "app-password",
      "poll_interval": 30
    },
    "whatsapp": {
      "enabled": true,
      "bridge_url": "http://localhost:3001",
      "api_token": ""
    }
  }
}

Telegram and Discord default to pairing for unknown DMs and an allowlist for groups. When a new user messages the bot, it replies with a pairing code. Approve it at the > prompt in your terminal:

> pairing list telegram
> pairing approve telegram <code>

Every configured server's tools, resources, and prompts are exposed to the agents. Add them under mcpServers:

{
  "mcpServers": {
    "filesystem": {
      "enabled": true,
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/root"]
    }
  }
}