Back to Blog
· MyAgentive Team · 5 min read

Getting Started with MyAgentive: Complete Setup Guide

Step-by-step guide to installing and configuring MyAgentive on macOS, Linux, or Windows WSL. Set up your Telegram bot and web interface in under 10 minutes.

guide installation tutorial

This guide walks you through installing MyAgentive and getting your personal AI agent running. The entire process takes about 10 minutes.

Prerequisites

Before you start, you will need:

  1. A computer running macOS, Linux, or Windows with WSL
  2. One of these for Claude AI access:
  3. A Telegram account for mobile access

Step 1: Install MyAgentive

Open your terminal and run:

curl -fsSL https://myagentive.ai/install | bash

This downloads and installs the latest version of MyAgentive. The installer handles all dependencies automatically.

Windows Users

First install WSL (Windows Subsystem for Linux) if you have not already:

wsl --install

Restart your computer, then open the WSL terminal and run the install command above.

Step 2: Run the Setup Wizard

After installation, start MyAgentive:

myagentive

The setup wizard guides you through the configuration.

Choose Your Claude Authentication

Option A: Claude Code (Recommended)

If you have a Claude Pro or Team subscription, this is the best option. No additional API costs.

  1. Install Claude Code if you have not already:
    curl -fsSL https://claude.ai/install.sh | bash
  2. Login to your Claude account:
    claude login
  3. Select “Claude Code” when the wizard asks about authentication

Option B: Anthropic API Key

If you prefer pay-per-use:

  1. Go to console.anthropic.com/settings/keys
  2. Create a new API key
  3. Enter the key when prompted

Step 3: Create Your Telegram Bot

Your agent needs a Telegram bot to communicate with you on mobile.

  1. Open Telegram and search for @BotFather
  2. Send /newbot
  3. Choose a display name (e.g., “My Agent”)
  4. Choose a username ending in bot (e.g., my_agent_bot)
  5. Copy the token that BotFather gives you

The token looks like: 7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxx

Enter this token when the wizard asks.

Step 4: Get Your Telegram User ID

For security, your bot only responds to your Telegram account.

  1. Open Telegram and search for @userinfobot or @getidsbot
  2. Send /start to the bot
  3. Copy the numeric ID it returns (e.g., 507299000)

Important: This must be your numeric ID, not your @username.

Step 5: Set Your Web Password

Choose a password for accessing the web interface. This protects your agent when you access it through the browser.

Running Your Agent

After setup completes, your agent starts automatically with:

Run in Background

For always-on operation:

# Start as background service
myagentivectl start

# Stop the service
myagentivectl stop

# View logs
myagentivectl logs

# Check status
myagentivectl status

Telegram Commands

Once running, you can use these commands in Telegram:

CommandDescription
/startWelcome message
/helpShow all commands
/session <name>Switch to named session
/new [name]Create new session
/listList all sessions
/statusCurrent session info
/modelShow current AI model
/model opusSwitch to Opus (most capable)
/model sonnetSwitch to Sonnet (balanced)
/model haikuSwitch to Haiku (fastest)

Send any message to chat with your agent. Voice messages, files, photos, and videos are all supported.

Web Interface Features

The web interface at http://localhost:3847 provides:

  • Full conversation history
  • Multi-session management
  • File attachments
  • Real-time streaming responses
  • Dark and light themes

Sessions sync between web and Telegram, so you can switch devices seamlessly.

Configuration Files

Your configuration and data are stored in ~/.myagentive/:

PathContents
~/.myagentive/configSettings and API keys
~/.myagentive/data/myagentive.dbChat history and sessions
~/.myagentive/media/Uploaded files

Updating MyAgentive

To update to the latest version:

curl -fsSL https://myagentive.ai/install | bash

Your config and data are preserved during updates.

Troubleshooting

”Claude Code not found”

Install and login to Claude Code:

curl -fsSL https://claude.ai/install.sh | bash
claude login

“Bot token invalid”

  • Check for extra spaces when pasting the token
  • Get a new token from @BotFather if needed

”Telegram user not authorised”

Reset your Telegram configuration:

myagentive config --reset-telegram

Start Fresh

To reset everything and run the setup wizard again:

rm -rf ~/.myagentive
myagentive

Next Steps

Your agent is ready. Here are some things to try:

  1. Ask a question: “What is the weather in Sydney?”
  2. Execute a command: “List files in my home directory”
  3. Create content: “Write a short blog post about AI agents”
  4. Research: “Find the latest news about artificial intelligence”

For advanced features like AI phone calls, social media posting, and document processing, check out the Power User Configuration in the GitHub repository.


Questions? Join our Telegram channel or open an issue on GitHub.