Neuron Telegram Gateway — Setup

The Telegram gateway lets you chat with your Neuron soul via Telegram. Plain messages go to the soul; commands give access to memory and status.

1. Create a bot via @BotFather

Open Telegram and search for @BotFather
Send /newbot
Pick a name (e.g. "Neuron")
Pick a username (must end in bot, e.g. myneuron_bot)
BotFather replies with your HTTP API token — looks like 7123456789:ABCdef...
Optionally set a description: /setdescription → select your bot → type a description

Never put the token in a plist, .env, or any file that might be committed.

security add-generic-password \
  -s neuron-telegram-bot \
  -a neuron \
  -w '<paste token here>'

Verify:

security find-generic-password -s neuron-telegram-bot -a neuron -w

launchctl load ~/Library/LaunchAgents/ai.neuron.telegram-gateway.plist

Check it started:

launchctl list | grep telegram
tail -f ~/.neuron/logs/telegram-gateway.out.log

Send your bot a message in Telegram. It should reply using your soul's voice.

Command	What it does
`<any text>`	Forwarded to the soul → responds in its voice
`/memory <query>`	Searches soul memories, returns top 3
`/remember <text>`	Stores text as a memory node
`/status`	Reports whether the soul is reachable

launchctl unload ~/Library/LaunchAgents/ai.neuron.telegram-gateway.plist

"token not found" — re-run step 2 above
"Soul is resting" — the soul daemon at http://localhost:7770 is not running; start it with launchctl load ~/Library/LaunchAgents/ai.neuron.engram.plist (or whichever plist runs the soul)
Logs: ~/.neuron/logs/telegram-gateway.out.log and telegram-gateway.err.log

Test gateway script directly:

TELEGRAM_BOT_TOKEN=<token> ~/Development/neuron-technologies/neuron/tools/telegram-gateway.sh

Endpoint	Purpose
`POST /api/chat`	Forward messages to the soul
`POST /api/neuron/recall`	Search memories
`POST /api/neuron/memory`	Store conversation as a memory node