Summary

This project provides a plugin for Claude Code, enabling users to bridge WeChat messages directly into Claude Code sessions. It targets users who wish to leverage Claude's capabilities within their WeChat communication workflow, offering a convenient way to interact with the AI model through a familiar messaging interface. The primary benefit is the seamless integration of AI-powered assistance into daily WeChat conversations.

How It Works

The plugin facilitates communication by routing messages from WeChat (iOS) through the official WeChat ClawBot ilink API. These messages are then processed by the plugin, which acts as a bridge to Claude Code sessions using the MCP (Model Context Protocol) Channel extension. Replies from Claude Code are sent back to WeChat via the same pathway. Message reception utilizes ilink/bot/getupdates long polling, while message sending employs ilink/bot/sendmessage. Authentication is handled via QR code login to obtain a Bearer Token.

Quick Start & Requirements

• Primary install/run command:
  1. npx claude-code-wechat-channel setup (Scan QR code with WeChat for authentication; credentials saved to ~/.claude/channels/wechat/account.json).
  2. npx claude-code-wechat-channel install (Generates .mcp.json configuration file).
  3. claude --dangerously-load-development-channels server:wechat (Starts Claude Code with the WeChat channel enabled).
• Prerequisites:
  • Node.js >= 18 or Bun >= 1.0
  • Claude Code >= 2.1.80
  • A claude.ai account or ANTHROPIC_API_KEY environment variable.
  • Latest version of WeChat for iOS (must support ClawBot).
• Setup: Requires scanning a QR code for authentication and generating a configuration file. Running the Claude Code server with the development channel flag is necessary.

Highlighted Details

• Leverages the official WeChat ClawBot ilink API, sharing the same protocol as @tencent-weixin/openclaw-weixin.
• Utilizes the MCP (Model Context Protocol) for extending Claude Code channels.
• Message handling via ilink/bot/getupdates and ilink/bot/sendmessage endpoints.

Maintenance & Community

Information regarding maintainers, community channels (like Discord/Slack), or a public roadmap is not detailed in the provided README.

Licensing & Compatibility

• License: MIT.
• Compatibility: The MIT license generally permits commercial use and linking with closed-source projects. However, the project is noted as being in a "research preview" stage.

Limitations & Caveats

This project is currently in a research preview stage and requires the --dangerously-load-development-channels flag to run, indicating potential instability or experimental features. The channel will disconnect if the Claude Code session is closed. WeChat ClawBot functionality is restricted to the latest iOS version, and each ClawBot instance can only connect to a single agent.