ClawSwarm

ClawSwarm is a multi-agent personal productivity operating system powered by hundreds of agents designed to enhance your productivity.

---

Requirements

• Python 3.10+
• Dependencies listed in requirements.txt (no version pins; use a venv and pin locally if needed)
• Swarms framework and Swarms ecosystem; Claude Code (for the Claude tool)
• Platform credentials for the channels you enable: Telegram Bot Token, Discord Bot Token and Channel IDs, and/or WhatsApp Cloud API credentials

---

Installation

pip3 install -U claw-swarm

---

Environment variables

Set these in your shell or in a .env file (e.g. --env-file .env with Docker). Omit a platform’s credentials to disable that channel.

Variable	Purpose	Default
Gateway
GATEWAY_HOST	Bind address (gateway) or gateway host (agent)	[::] (server), localhost (agent)
GATEWAY_PORT	gRPC port	50051
GATEWAY_TLS	Enable TLS: 1, true, or yes	-
GATEWAY_TLS_CERT_FILE	Path to TLS certificate file	-
GATEWAY_TLS_KEY_FILE	Path to TLS private key file	-
Channels
TELEGRAM_BOT_TOKEN	Telegram Bot API token	-
DISCORD_BOT_TOKEN	Discord bot token	-
DISCORD_CHANNEL_IDS	Comma-separated Discord channel IDs	-
WHATSAPP_ACCESS_TOKEN	WhatsApp Cloud API access token	-
WHATSAPP_PHONE_NUMBER_ID	WhatsApp Cloud API phone number ID	-
WHATSAPP_QUEUE_PATH	Optional WhatsApp queue path	-
Agent
AGENT_MODEL	Swarms director / default agent model	gpt-4o-mini
WORKER_MODEL_NAME	Worker agents model (Response/Search/TokenLaunch/Developer). If set, overrides AGENT_MODEL for workers.	- (falls back to AGENT_MODEL then gpt-4o-mini)
OPENAI_API_KEY	OpenAI API key (for agent model)	-
ANTHROPIC_API_KEY	Anthropic API key (for Claude tool)	-
Memory
AGENT_MEMORY_FILE	Agent memory markdown filename (project root)	agent_memory.md
AGENT_MEMORY_MAX_CHARS	Max characters of memory to load into context	100000

---

Quick Start

1. Install:

pip install -U claw-swarm

2. Create your config - run the interactive wizard to generate claw_config.yaml:

clawswarm onboarding

Press Enter to accept defaults. This writes claw_config.yaml to your project root with gateway host/port/TLS, HTTP API port/key, agent name, worker model, and verbose mode.

3. Set secrets - copy .env.example to .env and fill in your credentials:

cp .env.example .env
# then edit .env with your tokens and API keys

4. Run the full stack:

clawswarm run          # gateway + agent (messaging platforms only)
clawswarm run --api    # + public REST API on the configured port

---

Overview