A Discord bot that automatically joins voice channels and transcribes meetings when specific users are present together. Integrates with OpenClaw for post-meeting actions.

Features

Auto-joins VC when configured users are together
Per-speaker transcription using onnx-asr (hyprwhspr backend)
Timestamped transcript saved to JSON
Prompts via OpenClaw for post-meeting actions
Self-contained - easy to share and deploy

Requirements

Node.js 18+ or Bun
ffmpeg (for audio conversion)
hyprwhspr with onnx-asr backend (for transcription)
A Discord bot token

Setup

Clone and install dependencies:

git clone https://git.nicholai.work/Nicholai/openclaw-meeting-notes.git
cd openclaw-meeting-notes
bun install

Copy the example env and configure:

cp .env.example .env

Edit .env:

discordToken=YOUR_BOT_TOKEN
targetUsers=USER_ID_1,USER_ID_2
transcriptsDir=~/.agents/meeting-transcripts
openclawGatewayUrl=http://localhost:3850
guildId=YOUR_GUILD_ID

Build and run:

bun run build
bun run start

Configuration

Env Var	Description
`discordToken`	Discord bot token
`targetUsers`	Comma-separated user IDs to watch for
`transcriptsDir`	Where to save meeting transcripts
`openclawGatewayUrl`	OpenClaw gateway URL for prompts
`guildId`	Discord guild ID to monitor

Bot Permissions

The bot needs these permissions in your server:

View Channels
Connect (to voice channels)
Speak (muted, but needed to join)

How It Works

Bot monitors voice channels for target users
When all target users are in the same VC, bot joins (muted)
Captures audio streams per speaker
Converts PCM → WAV → text via onnx-asr
When users leave, saves transcript JSON
Prompts via OpenClaw for follow-up actions

Output Format

Transcripts are saved as JSON:

{
  "channel": "General",
  "startTime": "2026-02-27T00:00:00.000Z",
  "endTime": "2026-02-27T00:30:00.000Z",
  "duration": "30m 0s",
  "participants": {
    "123456789": "username1",
    "987654321": "username2"
  },
  "transcript": [
    {
      "speakerId": "123456789",
      "speakerName": "username1",
      "timestamp": 1708992000000,
      "text": "Hey, let's talk about the project..."
    }
  ]
}

Systemd Service

To run as a background service:

cp meeting-notes.service ~/.config/systemd/user/
systemctl --user enable --now meeting-notes

License

MIT