# Cleaner

The Cleaner module removes data from your accounts: leaves channels and groups, clears dialog history, deletes contacts, and optionally removes personal traces like photos, username, and bio.

![Cleaner settings](/files/hCMzPIsqMda2wkxBJhp4)

## Settings Reference

| Setting             | Description                                                                                                                                                |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Threads**         | How many accounts to clean at the same time. Default: 5, maximum: 100.                                                                                     |
| **Account Limit**   | Maximum number of accounts to clean. Set to **0** to clean all selected accounts.                                                                          |
| **Timeout**         | How long to spend cleaning each account (in minutes). Configurable from 2 to 20 minutes. Accounts with many subscriptions may need a longer timeout.       |
| **Leave Channels**  | Leave all channels the account is subscribed to.                                                                                                           |
| **Leave Groups**    | Leave all groups the account is a member of.                                                                                                               |
| **Clear Dialogs**   | Delete all direct message (DM) conversations.                                                                                                              |
| **Delete Contacts** | Remove all saved contacts from the account.                                                                                                                |
| **Clear Traces**    | Remove personal data: profile photos, stories, username, bio, birthday, emoji status, web sessions, and drafts. This is the most thorough cleaning option. |

## How to Use

1. Go to **Cleaner** in the sidebar
2. Set the number of **Threads**
3. Toggle **on** the cleaning actions you want (Leave Channels, Leave Groups, etc.)
4. Select a **Proxy list**
5. In the **Accounts** section, select which accounts to clean
6. Click **Start**

{% hint style="info" %}
If you want to fully wipe accounts before selling or repurposing them, enable all options including **Clear Traces**. This removes virtually everything from the account profile.
{% endhint %}

## Understanding the Results

The log shows what was found and removed on each account:

* **found: channels:15, groups:8, DMs:42, contacts:120** -- what was detected
* **CLEANED (ch:15, gr:8, dm:42, con:120)** -- what was successfully removed
* **FROZEN** -- account is restricted, cleaning may be incomplete
* **BANNED / AUTH\_KEY\_DEAD** -- account is dead, nothing to clean

The summary at the end shows totals for channels left, groups left, dialogs cleared, and contacts deleted across all accounts.

{% hint style="warning" %}
**Cleaning is irreversible.** Once you leave channels, clear dialogs, or delete contacts, there is no way to undo it. Make sure you selected the right accounts.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mvs-3.gitbook.io/mvs-docs/modules/cleaner.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.