Error Code Lookup

Paste your error log below. We'll tell you exactly how to fix it.

imsg rpc not ready / exited with code 1

StartupRPC
imsg rpc exited with code 1
Cause

Node.js version mismatch or port 3000/8080 collision.

Quick Fix

Kill existing Node processes or use the Docker image.

Gateway Security Error

ConfigSecurity
Refusing to bind to 0.0.0.0 without auth token
Cause

You are trying to expose the bot remotely without a password.

Quick Fix

Add `gateway.auth.token` to your config or bind to `127.0.0.1`.

Telegram Command Error

Telegram
BOT_COMMAND_INVALID
Cause

BotFather commands are not configured.

Quick Fix

Run `/setcommands` in BotFather.

Gemini 2.0 Flash / Pro No Response

ModelGemini
Gemini outputs fake tool call text
Cause

Model hallucinates tool calls instead of executing them.

Quick Fix

Switch to `gemini-1.5-pro` or use OpenRouter wrapper.

Windows Defender Block

WindowsInstall
Windows Defender SmartScreen blocked
Cause

Unsigned binary or false positive.

Quick Fix

Click 'More Info' -> 'Run Anyway' or use PowerShell install.

Docker Permission Denied

DockerLinux
permission denied while trying to connect to the Docker daemon
Cause

User not in docker group.

Quick Fix

sudo usermod -aG docker $USER && newgrp docker