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"
接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y @furlow/[email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
claude mcp add io.github.virgilvox-furlow-mcp -- npx -y @furlow/mcp@1.0.1在終端機中執行。
{ "mcpServers": { "io.github.virgilvox-furlow-mcp": { "command": "npx", "args": [ "-y", "@furlow/[email protected]" ] } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
# 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]" ] } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Furlow 透過 stdio 在本機執行。
上次檢查時間:2026-11-10。 Author FURLOW Discord bot YAML: validate specs, list actions/events/builtins, scaffold bots.