DiscoClaw

A personal AI orchestrator that turns Discord into a persistent workspace — built on three pillars: Memory, Tasks, and Automations.

Turn Discord into a persistent AI workspace — memory, tasks, automations, and voice, all through natural conversation.

DiscoClaw coordinates between Discord, AI runtimes (Claude Code, OpenAI, Codex, Gemini, OpenRouter), and local system resources. The intelligence is rented; the coordination is owned. Designed for a single user on a private server — your own sandbox.

No gateways, no proxies, no web UI. Discord is the interface.

Memory — the bot knows you

• Durable facts — persist across sessions, channels, and restarts
• Rolling summaries — context carries forward, even across restarts
• Semantic search — vector + keyword search over past conversations, auto-retrieved
• Per-channel personality — markdown files shape behavior per channel
• YouTube transcripts — share a link, the bot reads the video

Tasks — the bot tracks your work

• Bidirectional sync — task store and Discord forum threads stay in sync
• Create from anywhere — chat, commands, or the forum directly
• Live status — thread names show status emoji at a glance
• Discord actions — the bot manages channels, messages, polls, and more through conversation

Automations — the bot acts on its own

• Plain-language schedules — "every weekday at 7am, check the weather"
• Forum-thread definitions — edit to change, archive to pause
• Full workspace access — files, web, browser automation, Discord actions

Voice — the bot talks back

Real-time voice with Gemini Live, barge-in, tool calls, and transcript mirroring. Off by default. Setup guide →

Self-management

Self-update from Discord (!update apply), health checks (!doctor), secret management (!secret), runtime model switching (!models), and restart (!restart) — no SSH needed.

Quick start

npm install -g discoclaw
discoclaw init
discoclaw install-daemon

You'll need a private Discord server and bot token and at least one AI runtime (configuration reference).

From source:

git clone https://github.com/DiscoClaw/discoclaw.git && cd discoclaw
pnpm install --frozen-lockfile
pnpm run setup
pnpm build && pnpm dev

See CONTRIBUTING.md for the full contributor setup including runtime validation.

Documentation

Getting started: Discord bot setup · Configuration · MCP

Features: Memory · Tasks · Crons · Voice · Discord actions · Plan & Forge · Browser automation · Recipes

Operations: Runtime switching · Dashboard · Webhook exposure · Data migration

Audits: Provider/auth matrix · Claude · Codex

Development: Philosophy · Releasing · Inventory

Platform support

Linux (systemd service included), macOS, Windows. Production daemon via systemd on Linux, or pm2/screen elsewhere.

Safety

Use a private Discord server, keep DISCORD_ALLOW_USER_IDS tight (fail-closed if empty), and use least-privilege Discord permissions. See SECURITY.md.

Built with

Claude Code, OpenAI Codex, discord.js, and Croner.

License

MIT. See DISCLAIMER.md for important usage terms.