WecomTeam/wecom-openclaw-plugin

OpenClaw 的官方企业微信插件,由企业微信团队开发和维护。它将你的 OpenClaw Agent 无缝对接到企业微信工作流,集成文档、智能表格、日历能力。

WeCom OpenClaw プラグイン – 速報

何であるかOpenClaw AIエージェントフレームワークが WeCom(騰訊のエンタープライズWeChat)と通信できる最初の公式チャネルプラグインです。WeComユーザーとの通信を2通り提供します:

モード 接続方法 一般的な用途
Bot WebSocketの長時間ポーリング または HTTP Webhook(JSON) 高速でストリーミング返信、設定が簡単。
Agent HTTP Webhookコールバック(XML、AES-256-CBC暗号化) 企業向け、API駆動型のメッセージ送信。

このプラグインには、数十のWeComビジネスAPI(メッセージ、メール、ドキュメント、スプレッドシート、カレンダー、会議、ファイルストレージ、連絡先など)を「スキル」としてAIが呼び出せるようにする、wecom-cli コマンドラインツールも同梱されています。


主な機能(READMEに記載)

  • 二重モード動作 – BotとAgentは並行して動作可能。出力メッセージにはBotが優先され、WebSocketがダウンした場合はAgentにフォールバック。
  • メッセージ形式 – テキスト、Markdown、画像、動画、音声、ファイル、および「图文混排」の混合メッセージに対応。音声メッセージは自動的に文字起こし。
  • プロアクティブメッセージ – ユーザーの入力待ちではなく、特定のユーザー、グループ、部署、タグにメッセージをプッシュ可能。
  • ストリーミング返信 – LLMが思考中の間、「思考中」のプレースホルダーメッセージを送信可能(Botモードのみ)。
  • アクセス制御 – ダイレクトメッセージ(ペアリング、オープン、許可リスト、無効化)とグループチャットの細かいポリシー、アカウントごとのコマンド権限。
  • 複数アカウント対応 – 1つのOpenClawゲートウェイで複数のWeComアカウントを運用可能。各アカウントに独自のBot/Agent設定。
  • 動的エージェント – セッション分離のため、ユーザーまたはグループごとにオプションで独立したエージェントを設定可能。
  • メディア処理 – 入力メディアの自動ダウンロード、サイズ制限(画像・動画:10MB、音声:2MB)、制限を超えた場合は自動的にファイル形式に変換。
  • 組み込みビジネススキルwecom-cli で以下のコマンドが利用可能:
    • メッセージ、メール、ドキュメント・スプレッドシートのCRUD
    • スマートシート・スマートドキュメント管理
    • Todo、カレンダー、会議スケジューリング、議事録・会議記録
    • WeDriveファイル検索/アップロード/ダウンロード
    • 連絡先検索
  • CLIウィザードopenclaw channels add または @wecom/wecom-openclaw-cli install で、Bot ID/Secretの入力と設定をガイド付きで実行可能。
  • 堅牢なネットワーク – ハートビート、再接続ロジック、キック防止、オプションのエグレッションプロキシ。

セットアップ手順(READMEより)

  1. 前提条件 – OpenClaw ≥ 2026.3.28。
  2. インストール – 1行で実行可能:
    npx -y @wecom/wecom-openclaw-cli install   # 必要に応じて --force を追加
    
  3. 設定openclaw channels add(インタラクティブ)を実行するか、直接キーを設定。例:
    openclaw config set channels.wecom.botId <BOT_ID>
    openclaw config set channels.wecom.secret <BOT_SECRET>
    openclaw config set channels.wecom.enabled true
    openclaw gateway restart
    
  4. ビジネスツールの有効化tools.alsoAllow にプラグインIDを追加し、ゲートウェイを再起動。
  5. モード選択 – デフォルトのWebSocketによるBotモード、またはCorpID/Secret、AgentId、Token、EncodingAESKeyを設定し、WeCom管理コンソールでコールバックURLを登録してAgentモードを選択。

どんな人が使うべきか?

  • 既にOpenClawベースのAIアシスタントを運用している企業で、それらをWeComチャット内に表示させたい人。
  • プロアクティブ通知、リッチメディア処理、WeComのドキュメント・カレンダー・会議APIを呼び出したい開発者
  • クロンで定期的に部署やタグにブロードキャストを送信したい運用チーム

制限事項と注意点(ドキュメントより)

  • BotモードにはBot IDSecretが必要。Agentモードには企業アプリ(CorpID/Secret)とXML暗号化コールバックが必要。
  • 制限サイズを超えるメディアはファイルとして送信されるか、拒否される。
  • Agent専用アカウントを使用する場合、WeComコンソールにコールバックURLを保存する前にAgentを設定しておく必要がある(WeComはURLを即座に検証する)。
  • プラグインバージョンはOpenClawバージョンと一致している必要がある(例:OpenClaw 2026.3.22 → プラグイン 2026.3.20;新しいOpenClaw → プラグイン 2026.3.24+)。

まとめ(TL;DR)

WeCom OpenClaw プラグインは、生産環境対応のブリッジで、OpenClaw AIエージェントが騰訊のエンタープライズWeChatと通信できるようにし、リッチメディア、プロアクティブメッセージ、WeComビジネスAPIのフルセットを便利なCLI経由で利用可能。WebSocket(Bot)または暗号化XML Webhook(Agent)モードで動作し、複数アカウントに対応。アクセスポリシー、モード間の自動フォールバックなど、安全機能も搭載。

関連

  • プロジェクト
  • Dispatch
  • プロジェクト
  • プロジェクト