Troubleshooting
Checks for WhatsApp linking, replies, connection, and billing access.
Start with what you see, then follow the checks in order. Most problems are a stale linking code, the wrong chat, or a dropped WhatsApp connection.
WhatsApp will not link
The QR code expired before I could scan it
Return to the Perisclaw web app and choose Couldn't link device? Click to restart for a fresh code, then scan it immediately. QR codes are deliberately short-lived.
WhatsApp says it cannot link another device
Open WhatsApp → Settings → Linked Devices, remove a device you no longer use, and try again. WhatsApp limits how many devices can be linked at once.
The pairing code does not work
Generate a fresh code in the web app. In WhatsApp choose Linked Devices → Link a Device → Link with phone number, then enter the new eight-character code.
It asks me to finish linking in the desktop app
Your number uses passkey linking, which Perisclaw completes inside its desktop app. Choose Get the desktop app, install it, and reopen the linking screen there.
Signing in
My sign-in code did not arrive
Check your chat with Perisclaw Support (+91 92057 59988) on WhatsApp. If the code doesn't come within a minute, reload the page and try again, or choose Continue with Google instead.
It says this number is not on Perisclaw yet
Codes only go to numbers that have connected to Perisclaw, so a new number starts with sign-up. Choose Continue with Google to create your account. Your number is kept, and the next step shows a QR code to link it in WhatsApp. To start with a different number, choose the pencil next to your number.
It says my Google account already has a Perisclaw account
Each account has one WhatsApp number for now. Choose Open to go to the account you already have, or Use a different Google account to set up the new number under another account.
It says this number already has a Perisclaw account
The number belongs to another account. Choose Sign in with this number. You're signed out and the number is filled in on the sign-in page. Choose Continue with WhatsApp to get a code and open that account.
Perisclaw is connected but not replying
I linked it, but I have not received the first reply
Give the assistant about 30 seconds to start. Search WhatsApp for your own name, open that self-chat, and send “hello” once more. If WhatsApp still shows Perisclaw under Linked Devices, do not repeat the linking flow.
It does not answer in another chat or group
Include /claw in the message, for example
“/claw what did we decide?” Perisclaw stays silent outside your
self-chat until you call on it, unless you set up an
Automation for that chat.
The assistant is still working on the wrong request
Send /stop in your self-chat to halt the current request and
anything queued behind it. Use /ignore inside a message when
you only want Perisclaw to ignore that one message.
The assistant appears stuck or unresponsive
Restart it from your self-chat, wait for the confirmation, then send the request once more. Restarting is for a stuck assistant; it does not repair a missing Linked Devices connection.
/restart
The WhatsApp connection dropped
The web app says WhatsApp is disconnected
First check Linked Devices on your phone. If Perisclaw is missing, choose Reconnect WhatsApp in the web app and link it again with a fresh QR or pairing code. Your saved profile and workspace remain attached to the account.
On a paid plan, your assistant keeps working while WhatsApp is disconnected. During a trial, it pauses 30 minutes after WhatsApp disconnects. Reconnecting brings it back with your chats and connections, and that can take a few minutes.
I changed phones or removed the linked device
Sign back in to the same Perisclaw account and link the active WhatsApp number again. Removing the phone connection does not by itself delete the account or its saved workspace.
Can Perisclaw warn me about a disconnect?
Yes. In the web app, choose Turn on notifications at the top of the page or Alerts in the side bar or phone menu, and allow them in your browser. See Account & settings.
Billing is blocking access
The web app says my assistant is paused or suspended
Open Settings → Billing. If an invoice is unpaid, open it and choose Pay now. If the plan has ended, choose an available plan to restore access.
I paid, but the assistant is still unavailable
Refresh the Billing screen and confirm that it shows an active plan. If your plan was paused for more than 3 days, your assistant was disconnected, and paying brings it back with your chats and connections. That usually takes a few minutes. If it hasn't come back after that, choose Reconnect WhatsApp in the web app. If you see "Your assistant is busy with another update. Try again in a minute.", it's still coming back: wait a minute and try again. If the plan shows as active and access is still blocked, send support a screenshot of the Billing status. Never the card details.