Documentation
Learn how to use the Flaxu platform step by step. Everything from account creation to advanced configuration is here.
Getting Started
Account creation and first steps
With Flaxu, you can run your AI assistants across all communication channels in minutes. Follow the steps below to get started.
Create an Account
Create your account with your email address and password from the registration page. You can also sign in with Google or GitHub.
Choose a Plan
Choose the plan that fits your needs:
All AI models, all channels, 3 channel limit. Connect your own API keys.
Everything in Starter + Claude Max included, no API key needed. 5 channels, zero setup.
Create Your First Channel
Click the "New Channel" button from the Dashboard to create your first AI assistants as WhatsApp, Telegram, Discord, Slack, or Web Widget.
Choose Your AI Model and Get Started
Select one of the AI models such as Claude, GPT-5, or Gemini Pro. Your channel will be instantly active and start receiving messages.
AI Agents
34 specialist agents across 10 categories
Flaxu includes 34 specialist AI agents that work together under one General Manager agent. You don't need to select or configure agents — they all collaborate automatically to handle any request.
All Agents by Category
general
General Assistant
A helpful all-purpose AI assistant with access to all tools. Default agent for all channels.
Research Agent
Specialized in finding and synthesizing information from the web, Wikipedia, and other sources.
Multilingual Assistant
Communicates in any language, translates, and provides cultural context. Auto-detects user language.
development
Coding Agent
Expert software developer that writes, explains, runs, and debugs code in 50+ languages.
Frontend Developer
Specializes in React, Next.js, Vue, CSS, and responsive/accessible web UI development.
GitHub Agent
Manages your GitHub repositories: create repos, push code, manage branches, and create PRs.
DevOps Engineer
Helps with Docker, CI/CD, cloud infrastructure, deployment scripts, and server monitoring.
Server Admin
Manages remote servers via SSH: run commands, configure services, monitor resources, deploy applications, manage Docker containers.
marketing
Marketing Strategist
Full-stack digital marketing: SEO, copywriting, email campaigns, social media strategy, and analytics.
SEO Specialist
Technical and content SEO: keyword research, on-page optimization, schema markup, and site audits.
Social Media Manager
Creates engaging social media content for Twitter/X, LinkedIn, Instagram, TikTok, and more.
Email Marketing Expert
Designs email sequences, newsletters, subject lines, and automated email flows that convert.
data
Data Analyst
Analyzes data, runs calculations, creates insights, and accesses World Bank open data.
Finance Analyst
Stock market analysis, forex rates, mortgage calculators, investment comparisons, and financial planning.
Crypto Tracker
Real-time cryptocurrency prices, market analysis, portfolio tracking, and crypto news.
Trading Assistant
Technical analysis concepts, trading strategies, risk management, and market research for traders.
productivity
Translator
Professional multilingual translator supporting 100+ languages with cultural context.
Productivity Assistant
Scheduling, time zones, password generation, QR codes, URL shortening, and daily tasks.
Project Manager
Agile/Scrum project management, sprint planning, task breakdowns, standups, and retrospectives.
creative
Creative Writer
Stories, blog posts, scripts, poetry, and all forms of creative writing.
Image Creator
Creates and generates images using DALL-E 3. Describe what you want and get stunning visuals.
Content Creator
Video scripts, podcast outlines, YouTube descriptions, and multimedia content planning.
education
Tutor
Patient, adaptive teaching assistant for any subject. Explains concepts, generates quizzes, and tracks progress.
Language Teacher
Interactive language learning with vocabulary, grammar, exercises, and conversation practice.
Quiz Master
Creates and runs interactive quizzes, trivia games, and knowledge challenges on any topic.
business
Startup Advisor
Business strategy, pitch decks, financial modeling, go-to-market planning, and startup advice.
Legal Advisor
Privacy policies, terms of service, GDPR/CCPA compliance, and contract review assistance.
E-Commerce Expert
Product descriptions, pricing strategy, conversion optimization, and e-commerce growth tactics.
lifestyle
Fitness Coach
Workout plans, exercise guides, nutrition info, and health & wellness tracking.
Travel Planner
Trip itineraries, destination guides, weather forecasts, currency conversion, and travel tips.
Chef & Recipe Creator
Recipe creation, meal planning, nutrition analysis, and cooking guidance for all skill levels.
support
Customer Support
Professional customer service: FAQ handling, issue resolution, and support ticket management.
HR Assistant
Job descriptions, interview questions, resume screening criteria, and HR process templates.
Security Advisor
Web application security best practices, OWASP guidance, password auditing, and security checklists.
Tools & Skills
75 built-in tools, ready to use
Every channel has access to 75 powerful tools. Most work out of the box with no setup needed. Only a few optional tools require your own API keys.
Built-in Tools (No API Key Needed)
Optional (Your API Key)
Channel Setup
Step-by-step setup guide for each channel
Run your AI assistants on WhatsApp through the WhatsApp Business API.
WhatsApp Business API Account
Create a WhatsApp Business API account through Meta Business Suite. A verified phone number is required.
Create Channel in Flaxu
Dashboard > Channels > New Channel > Select WhatsApp. Set the channel name and AI model.
Webhook Configuration
Add the Flaxu webhook URL in your WhatsApp Business API settings:
https://flaxu.network/api/webhooks/whatsapp/{CHANNEL_ID}
Verify Token: Obtained from Flaxu dashboardTelegram
Easy SetupRun your AI assistants on Telegram using the Telegram Bot API. One of the easiest setup options.
Create a Telegram Bot
Go to @BotFather on Telegram and create a new bot with the /newbot command. Copy the bot token.
Connect to Flaxu
When creating a new Telegram channel in the Dashboard, paste the bot token into the configuration field.
{
"botToken": "7123456789:AAH...",
"botUsername": "my_flaxu_bot",
"allowGroups": true
}Authorized Users
All ChannelsYou can restrict who can use your bot by adding an authorized users whitelist when creating a channel. If the list is empty, anyone can use the bot (default behavior).
Telegram
Username (without @) or chat ID
Discord
User ID or username
Phone number with country code
Slack
Slack user ID (e.g., U01ABCDEF)
Discord
Create your Discord bot and run an AI assistant in your server channels.
Create a Discord Application
Create a new application from the Discord Developer Portal. Get the bot token from the Bot tab.
Add Bot to Server
Invite the bot to your server using the OAuth2 URL Generator. Required permissions: Send Messages, Read Message History, Embed Links.
Configure in Flaxu
Create a Discord channel in the Dashboard and enter the bot token and server details.
{
"botToken": "MTIz...",
"guildId": "1234567890",
"channelIds": ["9876543210"],
"prefix": "!"
}Slack
Run your AI assistants in channels within your Slack workspace.
Create a Slack App
Create a new application from the Slack API platform. Bot Token Scopes: chat:write, channels:history, app_mentions:read
Event Subscriptions
Enable Event Subscriptions in your Slack app and add the Flaxu webhook URL.
{
"botToken": "xoxb-...",
"signingSecret": "abc123...",
"channelIds": ["C01ABCDEF"]
}Web Widget
EasiestAdd a chat widget to your website. Setup is complete with a single line of code.
Create a Widget Channel
Create a Web Widget channel from the Dashboard and select your AI model.
Add the Embed Code
Add the following code just before the </body> tag on your website:
<!-- Flaxu AI Chat Widget -->
<script
src="https://flaxu.network/widget.js"
data-channel-id="YOUR_CHANNEL_ID"
data-theme="dark"
data-position="bottom-right"
async
></script>AI Models
Available models and their features
Flaxu supports multiple models from leading AI providers. You can select a different model for each channel.
Anthropic Claude
The most powerful Claude model. Ideal for complex analysis, long-form content generation, and advanced reasoning. 200K token context window.
Perfect balance between performance and speed. The recommended model for general-purpose use. 200K token context window.
The fastest Claude model. Optimized for simple tasks and high-volume processing. 200K token context window.
OpenAI
OpenAI's latest flagship model with superior reasoning and coding capabilities. 128K token context window.
Versatile multimodal model. Can process text, images, and audio. 128K token context window.
The lightweight and affordable version of GPT-4o. Ideal for fast responses and everyday tasks. 128K token context window.
Google's most powerful AI model with advanced reasoning. 1M token context window.
Ultra-fast with strong reasoning. Optimized for speed and cost-efficiency. 1M token context window.
API Keys & Tokens
Connecting your AI provider accounts
You can connect your AI providers using API keys or OAuth tokens. On the Starter plan, you need your own credentials for all providers. On the Pro plan, Claude is included — you only need your own keys for OpenAI and Google.
Connection Methods
Claude (Anthropic)
Recommended: Run claude setup-token in your terminal and paste the token in Settings. This uses your Claude subscription (Pro/Max).
Alternative: API key from console.anthropic.com (pay-per-token).
OpenAI (GPT)
API key from platform.openai.com > API Keys. OpenAI only supports API key authentication.
Google (Gemini)
If you logged in with Google: Gemini access may be available automatically through your Google account.
Alternative: API key from aistudio.google.com.
Adding a Key or Token
Get Your Credentials
Use one of the connection methods above to get your API key or token for each provider.
Add to Settings
Dashboard > Settings > API Keys. Select the provider, paste your key or token, and save. All credentials are encrypted at rest with AES-256-GCM.
POST /api/openclaw/setup
Content-Type: application/json
Authorization: Bearer {SESSION_TOKEN}
{
"channelType": "TELEGRAM",
"channelName": "Customer Support Bot",
"model": "CLAUDE_SONNET",
"apiKey": "sk-ant-...",
"config": {
"botToken": "7123456789:AAH..."
}
}Key Requirements by Plan
| Model | Starter ($9/mo) | Pro ($29/mo) |
|---|---|---|
| Claude Opus / Sonnet / Haiku | Own key | Included |
| GPT-5.2 / GPT-4o / GPT-4o Mini | Own key | Own key |
| Gemini 3 Pro / Flash | Own key | Own key |
Automatic Provider Fallback
Seamless switching between AI providers
When your selected AI provider hits a rate limit or becomes temporarily unavailable, the system automatically tries an equivalent model from another provider you have configured. This ensures uninterrupted service without any manual intervention.
How It Works
Your selected provider (e.g., Claude) receives the request
If it fails (rate limit, quota), the system detects the error
Automatically retries with an equivalent model from another provider
Model Tier Mapping
Each model is matched with equivalent models from other providers:
| Tier | Claude | OpenAI | |
|---|---|---|---|
| High | Claude Opus | GPT-5.2 | Gemini 3 Pro |
| Mid | Claude Sonnet | GPT-4o | Gemini 3 Flash |
| Low | Claude Haiku | GPT-4o Mini | Gemini Pro |
Configuration
Go to Settings > Automatic Provider Fallback to:
- Enable or disable automatic fallback
- Set the provider priority order (drag to reorder)
Multi-Account Pool
Load balancing across API keys and Google accounts
Add multiple API keys for the same provider to create a key pool. Flaxu uses P2C (Power of 2 Choices) load balancing to distribute requests, and automatically rotates away from throttled or rate-limited keys.
API Key Pool
Go to Settings > API Keys and add multiple keys for the same provider.
- Add multiple keys per provider (Anthropic, OpenAI, Google)
- Set priority (1-10) for each key to control routing preference
- Set daily token budgets to cap spending per key
- Throttled keys auto-recover after cooldown period
Google Account Pool for Gemini
Connect multiple Google accounts to create a Gemini OAuth pool. Each account provides its own rate limit quota, effectively multiplying your Gemini throughput.
Settings > Google Gemini > Add Account
Connect a Google account with Gemini API access
Repeat for additional accounts
Each account gets its own rate limit quota
Requests auto-rotate
When one account hits limits, traffic shifts to the next
P2C Load Balancing
When a request comes in, the system picks two random healthy keys from your pool, then selects the one with lower recent usage. This achieves near-optimal load distribution without tracking global state. Keys with higher priority scores are preferred.
Planning & Tasks
AI-powered plan and task management
Your AI assistant can create structured plans, manage tasks, and help you stay organized. Plans and tasks are automatically injected into the AI's context, so it always knows what you're working on.
How to Use
"Create a weekly exercise plan"AI creates a plan with tasks using create_plan + add_task
"Show my plans"Lists all active plans and their progress
"Mark the Monday task as done"Updates task status to completed
"Delete the old marketing plan"Removes completed or obsolete plans
Available Tools
Goals & Coaching
Set goals, track progress, get AI coaching
Set personal, business, or fitness goals and track your progress over time. Your AI coach monitors your progress and sends daily reminders to keep you motivated.
Goal Categories
How to Use
"I want to lose 10kg"Creates a FITNESS goal with target value. Daily reminders are automatically activated.
"I ran 2km today"Logs progress toward your goal with AI encouragement.
"Show my progress report"Gets an AI-powered analysis of your progress with suggestions.
Available Tools
Alerts & Monitoring
24/7 background monitoring and smart alerts
Set up smart alerts that work around the clock. The background worker checks your alerts every 30 seconds and sends notifications through your active channel — even while you sleep.
Alert Types
Get notified when a cryptocurrency price rises above your threshold. E.g., "Alert me when BTC goes above $70,000"
Get notified when a cryptocurrency price drops below your threshold. E.g., "Alert me when ETH drops below $2,000"
Monitor the web for specific keywords or topics. E.g., "Track Bitcoin news" or "Monitor AI regulations"
Automatic daily reminders for your active goals. Created automatically when you set a goal.
How to Use
"Alert me when BTC drops below $60,000"Creates a PRICE_BELOW alert. The worker checks every 3 minutes.
"Track Bitcoin news for me"Creates a NEWS_KEYWORD alert. Scans every 30 minutes.
"Show my alerts"Lists all active alerts with their status.
"Delete the ETH alert"Removes an alert you no longer need.
How It Works
You create an alert through chat (e.g., "Alert me when BTC drops below $60k")
A background task is created and the worker starts monitoring
The worker checks conditions every 30 seconds (prices every 3 min, news every 30 min)
When triggered, a notification is sent through your active channel (Telegram, Slack, etc.)
Available Tools
Smart Reminders
Set time-based reminders using natural language. Your AI assistant will send you a notification at the right time through your active channel (Telegram, WhatsApp, Discord, or Slack).
How to use
Just tell your AI assistant what to remind you about and when:
- "Remind me to call mom in 2 hours"
- "Remind me tomorrow at 9am to check emails"
- "Set a daily reminder at 8am for morning exercise"
- "Remind me every weekday at 10am for standup"
Available tools
set_reminderCreate a new reminder with natural language time
list_remindersView all your active reminders
delete_reminderCancel a reminder by ID
Vision & Documents
Image Analysis (Vision)
Send photos to your AI assistant on any platform and it will analyze, describe, and answer questions about the image. Powered by Claude, GPT-4o, and Gemini vision models.
- Telegram: Send any photo with an optional caption
- WhatsApp: Send an image message
- Discord: Attach an image to your /ask command
- Web: Include an image URL in your message
PDF & Document Reading
Share a PDF URL and your AI will extract the text, analyze the content, and answer questions about it. The read_document tool handles PDF parsing automatically.
- Send a PDF file on Telegram — automatically detected and parsed
- Share a PDF URL in any channel — AI uses read_document tool
- Supports text extraction, page count, and metadata (title, author)
Voice Messages
Send voice messages on Telegram or WhatsApp and your AI assistant will automatically transcribe them using OpenAI Whisper and respond to the content.
How it works
- You send a voice message on Telegram or WhatsApp
- The audio is downloaded and sent to OpenAI Whisper for transcription
- The transcribed text is processed as a regular message
- Your AI responds based on what you said
Requirements
- OpenAI API key required (for Whisper transcription)
- Supports all languages — Whisper auto-detects the language
- Works with voice notes, audio files (mp3, ogg, wav, m4a, webm)
Daily Summary
Get an automated daily briefing sent to your preferred channel every morning. Includes active tasks, goal progress, upcoming reminders, and alerts status.
How to enable
Just tell your AI: "Enable daily summary at 9am Istanbul time" or use the tools directly:
enable_daily_summaryActivate daily briefings with time and timezone
disable_daily_summaryTurn off daily summaries
What's included
- Today's reminders and upcoming deadlines
- Active tasks from your plans (pending and in-progress)
- Goal progress with percentage completion
- Active alert count (price, news monitors)
SSH Management
Remote server management via chat
Manage your remote servers directly from your AI assistant. Execute commands, read and write files, and monitor server status — all through natural conversation.
Available SSH Tools
Add a Server
Go to Dashboard > Settings > SSH Servers > Add Server. Enter your server's host, port, username, and SSH key or password. You can also add servers by chatting: "Add my server 192.168.1.100".
Execute Commands
Simply ask your AI assistant: "Check disk space on my server" or "Show running processes on production". The AI will use SSH to execute the command and return the results.
Database Queries
Query your PostgreSQL database via chat
Connect your PostgreSQL database and query it using natural language. Your AI assistant translates your questions into SQL and returns formatted results.
Available Database Tools
Connect Your Database
Go to Dashboard > Settings > API Keys > Add a "database" provider key. Enter your PostgreSQL connection URL (e.g., postgresql://user:pass@host:5432/dbname).
Query with Natural Language
Ask questions like "Show me the top 10 users by order count" or "What's the total revenue this month?". The AI writes and executes the SQL for you.
Shopify Integration
Manage your Shopify store via chat
Connect your Shopify store and manage products, orders, and collections through natural conversation with your AI assistant.
Available Shopify Tools
Connect Your Shopify Store
Go to Dashboard > Settings > API Keys > Add a "shopify" provider key. Enter your credentials as mystore.myshopify.com|shpat_xxx or as JSON: {"store":"mystore.myshopify.com","token":"shpat_xxx"}.
Manage Your Store via Chat
Ask things like "List my best-selling products", "Create a new t-shirt product for $29.99", or "Show me orders from today". New products are created as "draft" by default for safety.
Billing
Payments, plan changes, and invoice information
Flaxu uses Lemon Squeezy infrastructure for payment processing. All payments are processed securely and tax/VAT is calculated automatically.
Payment Methods
- Credit/Debit card (Visa, Mastercard, Amex)
- Monthly automatic payment
- Cancel at any time
Changing Plans
When upgrading from Starter to Pro, a prorated difference is calculated for the remainder of your current billing period. When downgrading from Pro to Starter, you continue to use Pro features until the end of your current period.
Canceling Subscription
Dashboard > Settings > Subscription > Cancel. After cancellation, you can continue using the service until the end of your current billing period.
POST /api/lemonsqueezy/create-checkout
Content-Type: application/json
{
"plan": "PRO",
"interval": "monthly"
}
// Response:
{
"success": true,
"checkoutUrl": "https://yourstore.lemonsqueezy.com/checkout/buy/..."
}Frequently Asked Questions
The most commonly asked questions and answers
1What is Flaxu?
2What is the difference between the Starter and Pro plans?
3How do I get my own API key?
4How many channels can I use at the same time?
5Can I cancel my subscription at any time?
6Is my data safe?
7How can I get technical support?
Create Your AI Assistants Now
Create your account and start running your first AI assistants across all channels in minutes.