メインコンテンツへスキップ
個人の WeChat に接続します。QR コードをスキャンするだけでログインでき、パブリック IP は不要です。テキスト、画像、音声、ファイル、動画メッセージの送受信に対応しています。

1. 設定

方法 A: Web コンソール

プログラムを起動し、Web コンソール(ローカルアクセス: http://127.0.0.1:9899)を開きます。**チャネル**タブに移動し、**チャネルを接続**をクリックして WeChat を選択し、プロンプトに従って QR コードをスキャンしてください。

方法 B: 設定ファイル

config.jsonchannel_typeweixin に設定します:
{
  "channel_type": "weixin"
}
プログラム起動後、ターミナルに QR コードが表示されます。WeChat でスキャンし、スマートフォンで確認してログインを完了してください。
後方互換性のため、channel_typewx に設定しても WeChat チャネルが有効になります。

2. パラメータ

パラメータ説明デフォルト
channel_typeweixin または wx を指定
ログイン認証情報は ~/.weixin_cow_credentials.json に自動保存されます。再ログインするには、このファイルを削除してプログラムを再起動してください。

3. ログイン

QR コードログイン

初回起動時に、ターミナルに QR コードが表示されます(有効期限は約 2 分)。WeChat でスキャンし、スマートフォンで確認してください。
  • QR コードが期限切れになると自動的に更新・再表示されます
  • qrcode 依存関係は requirements.txt にデフォルトで含まれており、ターミナルに直接 QR コードを表示できます

認証情報の永続化

ログイン成功後、認証情報は ~/.weixin_cow_credentials.json に保存されます。次回起動時は保存された認証情報が再利用され、再スキャンは不要です。 再ログインするには、認証情報ファイルを削除してプログラムを再起動してください。

セッションの期限切れ

WeChat セッションが期限切れになった場合(errcode -14)、プログラムは自動的に古い認証情報をクリアし、新しい QR ログインを開始します。手動での操作は不要です。

4. 対応機能

機能状態
ダイレクトメッセージ
テキストメッセージ✅ 送受信
画像メッセージ✅ 送受信
ファイルメッセージ✅ 送受信
動画メッセージ✅ 送受信
音声メッセージ✅ 受信

5. 注意事項

  1. ilinkai.weixin.qq.com へのネットワークアクセスが必要です。
  2. メディアファイル(画像、ファイル、動画)は CDN 経由で AES-128-ECB 暗号化を使用して転送され、プログラムが自動的に処理します。
  3. 頻繁な切断による再スキャンを避けるため、安定したネットワーク環境での実行を推奨します。