FURLOW
Declarative Discord Bot Framework
Build powerful Discord bots with YAML. No code required.
commands:
- name: ping
description: Check bot latency
actions:
- reply:
content: "Pong! ${client.ws.ping}ms"
Potencia tu agente
El comando propio del publicador. No es un endpoint de PlugMCP.
Host a copy with our keys and logs.
npx -y @furlow/[email protected]Claude Code no tiene enlace de instalación para un comando local. Copia el comando de abajo y ejecútalo en una terminal.
claude mcp add io.github.virgilvox-furlow-mcp -- npx -y @furlow/mcp@1.0.1Ejecútalo en una terminal.
{ "mcpServers": { "io.github.virgilvox-furlow-mcp": { "command": "npx", "args": [ "-y", "@furlow/[email protected]" ] } }}claude_desktop_config.json
¿URL remota o un comando en tu máquina? En qué se diferencian las dos instalaciones
Ejecutar en PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDel publicador
# Install the CLI
npm install -g @furlow/cli
# Create a bot
furlow init my-bot
cd my-bot
# Add your Discord credentials to .env
echo "DISCORD_TOKEN=your_token_here" > .env
echo "DISCORD_CLIENT_ID=your_client_id_here" >> .env
# Start
furlow start
version: "0.1"
identity:
name: "My Bot"
presence:
status: online
activity:
type: playing
text: "with FURLOW"
commands:
- name: hello
description: Greet someone
options:
- name: user
type: user
description: Who to greet
actions:
- reply:
content: "Hello, ${options.user.display_name || options.user.username}!"
- name: roll
description: Roll a dice
options:
- name: sides
type: integer
description: Number of sides
min_value: 2
max_value: 100
actions:
- reply:
content: "🎲 You rolled **${random(1, options.sides || 6)}**"
events:
- event: member_join
actions:
- send_message:
channel: "${env.WELCOME_CHANNEL}"
content: "Welcome ${member.displayName}!"
A short checklist for shipping a bot to production. Each item lines up with a runtime guarantee — skipping one usually shows up later as silent data loss, an unscheduled feature, or a publicly forgeable session.
# Discord
DISCORD_TOKEN=...
DISCORD_CLIENT_ID=...
# Storage (pick one)
DATABASE_URL=postgres://user:pass@host:5432/furlow # production
# or for single-server bots:
SQLITE_PATH=/var/lib/furlow/bot.db
# Dashboard (only if running the web UI)
DASHBOARD_SECRET=$(openssl rand -hex 32) # required in NODE_ENV=production
DISCORD_CLIENT_SECRET=...
DISCORD_CALLBACK_URL=https://dashboard.example.com/auth/discord/callback
The dashboard refuses to start in NODE_ENV=production without
DASHBOARD_SECRET — there is no fallback default. WebSocket connections
also require an authenticated session; unauthenticated clients are rejected
at upgrade time and cannot subscribe to guild streams.
state.tables: block.CronScheduler that emits scheduler_tick every 60s.
Builtins that rely on it (giveaways, polls, reminders) need the
scheduler running — there is no separate cron process.@discordjs/voice peer plus ffmpeg on the
PATH. The voice_track_start / voice_track_end events used by the
music builtin only fire when the voice manager is initialized.furlow start under a process supervisor (systemd, pm2,
Kubernetes Deployment) that restarts on exit. The bot does not
self-daemonize.SIGTERM so the gateway connection closes cleanly. The CLI
flushes pending state on shutdown; killing with SIGKILL can lose the
last batched writes.secure: true in production and will not be
delivered over plain HTTP.DISCORD_CALLBACK_URL you ship.apps/dashboard/server/routes/api.ts./health returns process uptime; wire it to your liveness probe./metrics exposes Prometheus-format counters. Add a scrape job pointed
at the dashboard process.--verbose for structured per-event logging during
incident triage.MIT
Author FURLOW Discord bot YAML: validate specs, list actions/events/builtins, scaffold bots.
{ "mcpServers": { "io.github.virgilvox-furlow-mcp": { "command": "npx", "args": [ "-y", "@furlow/[email protected]" ] } }}Herramientas
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
Este registro no indica ninguna variable de entorno obligatoria.
Furlow se ejecuta localmente por stdio.
Última comprobación: 2026-11-10. Author FURLOW Discord bot YAML: validate specs, list actions/events/builtins, scaffold bots.