JSPM

  • Created
  • Published
  • Downloads 537
  • Score
    100M100P100Q98336F
  • License MIT

Personal AI orchestrator that turns Discord into a persistent workspace

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

    DiscoClaw

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

    npm version license node

    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-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.