How to set up a Clash of Clans bot (phone and PC)
cocbot installs with an Android APK on your phone and with LDPlayer and a local panel on your computer. On your phone, you download the APK and grant the permissions, paste the license key into Settings (Ayarlar), choose "entire screen" at screen sharing and tap Start (Başlat). On PC, you install the game in LDPlayer, enable ADB and use the panel at 127.0.0.1:8765.
Before you start
There are two ways to install: the Android APK on your phone, or LDPlayer and a local panel on your computer. Whichever you choose, you need three things: Clash of Clans installed, a license key (a free trial code works too) and a few minutes. The phone route needs Android 8 or later and a device with an arm64 processor; most recent phones meet this. You can get your trial code from the download page. All features are unlocked in the trial and the code expires on its own after 3 days.
If you'd like to see what the bot does first, take a look at the article explaining how the bot works. Because it works by reading the screen and tapping, you only need to grant a few permissions during setup; we walk through each step below.
Route 1: Install on your phone (Android APK)
The phone route is the shortest. You don't install an emulator and your computer doesn't have to stay on. Here is an overview of the six steps; the details of each step follow.
1. Download the APK
Tap the APK button on the download page. Your browser may show a warning for this file type because the app comes from outside the store. Download the APK only from the link on our page. If you download it from another source, you can't be sure the file is the same.
2. Allow the unknown sources permission
Android asks for permission before installing apps from outside the store. In the warning on the install screen, tap the settings button and turn on "allow installs from this source" for the app you downloaded the file with (the browser or a file manager). Menu names can vary a little by phone brand and Android version. After granting the permission, go back and confirm the install.
3. Open the app and save the license key
When the install finishes, open cocbot. In Settings (Ayarlar), find the "License key" (Lisans anahtarı) field, paste your code and tap Save (Kaydet). Make sure no space is left at the start or end when you copy the code. If you got a trial code, you paste it in the same field; a key you purchased goes in the same place.
4. Accessibility permission
The app asks for two steps in order. The first step is the accessibility permission. The bot controls the game by tapping the screen, and on Android the way to do that is the accessibility service. You go to the settings screen, find cocbot in the list and turn it on. If the system shows a warning, you need to read it and confirm.
5. Battery restriction
The second step is the battery restriction. To save battery, phones can close apps running in the background. Because the bot runs 24/7, you need to take cocbot out of this restriction; in the battery settings, choose "no restrictions" or a similar option.
Extra setting on Xiaomi, Redmi and POCO phones
On these brands, the system shuts down background apps more aggressively than on others. That's why we suggest checking two settings: in the app info, set battery saver to "no restrictions", and turn on the "autostart" permission if there is one. If you like, you can also lock the cocbot card in the recent apps screen to keep it from being closed. Menu paths change with the MIUI and HyperOS version; if the names don't match exactly, look at the battery and permission sections of the app info screen.
6. Tap Start and choose the entire screen
When you tap Start (Başlat), Android asks for confirmation for screen sharing. The bot reads the game from this image. In the options that appear, choose the "entire screen" option. Sharing only a single app can make the image the bot sees come out black. After you confirm sharing, you can leave Clash of Clans open; the bot starts searching for opponents and attacking.
| Step | What to do | What happens if you skip it? |
|---|---|---|
| Unknown sources | Allow installs | The APK won't install |
| License key | Paste in Settings, tap Save | Features stay locked |
| Accessibility | Turn on cocbot | The bot can't tap the screen |
| Battery restriction | Remove the restriction | The bot may close in the background |
| Entire screen | Choose entire screen when sharing | You may see a black screen |
Route 2: Install on your computer (LDPlayer and panel)
Choose the computer route if you don't want to keep your phone busy all the time or you'd like to watch the bot on a bigger screen. On this route the game runs in the Android emulator called LDPlayer, and cocbot's panel opens as a local app on your computer.
Installing LDPlayer
Download and install the emulator from LDPlayer's official site (ldplayer.net). On first launch, install Clash of Clans inside the emulator and sign in to your account. Check that the game opens in the emulator without problems; the bot can read the game screen as long as it opens. Pick the emulator size and performance settings to suit your computer; a very low setting can slow the game down.
ADB connection
The panel talks to the emulator through ADB (Android Debug Bridge). You need to turn on the ADB debugging option in LDPlayer's settings. The exact name of the option can vary a little by version; search the settings menu for "ADB" or "local connection". Once the connection is made, the panel sees the emulator in its list.
Local panel: 127.0.0.1:8765
The panel is an interface that runs on your computer and opens in your browser at 127.0.0.1:8765. This address belongs only to your own computer; nobody can reach it from the internet. In the panel you see the status, start and stop the bot and change settings. You also enter the license key in the panel. If the address doesn't open, make sure the panel app is running.
| Criterion | Phone (APK) | PC (LDPlayer + panel) |
|---|---|---|
| Setup time | Short | A bit longer |
| Extra software | Not needed | LDPlayer required |
| Monitoring | App and Telegram | Panel (127.0.0.1:8765) and Telegram |
| Does it keep the phone busy? | Yes | No |
Connecting Telegram
Connecting Telegram is optional but very useful: you can use the /durum, /baslat and /durdur commands remotely and get an hourly summary. There are three steps to connect it. First, talk to BotFather on Telegram and create your own bot with the /newbot command; BotFather gives you a token. This token is the secret key to your bot; don't share it with anyone. In the second step, enter the token in the Telegram field in cocbot's settings. In the third step, send the bot you just created /baglan CODE on Telegram, replacing CODE with the connection code shown in the app. After it connects, the bot replies when you send /durum.
Multiple accounts
If you have more than one Clash of Clans account, cocbot can cycle through the accounts saved on the device. One detail matters here: the bot doesn't type passwords. Your accounts must already have been added in the game, that is, among the Supercell ID accounts saved on the device. The bot only switches between these saved accounts. If you want to add a new account, add it yourself in the game first, then start the bot.
Troubleshooting table
| Symptom | Likely cause | Fix |
|---|---|---|
| The bot sees a black screen | Screen sharing is not the entire screen | Confirm Start again and choose "entire screen" when sharing |
| It says the license is invalid | The code is wrong or expired | Paste the code again without spaces; if that doesn't work, message WhatsApp support |
| The bot stopped after a while | The app was closed in the background | Open the app and tap Start; remove the battery restriction |
| Taps aren't working | The accessibility permission is off | Turn on cocbot in the accessibility settings |
| The APK won't install | The unknown sources permission is missing | Grant the permission from the setting in the install warning |
| Telegram doesn't respond | The token is wrong or not connected | Enter the token again, send the /baglan CODE command again |
| The panel won't open (PC) | The panel isn't running or the port is different | Restart the panel and try 127.0.0.1:8765 |
| The emulator won't connect (PC) | ADB is off | Turn on ADB in LDPlayer's settings |
If you can't find a fix, use the Support button at the bottom right of the page to message us on WhatsApp; just tell us where you got stuck in the setup steps.
Phone or PC: which should you choose?
If you play on a single phone and don't mind the bot running on that same phone, the phone route is the most practical; setup is quick and no extra software is needed. However, it gets harder to use the phone for other things while the bot runs, because the bot reads the screen and taps it. If you can keep the emulator open on your computer, the PC route solves this: your phone stays free, you can watch the bot on a big screen and it's easy to change settings from the panel. You can use both routes with the same license; you can see which one suits you during the free trial. For pricing information, see the pricing page.
Update and privacy notes
The game's interface changes from time to time, and the bot may need an update when that happens. We announce updates on the release notes page; just download the new APK from the download page and install it over your existing app. Your license key stays the same. After an update, it's a good habit to check that the accessibility and battery settings are still on, because some phones can reset these settings when the version changes.
On privacy, there are three simple rules. Don't share your license key or Telegram token with anyone; both are personal to you. The bot doesn't type account passwords, so you never need to enter your password anywhere. Download the APK only from the link on this site. If you run into a problem, messaging us on WhatsApp with a screenshot speeds up the fix.
Common setup mistakes
- Choosing only a single app in screen sharing; "entire screen" must be selected.
- Skipping the battery restriction; the bot may close in the background after a while.
- Pasting the license code with a space.
- Forgetting the autostart permission on Xiaomi-like phones.
- Trying to run the panel on PC without turning on ADB.
Your first day after setup
The healthiest thing is to watch the bot on its first day of running. Check that the minimum loot filter suits your level, make sure your army is ready in the game (the bot uses whatever is in the bottom bar) and follow the Telegram summary. Then, to settle your settings, see the farm guide, the wall guide for wall spending and the research order article for the Laboratory. For comparison with other bots there is our comparison page, for pricing the pricing page and for farming features the farm bot page. You can find what changed in each version in the release notes.
Gem spending and speed-ups only work if you tick the checkbox yourself, and they never spend real money. They are off by default.
Frequently asked questions
Does the Clash of Clans bot work on a phone without an emulator?
Yes. cocbot runs directly on your phone as an Android APK. You need a phone with Android 8 or later and an arm64 processor.
What do I need to set it up on PC?
The LDPlayer emulator with Clash of Clans installed, plus cocbot's local panel. The panel runs on your computer and opens at 127.0.0.1:8765.
How do I connect Telegram?
Create a bot with BotFather, enter the token you receive in the settings, then send your own bot the command /baglan CODE.
Does the bot type my password?
No. The bot does not type account passwords. With multiple accounts it only switches between Supercell ID accounts already saved on the device.
What should I do if the screen looks black while the bot is running?
Make sure you chose "entire screen" in screen sharing; sharing only a single app can cause a black image.