q qozyai

Getting started

qozyai turns Telegram into the primary interface for your personal AI agent. You get a private instance, your own Telegram bot, and you bring your own LLM — Claude Code or ChatGPT Codex. This guide walks the full onboarding in six steps.

Before you start
  • →A working email address
  • →A Telegram account (mobile or desktop)
  • →An OpenAI account with Codex device-flow enabled, or an Anthropic account with Claude Code access
  • →OptionalAn invite code for a priority slot (e.g. handed out at a demo day)
01

Get your key from the website

  1. Open qozyai.com.
  2. Fill in Email.
  3. If you have an invite code, enter it in Invite code (optional). For public slots, leave it blank.
  4. Complete the Cloudflare check ("I'm not a robot").
  5. Click Send me a key.

The page confirms with "We'll email you shortly" — the email usually arrives within a minute or two.

02

Activate your instance

  1. Open the email from qozyai, subject "Your qozyai instance is ready".
  2. Click Open qozyai, or copy the backup URL — it looks like https://<word>-<word>.qozyai.com/auth/… (in the demo: sunroom-beige.qozyai.com).
  3. On the Connect your agent page, click Connect Telegram.
Link expires in 30 minutes. If it does, repeat step 1.
03

Connect your Telegram bot

  1. Telegram opens with an invitation to start your personal bot. Each user gets a unique name in the form QozyAI <Word> <Word> (demo: QozyAI Sunroom Beige).
  2. The bot greets you:
QozyAI <…> is ready! Tap Start below to test your new chatbot. Its behavior is defined by qozyai.
  1. Tap Start or send /start.
  2. The bot confirms:
Your QozyAI agent bot is connected. Send /start or any message here to begin.
04

Pick a driver

The bot explains BYOI and asks you to pick a driver. The driver is the "brain" of your agent — without an active provider account it can't think or act.

Claude Code
/driver claude
Anthropic account required
Codex
/driver codex
OpenAI account with device-flow enabled

Tap the buttons the bot shows, or send the command yourself.

05

Authenticate with your provider

Codex example. The bot sends a message containing:

  • A device URL: https://auth.openai.com/codex/device
  • A 9-character code, e.g. RQAE-CDZIZ
  • A help link if Codex isn't enabled on your account: qozyai.com/docs/enable-codex/
  1. Open the URL in any browser.
  2. On the Codex CLI page, type the code one character at a time (the dash can be skipped).
  3. Sign in to your OpenAI account. Acknowledge the security warning — it's normal and only matters if you didn't initiate the sign-in yourself.
  4. Return to Telegram and send the bot Done (any message works).
Verifying the Codex login…

Codex is authenticated. Please resend your previous message.
Browser flow expires in 15 minutes. If it does, ask the bot for a fresh code.

Claude Code uses the same flow on Anthropic's auth page — the bot supplies the link.

06

Start chatting

  1. Send the bot any message — e.g. "Hi".
  2. The bot shows "New conversation started." and the agent opens the dialog:
Hey, I just came online. Who should I call you? And what should we call me?

From here, talk to the agent like any Telegram contact. Reasoning and actions run on your model; qozyai orchestrates the rest.

·

Quick tips

  • Switch driversSend /driver claude or /driver codex again at any time.
  • Link lifetimesOnboarding email: 30 minutes. Browser device-flow: 15 minutes.
  • SecurityYou only type your password on the provider's page. qozyai never sees or stores it.
  • Instance privacyEvery instance is personal — don't forward your email link to anyone else.
  • No email?Check spam and confirm the address was typed correctly.
Ready when you are. Send me a key — onboarding takes about three minutes.
Get started →