@liangrk/claude-code-wechatbot 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+# Claude Code WeChat Channel
+
+将微信消息桥接到 Claude Code 会话的 Channel 插件。
+
+基于微信官方 ClawBot ilink API（与 `@tencent-weixin/openclaw-weixin` 使用相同协议），让你在微信中直接与 Claude Code 对话。
+
+## 工作原理
+
+```
+微信 (iOS) → WeChat ClawBot → ilink API → [本插件] → Claude Code Session
+                                                  ↕
+Claude Code ← MCP Channel Protocol ← wechat_reply tool
+```
+
+## 前置要求
+
+- [Node.js](https://nodejs.org) >= 18（或 [Bun](https://bun.sh) >= 1.0）
+- [Claude Code](https://claude.com/claude-code) >= 2.1.80
+- claude.ai 账号登录或 API key（`ANTHROPIC_API_KEY`）
+- 微信 iOS 最新版（需支持 ClawBot 插件）
+
+## 快速开始
+
+### 1. 微信扫码登录
+
+```bash
+npx claude-code-wechat-channel setup
+```
+
+终端会显示二维码，用微信扫描并确认。凭据保存到 `~/.claude/channels/wechat/account.json`。
+
+### 2. 生成 MCP 配置
+
+```bash
+npx claude-code-wechat-channel install
+```
+
+这会在当前目录生成（或更新） `.mcp.json`，指向本插件。
+
+### 3. 启动 Claude Code + WeChat 通道
+
+```bash
+claude --dangerously-load-development-channels server:wechat
+```
+
+### 4. 在微信中发消息
+
+打开微信，找到 ClawBot 对话，发送消息。消息会出现在 Claude Code 终端中，Claude 的回复会自动发回微信。
+
+## 命令说明
+
+| 命令 | 说明 |
+|------|------|
+| `npx claude-code-wechat-channel setup` | 微信扫码登录 |
+| `npx claude-code-wechat-channel install` | 生成 .mcp.json 配置 |
+| `npx claude-code-wechat-channel start` | 启动 MCP Channel 服务器 |
+| `npx claude-code-wechat-channel help` | 显示帮助 |
+
+## 技术细节
+
+- **消息接收**: 通过 `ilink/bot/getupdates` 长轮询获取微信消息
+- **消息发送**: 通过 `ilink/bot/sendmessage` 发送回复
+- **认证**: 使用 `ilink/bot/get_bot_qrcode` QR 码登录获取 Bearer Token
+- **协议**: 基于 MCP (Model Context Protocol) 的 Channel 扩展
+
+## 注意事项
+
+- 当前为 research preview 阶段，需要使用 `--dangerously-load-development-channels` 标志
+- Claude Code 会话关闭后通道也会断开
+- 微信 ClawBot 目前仅支持 iOS 最新版
+- 每个 ClawBot 只能连接一个 agent 实例
+
+## License
+
+MIT

package/cli.mjs

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+
+/**
+ * Claude Code WeChat Channel — CLI entry point
+ *
+ * Usage:
+ *   npx claude-code-wechat-channel setup   — WeChat QR login
+ *   npx claude-code-wechat-channel start   — Start channel server (used by .mcp.json)
+ *   npx claude-code-wechat-channel install — Write .mcp.json to current directory
+ */
+
+import { execSync, spawnSync } from "node:child_process";
+import { existsSync, writeFileSync, readFileSync, renameSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const DIST_DIR = resolve(__dirname, "dist");
+
+function getBunPath() {
+  try {
+    return execSync("which bun", { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+  } catch {
+    return null;
+  }
+}
+
+function getNodePath() {
+  return process.execPath;
+}
+
+function runScript(script, args = []) {
+  const scriptPath = resolve(DIST_DIR, script);
+  if (!existsSync(scriptPath)) {
+    console.error(`Error: ${scriptPath} not found. Package may be corrupted.`);
+    process.exit(1);
+  }
+
+  // Prefer bun for performance, fall back to node
+  const bun = getBunPath();
+  const runtime = bun || getNodePath();
+  const result = spawnSync(runtime, [scriptPath, ...args], {
+    stdio: "inherit",
+    env: process.env,
+  });
+  process.exit(result.status ?? 1);
+}
+
+function install() {
+  const mcpConfig = {
+    mcpServers: {
+      wechat: {
+        command: "npx",
+        args: ["-y", "@liangrk/claude-code-wechatbot", "start"],
+      },
+    },
+  };
+
+  const mcpPath = resolve(process.cwd(), ".mcp.json");
+  const tmpPath = mcpPath + ".tmp";
+
+  function atomicWrite(filePath, content) {
+    writeFileSync(tmpPath, content, "utf-8");
+    renameSync(tmpPath, filePath);
+  }
+
+  if (existsSync(mcpPath)) {
+    try {
+      const existing = JSON.parse(readFileSync(mcpPath, "utf-8"));
+      existing.mcpServers = existing.mcpServers || {};
+      existing.mcpServers.wechat = mcpConfig.mcpServers.wechat;
+      atomicWrite(mcpPath, JSON.stringify(existing, null, 2) + "\n");
+      console.log(`Updated: ${mcpPath}`);
+    } catch (err) {
+      console.error(`Warning: Failed to update existing .mcp.json: ${err}`);
+      atomicWrite(mcpPath, JSON.stringify(mcpConfig, null, 2) + "\n");
+      console.log(`Created: ${mcpPath}`);
+    }
+  } else {
+    atomicWrite(mcpPath, JSON.stringify(mcpConfig, null, 2) + "\n");
+    console.log(`Created: ${mcpPath}`);
+  }
+
+  console.log(`
+Next steps:
+  1. Run: npx claude-code-wechat-channel setup
+  2. Then: claude --dangerously-load-development-channels server:wechat
+`);
+}
+
+function help() {
+  console.log(`
+  Claude Code WeChat Channel
+
+  Usage: npx claude-code-wechat-channel <command>
+
+  Commands:
+    setup     WeChat QR login (scan to authenticate)
+    start     Start the channel MCP server
+    install   Write .mcp.json to current directory
+    help      Show this help message
+`);
+}
+
+const command = process.argv[2];
+
+switch (command) {
+  case "setup":
+    runScript("setup.js");
+    break;
+  case "start":
+    runScript("wechat-channel.js");
+    break;
+  case "install":
+    install();
+    break;
+  case "help":
+  case "--help":
+  case "-h":
+    help();
+    break;
+  default:
+    if (command) {
+      console.error(`Unknown command: ${command}`);
+    }
+    help();
+    process.exit(command ? 1 : 0);
+}