A read-only utility to access and search your local WeChat SQLite database records for contacts, sessions, and messages.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install wechatky8v
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install wechatky8v using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is WeChat Local Data Reader?
The WeChat skill for Openclaw Skills is a specialized tool designed to bridge the gap between AI agents and local messaging data. It allows users to securely query their local WeChat SQLite databases on macOS and Windows without modifying any original files. By leveraging Openclaw Skills, developers can build workflows that reference chat histories, contact lists, and favorited items, all while maintaining strict data privacy as no information is uploaded to external servers and all operations are strictly read-only.
WeChat Local Data Reader Use Cases
- Retrieving contact details and WeChat IDs directly from local storage using Openclaw Skills.
- Searching through chat history for specific keywords or past discussions.
- Generating statistics on messaging volume and contact frequency.
- Accessing favorited notes and links for research and knowledge management.
- Reviewing recent chat sessions and unread message counts for automated reporting.
How WeChat Local Data Reader Works
- The user ensures WeChat has been logged in on the local machine to populate the SQLite databases.
- Openclaw Skills identifies the default WeChat data directory or uses a user-provided custom path.
- The tool opens relevant SQLite files such as Contact.sqlite, Session.sqlite, and Chat.sqlite in read-only mode to prevent any data corruption.
- Specific Python commands are executed to query the database tables for the requested information like contacts or search results.
- Results are formatted into readable tables or lists and returned to the terminal or AI agent for further processing.
WeChat Local Data Reader Setup
Before using this skill, ensure OpenClawCLI is installed. For macOS users, you must grant Full Disk Access to your terminal via System Settings > Privacy & Security > Full Disk Access.
Verify your access to the data directory:
ls -la ~/Library/Containers/com.tencent.xinWeChat/
Run the following command to list available databases and confirm the setup for Openclaw Skills:
python3 scripts/wechat.py list
WeChat Local Data Reader Data Schema & Taxonomy
The skill organizes and accesses data across several key SQLite databases to provide a comprehensive view within Openclaw Skills:
| Database | Content | Technical Details |
|---|---|---|
| Contact.sqlite | Contact Information | Stores WeChat IDs, nicknames, and contact notes. |
| Session.sqlite | Chat Sessions | Tracks recent conversations and unread message status. |
| Chat.sqlite | Chat History | Contains message content, sender details, and timestamps. |
| Favorite.sqlite | Favorites | Includes saved messages, web links, and user notes. |
| Brand.sqlite | Official Accounts | Lists followed public and brand accounts. |
WeChat Local Data Reader Advanced Features
- Custom path configuration using the
--pathflag to support Windows installations or non-standard data directories. - Integrated SQLite read-only enforcement using the mode=ro parameter to guarantee original data remains untouched.
- Automated Unix timestamp conversion to human-readable date-time formats for all message and session logs.
- Query pagination using the
--limitargument to handle large messaging datasets efficiently. - Comprehensive data summary reports via the stats command to visualize total messaging activity.
SKILL.md
Loading
Related Openclaw Skills
WeChat Local Data Reader
A technical utility for querying and analyzing local WeChat SQLite databases to retrieve contacts, messages, and favorited content.
Web Search Skill
A powerful DuckDuckGo-powered search tool for Openclaw Skills that enables AI agents to retrieve real-time web, news, image, and video data.
Web Search
A versatile search utility that enables AI agents to retrieve real-time web data, news articles, images, and videos via DuckDuckGo.
Google Veo 3.x Video Generation
Generate high-quality AI videos and multi-segment clips using Google Veo 3.x and the Gemini API through a streamlined CLI workflow.
WeChat Local Data Reader
A read-only SQLite utility to access and search local WeChat data including contacts, sessions, and messages.
YouTube
A comprehensive YouTube Data API v3 integration that provides managed OAuth authentication for searching videos, managing playlists, and interacting with comments.
Featured*
