Assistant Automation
Schedule Assistant tasks to run automatically on a recurring basis. ScreenerBot executes your custom instructions through the Assistant runtime with tool calling, tracks run history, and sends Telegram notifications on completion.
What is Automation?
Scheduled Assistant Execution
Automation lets you create tasks that run your custom Assistant instructions on a schedule. Each task executes in headless mode — the Assistant processes your instruction, calls tools as needed (checking positions, analyzing tokens, reading market data), and records the results. You can review every run's output, tool calls, and status.
This is perfect for automated portfolio monitoring, periodic market scans, position health checks, and daily/weekly reporting — all powered by your configured selected LLM provider.
Schedule Types
Interval
Run every N seconds. Ideal for continuous monitoring tasks.
300= every 5 minutes
3600= every hour
Daily
Run once per day at a specific UTC time.
14:00= daily at 2 PM UTC
09:30= daily at 9:30 AM UTC
Weekly
Run on specific days of the week at a set time.
mon,wed,fri:09:00= MWF at 9 AM UTC
sun:18:00= Sundays at 6 PM UTC
Tool Permissions
Read Only (Recommended)
The Assistant can read data but cannot execute trades or modify settings. Safe for monitoring and analysis tasks.
Full Access
The Assistant can request every tool, including trading operations, subject to the shared Agent Control policy. Full task mode does not add an interactive confirmation step.
Example Tasks
Portfolio Health Check
“Check all open positions. For each position, analyze the current price action and report if any show signs of reversal or significant loss. Summarize the overall portfolio health.”
Daily Market Summary
“Generate a summary of today's trading activity. Include total P&L, number of trades, best and worst performers, and any notable market events from the event log.”
Whale Activity Scanner
“Check the top 5 tokens by volume from recent transactions. Analyze their security data and market metrics. Flag any with suspicious activity patterns or sudden volume spikes.”
Weekly Performance Report
“Generate a comprehensive weekly performance report. Include total P&L, win rate, average hold time, best strategies, and recommendations for the coming week.”
Configuration
Automation settings live in the [assistant] config section (Settings → Configuration → Assistant):
| Setting | Default | Description |
|---|---|---|
| scheduled_tasks_enabled | false | Enable the automation scheduler |
| check_interval_seconds | 30 | How often to check for due tasks (10-300s) |
| max_concurrent | 1 | Max concurrent task executions (1-5) |
| default_timeout_seconds | 120 | Default timeout per task run (30-600s) |
Telegram Notifications
Get Notified
Each automation task can send Telegram notifications when it completes or fails. Configure per-task notification preferences:
- Notify on success— Get the Assistant's response summary
- Notify on failure — Get error details and timeout warnings
Requires Telegram bot to be configured. See Telegram Setup.
Creating a Task
Go to Assistant → Automation
Open the Automation tab in the Assistant page sidebar.
Click “New Task”
Fill in the task name, instruction, schedule type and value, tool permissions, and notification preferences.
Test with “Run Now”
Use the play button to trigger an immediate execution and verify the Assistant produces useful output.
Enable the Task
Toggle the task on. The scheduler will automatically execute it based on your configured schedule. Monitor runs in the Recent Runs timeline.
Important Notes
API Costs
Each task execution makes one or more API calls to your selected LLM provider. Frequent schedules (e.g., every minute) can accumulate costs quickly. Start with longer intervals, or use Ollama to test locally at no API cost.
Prerequisites
Automation requires [llm] enabled = true with a valid API key on the provider named by default_provider, [assistant] enabled = true, and scheduled_tasks_enabled = true.