weixin-openclaw-login

What This Skill Does

The weixin-openclaw-login skill provides a standardized framework for handling the official WeChat personal account authentication process within the OpenClaw ecosystem. It bridges the gap between the Tencent ilink authentication services and the OpenClaw gateway. This skill simplifies complex manual tasks such as installing the required WeChat plugin, fetching actionable login QR codes, monitoring real-time scanning statuses via polling, and troubleshooting persistent "no token" state errors. It acts as an orchestrator for local configuration files, ensuring that authenticated session tokens are correctly registered and recognized by the OpenClaw environment.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface: clawhub install openclaw/skills/skills/aqhi/weixin-openclaw-login Once installed, ensure you have the necessary dependencies for the WeChat CLI by running: npx -y @tencent-weixin/openclaw-weixin-cli install

Use Cases

• Streamlined Authentication: Automate the process of retrieving valid login URLs for WeChat bot integration.
• Debugging Connection Issues: Quickly identify if an authentication failure occurs at the Tencent server level (e.g., waiting for user scan) or within the local OpenClaw gateway configuration.
• System Maintenance: Perform manual verification of account states and clean up or verify synchronization files located in ~/.openclaw/openclaw-weixin/ when status reporting shows "SETUP / no token."

Example Prompts

1. "Initialize the WeChat login process and provide me with the authorization URL for scanning."
2. "Check the current status of my WeChat bot login and verify if the token has been correctly generated."
3. "My OpenClaw status shows 'no token' even after scanning, please help me troubleshoot and restart the gateway."

Tips & Limitations

• Persistence: Always verify that your account-specific JSON file (e.g., account-id.json) is correctly generated in the ~/.openclaw/openclaw-weixin/ directory before declaring a login successful.
• Reliability: Using the provided scripts/get-login-url.js is significantly more reliable than attempting to parse raw character-based QR codes displayed in terminal outputs.
• State Management: If the authentication status is confirmed but the system remains unresponsive, ensure you perform a openclaw gateway restart to reload configuration files. Note that this skill interacts directly with Tencent servers; excessive polling may trigger rate limits.