Task Panel Guide
1. Overview
Task Panel is FiraClaw's automation management center. Here, you can create, view, and manage all to-do items and scheduled work executed by AI.
Unlike traditional备忘录, tasks in FiraClaw are executable - when a task reaches its preset time, the designated agent will automatically wake up and start working, without you having to stand in front of the computer.
What can you do here?
- Plan one-time work (e.g., help me download a certain file at 10 PM tonight).
- Set recurring reminders (e.g., generate sales weekly report every Friday at 3 PM).
- Monitor task execution status (success/failed/in progress).
- Visually manage all automated processes through kanban or calendar views.
2. Dual View Mode Switching
Task Panel provides two visualization perspectives. You can switch between them anytime based on your usage habits. The switch button is located in the upper right corner of the panel.
2.1 Kanban View (Default)
Kanban view displays tasks in the form of column status, convenient for tracking by progress.
| Column Name | Description |
|---|---|
| To Do | Newly created tasks are stored here by default, waiting for trigger time. |
| In Progress | Tasks currently being executed by agents. |
| Completed | Tasks that executed successfully and ended (including one-time tasks and single execution records of recurring tasks). |
| Failed/Paused | Tasks with execution errors or manually paused. |
Drag Operation: You can directly drag task cards to other columns to pause or restart.
2.2 Calendar View
Calendar view displays task schedules in month/week/day time dimensions, suitable for viewing work density.
- Task Labels: Calendar cells will display the task summary for that day. Color bars represent the agent the task belongs to.
- Quick View: Hover the mouse over the task label to preview task details.
3. Three Ways to Create Tasks
3.1 Manual Creation (Within Task Panel)
Suitable for scenarios where you clearly know the execution time and steps.
- Click the New Task button in the upper right corner of the panel.
- Fill in task information:
- Task Name: Easy-to-identify title.
- Execution Agent: Select who will complete it (for example, CEO or the Python Expert you created).
- Task Instructions: Detailed description of what you want AI to do.
- Task Type: See Section 4 for details.
- Click save, and the task will appear in the "To Do" column of the kanban.
3.2 Creating in AI Assistant (Recommended)
Suitable for complex tasks that need AI to help decompose steps.
- Describe your needs to the CEO Agent in the AI Assistant dialogue.
- Example Instruction: "Help me create a task that reads the company mailbox every morning at 7, and sends the unread email titles to my WeCom channel."
- CEO will analyze the needs, automatically fill in task name and instructions, and select the most suitable agent.
- Click the Confirm Create button in the task card returned by CEO.
3.3 Automatically Created Through Agent Scheduling
When executing complex projects, CEO may automatically decompose subtasks and put them into the panel without your intervention. You only need to view progress in the task panel.
4. Task Type Details
FiraClaw supports three task trigger modes. Please select based on your needs when creating.
| Type | Description | Configuration Example |
|---|---|---|
| One-time Task | Execute once at the specified time point. | Tonight 22:00, download a certain video. |
| Scheduled Task | Execute once at a fixed future time point. | May 1, 2026 09:00, send holiday greeting email. |
| Recurring Task | Execute periodically. Supports recurrence by minute, hour, day, week, month. | Every Monday 09:00, generate previous week's work summary report. |
Recurring Task Advanced Settings:
- End Condition: Can be set to infinite recurrence, or specify number of recurrences or end date.
- Missed Compensation: If you missed a trigger time due to computer shutdown, you can choose "Execute immediately once" or "Skip".
5. Task Execution and Monitoring
5.1 How to Judge if a Task is Working?
- When the task card moves to the In Progress column, it means the agent is processing it.
- You can double-click the task card to view real-time execution logs (that is, AI's thinking and operation steps).
5.2 What to Do if a Task Fails?
If the task card appears in the Failed column:
- Click the card to view the error reason (for example: network timeout, API balance insufficient, file permission insufficient).
- Click the Retry button, or manually modify the task instructions and run again.
6. ⚠️ Important Notes
The prerequisite for task execution is: FiraClaw program must keep running!
- Foreground Running: Software window is not closed.
- Background Running: Software is minimized to system tray (icon area in the lower right corner of the computer).
- Sleep Invalidation: If your computer enters sleep/hibernate/shutdown state, tasks will not trigger. Please pay attention to "Never sleep" when setting computer power options.
7. FAQ
Q: Can I make tasks run only when I'm not using the computer?
A: Yes. As long as FiraClaw is open and the computer is not locked/sleeping. It is recommended to schedule a large number of tasks during nighttime or lunch breaks.
Q: There are too many tasks in the task panel, what should I do if it's hard to find them?
A: The top of the kanban view supports filtering by agent name and task status.
Q: I want to pause a recurring task for a period of time instead of deleting it. What should I do?
A: In the kanban view, drag the recurring task card from the "To Do" column to the "Paused" column. Drag it back to "To Do" when you need to resume.
Q: How long will task execution records be kept?
A: All task execution logs are saved on your local computer and will be kept permanently as long as you don't manually clear them. You can configure the automatic cleanup cycle in settings.