Skip to content
PerisclawDocs
ChangelogPartner with usSupportOpen Perisclaw
PerisclawDocs

Getting started

What is PerisclawSet up your assistantUsing Perisclaw

What Perisclaw can do

Tasks & commitmentsSchedule reminders & messagesOrganize your WhatsAppMissionsAutomationsSearch across everythingPersonal wikiRelationship memoryPersonal memoryVoice

Skills & integrations

Custom skillsWeb researchBrowserCalendarDrive & SheetsConnecting apps

Use with Claude & other AI

Perisclaw plugin & MCP server

Security & control

Privacy & securityPermissions & access

Account & help

Account & settingsRefer a friendFAQsPartner with us

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.

Check these two things first

Open WhatsApp → Settings → Linked Devices and confirm that Perisclaw appears there. Then make sure you are messaging the self-chat with your own name, not a saved contact with a similar name.

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 your assistant

/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.

Still not working?

Send our support team the step that failed and a screenshot of what you see.

Never include a pairing code, payment details, or private message content.
Message support
SecurityTermsPrivacy

© 2026 Hashlabs Holdings Inc

On this page

WhatsApp will not linkSigning inPerisclaw is connected but not replyingThe WhatsApp connection droppedBilling is blocking access