Skip to main content
ZoarkAIZoarkAI

Getting Started with ZoarkBot

Follow these steps one by one. Each step takes about 1 minute. Total time: 5 minutes.

Before you start — 2 things you need

A Telegram account
ZoarkBot talks to you through Telegram. It's free. Download Telegram here if you don't have it.
Your ZoarkBot license key
It was in your purchase confirmation email. It looks like: ZOARKBOT-XXXX-XXXX-XXXX-XXXX — you can also find it on your account page.
1
Create your Telegram Bot

ZoarkBot needs a Telegram bot to send you messages. Think of it like a phone number just for your agent. Here is exactly how to get one:

  1. 1. Open Telegram on your phone or computer.
  2. 2. In the search bar, type @BotFather and tap on it. It has a blue verified checkmark next to its name.
  3. 3. Press the Start button, or send the message /start
  4. 4. Send this message: /newbot
  5. 5. BotFather asks: "How are we going to call it?" — type any name you like, for example: My ZoarkBot
  6. 6. BotFather asks: "Choose a username" — it must end in the word "bot", for example: myzorkaibot
  7. 7. BotFather sends you a message containing your token. It looks like this:
    7123456789:AAEBxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  8. 8. Copy that token. You will paste it in Step 3.
Keep your token private

Your Telegram token is like a password. Do not share it with anyone. Anyone who has it can control your bot.

2
Install ZoarkBot on your computer

First, pick your operating system:

How to open a terminal (a window where you type commands):

Press Ctrl + Alt + T on your keyboard, OR search for "Terminal" in your apps menu.

Once the terminal is open, paste this command and press Enter:

curl -sSL https://get.zoarkai.org/install-linux.sh | bash

You will see a lot of text scrolling on the screen — that is normal. Just wait. When it stops and shows a "Done" message, the installation is complete.

3
Run first-time setup

In the same terminal window, type this and press Enter:

zoarkbot setup

The setup will ask you two questions:

Question 1: "Enter your license key"
Paste your license key from your purchase email. It looks like ZOARKBOT-XXXX-XXXX-XXXX-XXXX
Question 2: "Enter your Telegram Bot Token"
Paste the token you copied from @BotFather in Step 1. It looks like 7123456789:AAEBxxx...

When setup is done, it will say: "Setup complete! Run zoarkbot start to launch."

4
Start ZoarkBot

Type this and press Enter:

zoarkbot start

ZoarkBot will start and print something like this in the terminal:

ZoarkBot is running! Mission Control: https://mc.zoarkai.org Access Token: abc123xyz456def789...
Important: Copy your Access Token NOW

See the line that says Access Token? Copy that long string of letters and numbers.

You will need it in the next step to log into your dashboard.

If you close this terminal without saving it, run zoarkbot token to show it again.

5
Open your Mission Control dashboard

Go to this website:

mc.zoarkai.org

It will ask you for your Access Token.

Paste the token you copied from the terminal in Step 4 and press Enter.

You're in!

You can now see all your agents, their tasks, and everything they are doing — all in one place.

6
Send your first message to Zero

Open Telegram and search for the bot you created in Step 1 (the one you named).

Send it a message — try saying: hello

Your agent Zero will reply. That means everything is working!

Stuck? Email us at [email protected] — we reply within 24 hours.