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"
Power your agent
Lệnh của chính nhà phát hành. Không phải endpoint của PlugMCP.
Host a copy with our keys and logs.
npx -y @furlow/[email protected]Claude Code không có liên kết cài đặt cho lệnh cục bộ. Sao chép lệnh bên dưới và chạy trong terminal.
claude mcp add io.github.virgilvox-furlow-mcp -- npx -y @furlow/mcp@1.0.1Chạy trong terminal.
{ "mcpServers": { "io.github.virgilvox-furlow-mcp": { "command": "npx", "args": [ "-y", "@furlow/[email protected]" ] } }}claude_desktop_config.json
URL từ xa hay một lệnh trên máy của bạn? Hai cách cài đặt khác nhau thế nào
Chạy trên 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.
MởTừ nhà phát hành
# 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]" ] } }}Công cụ
Chưa có danh sách công cụ. Máy chủ từ xa sẽ có danh sách sau lần kiểm tra tình trạng đầu tiên.
Câu hỏi thường gặp
Sao chép cấu hình stdio cho Cursor, Claude Desktop, Claude Code hoặc VS Code trên trang này. Cấu hình dùng bản cài đặt của nhà phát hành, không phải proxy của PlugMCP.
Bản ghi này không liệt kê biến môi trường bắt buộc nào.
Furlow chạy cục bộ qua stdio.
Kiểm tra lần cuối: 2026-11-10. Author FURLOW Discord bot YAML: validate specs, list actions/events/builtins, scaffold bots.