Package Exports
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (discoclaw) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
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 STT (Deepgram), TTS (Cartesia), barge-in, 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-daemonYou'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 devSee 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.