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"
Potencialize seu agente
O comando do próprio publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
npx -y @furlow/[email protected]O Claude Code não tem link de instalação para um comando local. Copie o comando abaixo e execute-o em um terminal.
claude mcp add io.github.virgilvox-furlow-mcp -- npx -y @furlow/mcp@1.0.1Execute em um terminal.
{ "mcpServers": { "io.github.virgilvox-furlow-mcp": { "command": "npx", "args": [ "-y", "@furlow/[email protected]" ] } }}claude_desktop_config.json
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no 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.
AbrirDo 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]" ] } }}Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Furlow roda localmente via stdio.
Última verificação: 2026-11-10. Author FURLOW Discord bot YAML: validate specs, list actions/events/builtins, scaffold bots.