WeCom (Enterprise WeChat)

Dieser Leitfaden behandelt die Einrichtung von Qwen Code mit einem intelligenten WeCom-Roboter (企业微信智能机器人).

Voraussetzungen

- Ein WeCom-Organisationskonto - Ein im API-Modus erstellter intelligenter WeCom-Roboter - Die Bot ID und das Secret des Roboters

Erstellen des Roboters

1. Öffne die WeCom-Admin-Konsole und erstelle einen intelligenten Roboter.

2. Wähle den API-Modus.

3. Kopiere die Bot ID und das Secret. 4. Füge den Roboter den Direktnachrichten oder Gruppen hinzu, in denen er verfügbar sein soll.

Der intelligente Roboter verwendet eine WebSocket-Verbindung von Qwen Code zu WeCom. Du benötigst keine öffentliche Callback-URL, keinen Token, keinen EncodingAESKey, keine Corp ID und keine Agent ID.

Konfiguration

Füge den Channel zu ~/.qwen/settings.json hinzu:

{
  "channels": {
    "my-wecom": {
      "type": "wecom",
      "botId": "$WECOM_BOT_ID",
      "secret": "$WECOM_SECRET",
      "senderPolicy": "allowlist",
      "allowedUsers": ["zhangsan"],
      "sessionScope": "user",
      "cwd": "/path/to/your/project",
      "instructions": "You are a concise coding assistant responding via WeCom.",
      "groupPolicy": "open"
    }
  }
}

Setze die Zugangsdaten als Umgebungsvariablen:

export WECOM_BOT_ID=<your-bot-id>
export WECOM_SECRET=<your-secret>

Oder definiere sie im env-Abschnitt von settings.json:

{
  "env": {
    "WECOM_BOT_ID": "your-bot-id",
    "WECOM_SECRET": "your-secret"
  }
}

Starten

qwen channel start my-wecom

Öffne WeCom und sende eine Nachricht an den intelligenten Roboter.

Zugriffskontrolle

senderPolicy funktioniert genauso wie bei anderen IM-Channels:

- allowlist: Nur Benutzer in allowedUsers können den Bot verwenden. Dies ist die empfohlene Standardeinstellung für Unternehmen. - pairing: Benutzer müssen sich koppeln, bevor sie den Bot verwenden können. - open: Jeder, der dem Roboter Nachrichten senden kann, kann ihn verwenden.

Für Gruppen setze groupPolicy auf "allowlist", "pairing" oder "open". Unter "pairing" erzeugt die erste Erwähnung der Gruppe eine Pairing-Anfrage, die einmalig genehmigt werden muss, bevor Antworten gestartet werden. Beachte, dass unter groupPolicy: "pairing" der Zugriff pro Gruppe erteilt wird: Sobald eine Gruppe genehmigt ist, kann jedes Mitglied dieser Gruppe den Bot verwenden; senderPolicy und allowedUsers beschränken nicht die Mitglieder einer genehmigten Gruppe. WeCom stellt nur Gruppennachrichten zu, die den intelligenten Roboter erwähnen, daher wird jeder zugestellte Gruppen-Callback als erwähnt behandelt. Die requireMention-Einstellung kann keine Antworten auf nicht erwähnte Gruppennachrichten aktivieren, da diese Nachrichten nicht an den Bot zugestellt werden.

Group Mention Compatibility

Frühere Qwen Code-Versionen haben nach der WeCom-Zustellung eines Gruppen-Callbacks zusätzlich das generische requireMention-Gate angewendet. Da der Callback keine separaten Erwähnungs-Metadaten enthält, konnte requireMention: true – einschließlich des Standardwerts – jede zugestellte Gruppennachricht ablehnen und den Gruppenchat nicht funktionsfähig erscheinen lassen.

Qwen Code verlässt sich jetzt auf die WeCom-seitige erwähnungsbezogene Zustellung und wendet keine zweite Erwähnungsentscheidung an. Bestehende WeCom-Konfigurationen, die entweder requireMention: true oder requireMention: false enthalten, bleiben gültig und erzeugen keine Konfigurationsfehler. Beide Werte haben dasselbe Verhalten für WeCom, das Feld kann also entfernt werden. Andere Einstellungen im selben Gruppeneintrag, wie dispatchMode, gelten weiterhin. groupHistoryLimit wird weiterhin akzeptiert, kann aber keine neue WeCom-Historie sammeln, da nicht erwähnte Gruppennachrichten nicht zugestellt werden.

Bilder und Dateien

Benutzer können Text, Sprachnachrichten mit Transkription, Bilder, gemischte Text- und Bildnachrichten, Dateien und Videos senden. Bilder werden dem Agenten als Bildanhänge übergeben. Dateien und Videos werden in temporäre lokale Pfade heruntergeladen, damit der Agent sie mit Datei-Tools lesen kann.

Antworten des Assistenten werden als WeCom-Markdown gesendet. Um ein vom Agenten generiertes lokales Bild zu senden, füge einen Marker außerhalb von Codeblöcken ein:

[IMAGE: /absolute/path/to/image.png]

Aus Sicherheitsgründen müssen lokale Bildpfade innerhalb des Channel-Dateiverzeichnisses unter dem temporären Systemverzeichnis liegen, wie z. B. /tmp/channel-files/... unter Linux. Generische Marker für Datei-, Video- und Sprach-Uploads werden ignoriert, da sonst vom Modell erzeugte Dateipfade beliebige Workspace-Dateien hochladen könnten.

Fehlerbehebung

Bot stellt keine Verbindung her

- Überprüfe die Bot ID und das Secret. - Stelle sicher, dass der Roboter im API-Modus erstellt wurde. - Überprüfe, ob die Umgebungsvariablen in der Shell verfügbar sind, die qwen channel start ausführt.

Bot antwortet nicht in Gruppen

- Überprüfe groupPolicy. - Erwähne den Bot in der Gruppe. - Stelle sicher, dass der Roboter der Gruppe hinzugefügt wurde.

Zugangsdaten für selbst erstellte Anwendungen funktionieren nicht

Dieser Channel ist für intelligente WeCom-Roboter gedacht. Callback-Zugangsdaten für selbst erstellte Anwendungen wie Corp ID, Agent ID, Token und EncodingAESKey werden von diesem Channel nicht verwendet.