Setup

Requires a VPS (Ubuntu 24.04+, 1 GB RAM, IPv6 optional). We recommend Kamatera - $4/month with a free 30-day trial ($100 credits). You'll need a separate Session account for your AI agent, plus your own Session ID.

Tested on Ubuntu. Debian may work but is untested.

One command as root - installs everything and runs 24/7:

# curl -sL https://sessionaiagent.com/setup.sh | bash
After setup, the bot's Session ID is printed. Paste it into Session to send a message request. Only your Session ID can message the bot.
Re-run the script anytime to change model or uninstall.

OpenCode

Session AI Agent runs on OpenCode Go - a subscription for coding models including DeepSeek, GLM, Kimi, Qwen, and more. Use this link for your first month at $5 (then $10/month).

The script fetches available models live during setup. You pick by number. Default: opencode-go/deepseek-v4-pro.

Agent Engines

Choose between two AI engines during setup:

After Setup

To change models, re-run the setup script or edit .env directly:

$ cd /root/session-claw-bridge && nano .env
$ systemctl restart claw-bridge

Your .env:

SESSION_MNEMONIC="your 13 words"
OWNER_SESSION_ID=05abc...
OPENCODE_API_KEY=...
MODEL=opencode-go/deepseek-v4-pro