How to set up a Clash of Clans bot (phone and PC)

cocbot team · Last updated: November 8, 2026

Short answer

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.

Download the APK
Unknown sources permission
Save the license key
Accessibility permission
Battery restriction
Start and entire screen

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.

StepWhat to doWhat happens if you skip it?
Unknown sourcesAllow installsThe APK won't install
License keyPaste in Settings, tap SaveFeatures stay locked
AccessibilityTurn on cocbotThe bot can't tap the screen
Battery restrictionRemove the restrictionThe bot may close in the background
Entire screenChoose entire screen when sharingYou 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.

CriterionPhone (APK)PC (LDPlayer + panel)
Setup timeShortA bit longer
Extra softwareNot neededLDPlayer required
MonitoringApp and TelegramPanel (127.0.0.1:8765) and Telegram
Does it keep the phone busy?YesNo

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.

Telegram: BotFather, token, /baglan CODE

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.

Multiple accounts: switching between saved accounts in turn

Troubleshooting table

SymptomLikely causeFix
The bot sees a black screenScreen sharing is not the entire screenConfirm Start again and choose "entire screen" when sharing
It says the license is invalidThe code is wrong or expiredPaste the code again without spaces; if that doesn't work, message WhatsApp support
The bot stopped after a whileThe app was closed in the backgroundOpen the app and tap Start; remove the battery restriction
Taps aren't workingThe accessibility permission is offTurn on cocbot in the accessibility settings
The APK won't installThe unknown sources permission is missingGrant the permission from the setting in the install warning
Telegram doesn't respondThe token is wrong or not connectedEnter the token again, send the /baglan CODE command again
The panel won't open (PC)The panel isn't running or the port is differentRestart the panel and try 127.0.0.1:8765
The emulator won't connect (PC)ADB is offTurn 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

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.

Download the APK and try itMessage us on WhatsApp

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.

Support