微信 Channel 連携

微信を OpenClaw に接続し、双方向メッセージチャネルを実現します。

アーキテクチャ概要

┌─────────────┐     ┌──────────────────┐     ┌─────────────┐
│   微信用户   │ ←→  │  Wechaty Bridge  │ ←→  │  OpenClaw   │
│  (私聊/群聊) │     │  (PadLocal协议)   │     │   Gateway   │
└─────────────┘     └──────────────────┘     └─────────────┘
                           ↓
                    ┌──────────────────┐
                    │   消息格式转换    │
                    │   - 文本/图片/文件 │
                    │   - @提及检测     │
                    │   - 群聊/私聊路由  │
                    └──────────────────┘

核心コンポーネント

1. Wechaty Bridge (メッセージブリッジサービス)

独立して動作する Node.js サービスで、以下の役割を担います。

• 微信ログイン（QRコードスキャン）
• メッセージの送受信
• 連絡先/グループ管理
• OpenClaw Gateway との通信

2. OpenClaw Webhook レシーバー

Wechaty Bridge からのメッセージを受信し、AI Agent に転送します。

3. メッセージ送信 API

OpenClaw Agent は HTTP API を介して微信にメッセージを送信します。

クイックスタート

前提条件

• Node.js >= 18
• PadLocal Token（有料サービス、約 ¥200/月）
• OpenClaw Gateway が実行中であること

1. 依存関係のインストール

cd /home/aa/clawd/skills/wechat-channel
npm init -y
npm install wechaty wechaty-puppet-padlocal axios dotenv

2. 環境変数の設定

cp .env.example .env
# .env を編集して設定を記入

3. サービスの起動

node scripts/wechat-bridge.js
# ターミナルに表示される QR コードをスキャンしてログイン

設定説明

環境変数 (.env)

# PadLocal Token (必須)
# 取得方法: https://pad-local.com
PADLOCAL_TOKEN=YOUR_PADLOCAL_TOKEN

# OpenClaw Gateway 設定
OPENCLAW_GATEWAY_URL=http://127.0.0.1:18789
OPENCLAW_WEBHOOK_SECRET=your_webhook_secret

# 微信 Bot 設定
WECHAT_BOT_NAME=OpenClaw助手

# セキュリティ設定
# 許可するユーザー微信ID (カンマ区切り、空欄の場合はすべて許可)
ALLOWED_USERS=wxid_xxx,wxid_yyy
# 許可するグループID (カンマ区切り、空欄の場合はすべて許可)
ALLOWED_GROUPS=xxx@chatroom,yyy@chatroom

# グループチャットの挙動
# @メンションが必要な場合にのみグループメッセージに応答するか
REQUIRE_MENTION_IN_GROUP=true

# ログレベル
LOG_LEVEL=info

OpenClaw 設定 (openclaw.json)

{
  "channels": {
    "wechat": {
      "enabled": true,
      "webhookUrl": "http://localhost:3001/webhook",
      "webhookSecret": "your_webhook_secret",
      "dmPolicy": "allowlist",
      "allowFrom": ["wxid_xxx", "wxid_yyy"],
      "groups": {
        "xxx@chatroom": {
          "name": "工作群",
          "requireMention": true
        }
      }
    }
  }
}

メッセージ形式

受信メッセージ (Webhook Payload)

{
  "type": "message",
  "channel": "wechat",
  "messageId": "msg_123456",
  "from": {
    "id": "wxid_sender",
    "name": "张三",
    "alias": "zhangsan"
  },
  "chat": {
    "id": "wxid_sender",
    "type": "private"
  },
  "text": "你好，帮我查一下天气",
  "timestamp": 1706745600000,
  "mentions": [],
  "replyTo": null
}

グループチャットメッセージ

{
  "type": "message",
  "channel": "wechat",
  "messageId": "msg_789012",
  "from": {
    "id": "wxid_sender",
    "name": "张三"
  },
  "chat": {
    "id": "xxx@chatroom",
    "type": "group",
    "name": "工作群"
  },
  "text": "@OpenClaw助手 帮我总结一下今天的会议",
  "mentions": ["bot_wxid"],
  "isMentioned": true
}

送信メッセージ (API)

# テキストを送信
curl -X POST http://localhost:3001/api/send \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_SECRET" \
  -d '{
    "to": "wxid_receiver",
    "type": "text",
    "content": "收到，正在处理..."
  }'

# 画像を送信
curl -X POST http://localhost:3001/api/send \
  -H "Content-Type: application/json" \
  -d '{
    "to": "wxid_receiver",
    "type": "image",
    "url": "https://example.com/image.png"
  }'

# ファイルを送信
curl -X POST http://localhost:3001/api/send \
  -d '{
    "to": "wxid_receiver",
    "type": "file",
    "path": "/path/to/file.pdf",
    "filename": "report.pdf"
  }'

セキュリティポリシー

ダイレクトメッセージポリシー (dmPolicy)

グループチャットポリシー

使用例

1. パーソナルアシスタント

ユーザー: 明日の北京の天気を調べて
Bot: 明日の北京の天気：晴れ、気温 -5°C ~ 5°C、ダウンジャケットをお勧めします。

2. グループチャットアシスタント

ユーザー: @OpenClaw助手 今日の会議を要約して
Bot: 今日の議論のポイント：
1. プロジェクトの進捗を加速する必要がある
2. 来週水曜日までにデザインを完成させる
3. 金曜日にコードレビューを実施する

3. 自動通知

// OpenClaw Agent から通知を送信
await sendWechatMessage({
  to: 'xxx@chatroom',
  text: '⚠️ サーバーの CPU 使用率が 90% を超えています。確認してください！'
});

トラブルシューティング

ログインの問題

問題: QRコードをスキャンしてもログインできない 解決:

1. PadLocal Token が有効かどうかを確認します
2. 微信アカウントが制限されていないことを確認します
3. Token を再取得してみてください

メッセージの送受信の問題

問題: メッセージの送信に失敗する 解決:

1. ネットワーク接続を確認します
2. ターゲットのユーザー/グループ ID が正しいことを確認します
3. ログのエラーメッセージを確認します

接続の切断

問題: サービスがしばらくすると切断される 解決:

1. PM2 を使用してプロセスを管理し、自動的に再起動します
2. PadLocal サービスのステータスを確認します
3. ハートビート検出と再接続メカニズムを実装します

制限事項

PadLocal の制限

• 有料の Token が必要（約 ¥200/月）
• 1 つの Token でログインできる微信アカウントは 1 つのみ
• 微信のリスク管理の影響を受ける可能性があります

微信プラットフォームの制限

• 送信頻度の制限（1〜2秒の間隔を推奨）
• グループチャットの人数制限
• ファイルサイズの制限（約 100MB）
• ミニプログラムメッセージはサポートされていません

機能制限

• 音声メッセージのテキスト変換はサポートされていません（別途統合が必要）
• ビデオコンテンツはサポートされていません
• 紅包（お年玉）、送金などの機密機能は利用できません

関連ファイル

• scripts/wechat-bridge.js - メインサービスコード
• scripts/message-handler.js - メッセージ処理ロジック
• .env.example - 環境変数テンプレート
• references/wechaty-api.md - Wechaty API リファレンス

TODO

• [ ] PadLocal Token を取得する
• [ ] OpenClaw Webhook 受信を設定する
• [ ] ダイレクトメッセージの送受信をテストする
• [ ] グループチャットの @メンションをテストする
• [ ] セキュリティポリシーを設定する
• [ ] システムサービスとしてデプロイする
• [ ] 切断時の再接続を実装する
• [ ] メッセージキューを追加する（高並行シナリオ）