Wake Grok Bot from WeChat to Check Email, Read Webpages, and Reply

Input: WeChat private text → Processing: local bridge notifies + Grok Bot reads inbox and calls tools → Output: WeChat reply

Who

Technical users with Linux basics who need to trigger AI tasks remotely via WeChat

You get

Send natural-language commands in WeChat; Grok Bot wakes up, checks email, reads webpages, runs scripts, and sends results back

You need

Grok Bot

Steps

1. Safety tip

   Safety tip: before the bot sends or submits to an external system, confirm the recipient/target and the content.

2. Preparation

   Confirm three prerequisites: 1) Grok Bot assistant is available (includes Linux, can write files, run Python, and keep background processes); 2) you have a WeChat account that can scan a QR code for binding; 3) read the Tencent openclaw-weixin protocol documentation at https://github.com/Tencent/openclaw-weixin/blob/main/docs/protocol_zh_CN.md — treat the source code as authoritative for anything not covered in the docs.

3. Deploy the Bridge Program

   Write a Python bridge program in Grok Bot's Linux environment, using mostly the standard library, under ~/workspace/wechat-bridge/. Implement 5 commands: 1. login: call get_bot_qrcode to fetch a QR code and generate a PNG. 2. wait-login: poll get_qrcode_status and handle states including wait/scaned/confirmed/expired/verification-required/redirect; after confirmation, atomically write credentials to state/session.json with permissions 600. 3. serve: use getupdates long-polling to receive messages, persist cursor get_updates_buf to resume after restart; process only private messages from the bound user, ignore groups and others; deduplicate by message_id and write to inbox/. 4. send: reply via sendmessage, must include the context_token received with the original message; auto-split messages over 4000 characters, use client_id and send logs to prevent duplicates. 5. status/health: check login state, process, last poll time, and task backlog; mask credentials to first/last 4 digits to avoid leaks in logs or screenshots.

4. Configure the Wake-Up Routine

   Create a scheduled task (routine) in Grok Bot: set trigger type to webhook, and add a 10-minute periodic trigger as fallback and health check (if webhook fails, messages are processed within ~10 minutes). Key configurations: - Secure storage: save webhook URL and secret as environment variables on the machine, enter them via Grok Bot's encrypted input fields; secrets must not pass through chat. - Minimal notification: when the bridge receives a new message, POST only a notification containing the message ID to the webhook, without credentials or message content; the AI reads the message from local inbox/ after being woken. - Workflow description: in the routine instructions specify the execution order — check health → fetch pending tasks → mark "executing" → execute with tools → send back to WeChat via send → mark "sent". Task states are 5: received, executing, pending-send, sent, failed. If execution succeeds but sending fails, state stays "pending-send"; next wake-up retries send only, not re-execution.

5. Scan QR Code and Go Live

   1. Have your phone ready, generate the QR code (expires in ~5 minutes), scan and confirm. 2. Start the background service with setsid + nohup so it restarts automatically on crash. 3. Critical: open the robot's chat window in WeChat and send a message — you must send it inside the chat window; saying "done" elsewhere does not provide the first context_token. This message is used to obtain the initial context_token. 4. Send a test command (e.g., "summarize today's emails") and verify it triggers email checking and returns a summary.

No prompt needed — just follow the steps.