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.
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:
- A computer running macOS, Linux, or Windows with WSL
- One of these for Claude AI access:
- Claude Pro or Team subscription with Claude Code installed (recommended, free usage)
- Anthropic API key from console.anthropic.com (pay-per-use)
- 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.
- Install Claude Code if you have not already:
curl -fsSL https://claude.ai/install.sh | bash - Login to your Claude account:
claude login - Select “Claude Code” when the wizard asks about authentication
Option B: Anthropic API Key
If you prefer pay-per-use:
- Go to console.anthropic.com/settings/keys
- Create a new API key
- Enter the key when prompted
Step 3: Create Your Telegram Bot
Your agent needs a Telegram bot to communicate with you on mobile.
- Open Telegram and search for @BotFather
- Send
/newbot - Choose a display name (e.g., “My Agent”)
- Choose a username ending in
bot(e.g.,my_agent_bot) - 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.
- Open Telegram and search for @userinfobot or @getidsbot
- Send
/startto the bot - 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:
- Telegram bot: Message your bot from anywhere
- Web UI: Access at http://localhost:3847
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:
| Command | Description |
|---|---|
/start | Welcome message |
/help | Show all commands |
/session <name> | Switch to named session |
/new [name] | Create new session |
/list | List all sessions |
/status | Current session info |
/model | Show current AI model |
/model opus | Switch to Opus (most capable) |
/model sonnet | Switch to Sonnet (balanced) |
/model haiku | Switch 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/:
| Path | Contents |
|---|---|
~/.myagentive/config | Settings and API keys |
~/.myagentive/data/myagentive.db | Chat 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:
- Ask a question: “What is the weather in Sydney?”
- Execute a command: “List files in my home directory”
- Create content: “Write a short blog post about AI agents”
- 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.