Plugins de canal personnalisés

Vous pouvez étendre le système de canaux avec des adaptateurs de plateforme personnalisés conditionnés en tant qu’extensions. Cela vous permet de connecter Qwen Code à n’importe quelle plateforme de messagerie, webhook ou transport personnalisé.

Comment ça fonctionne

Les plugins de canal sont chargés au démarrage à partir des extensions actives. Lorsque qwen channel start s’exécute, il :

Analyse toutes les extensions activées pour les entrées channels dans leur qwen-extension.json
Importe dynamiquement le point d’entrée de chaque canal
Enregistre le type de canal pour qu’il puisse être référencé dans settings.json
Crée des instances de canal à l’aide de la fonction d’usine du plugin

Votre canal personnalisé bénéficie gratuitement de l’ensemble du pipeline partagé : filtrage des expéditeurs, politiques de groupe, routage de session, commandes slash, reprise après panne et le pont ACP vers l’agent.

Installation d’un canal personnalisé

Installez une extension qui fournit un plugin de canal :


# Depuis un chemin local (pour le développement ou les plugins privés)
qwen extensions install /path/to/my-channel-extension
 
# Ou liez-le pour le développement (les modifications sont reflétées immédiatement)
qwen extensions link /path/to/my-channel-extension

Configuration d’un canal personnalisé

Ajoutez une entrée de canal à ~/.qwen/settings.json en utilisant le type personnalisé fourni par l’extension :


{
  "channels": {
    "my-bot": {
      "type": "my-platform",
      "apiKey": "$MY_PLATFORM_API_KEY",
      "senderPolicy": "open",
      "cwd": "/path/to/project"
    }
  }
}

Le type doit correspondre à un type de canal enregistré par une extension installée. Consultez la documentation de l’extension pour connaître les champs spécifiques au plugin requis (par exemple, apiKey, webhookUrl).

Toutes les options de canal standard fonctionnent avec les canaux personnalisés :

Option	Description
`senderPolicy`	`allowlist`, `pairing`, ou `open`
`allowedUsers`	Liste d’autorisation statique des ID d’expéditeurs
`sessionScope`	`user`, `thread`, ou `single`
`cwd`	Répertoire de travail pour l’agent
`instructions`	Préfixé au premier message de chaque session
`model`	Remplacement de modèle pour le canal
`groupPolicy`	`disabled`, `allowlist`, ou `open`
`groups`	Paramètres par groupe

Voir Vue d’ensemble pour les détails de chaque option.

Démarrage du canal


# Démarre tous les canaux, y compris les personnalisés
qwen channel start
 
# Démarre uniquement votre canal personnalisé
qwen channel start my-bot

Ce que vous obtenez gratuitement

Les canaux personnalisés prennent automatiquement en charge tout ce que les canaux intégrés font :

Politiques d’expéditeur — contrôle d’accès allowlist, pairing et open
Politiques de groupe — Paramètres par groupe avec filtrage optionnel par @mention
Routage de session — Sessions par utilisateur, par fil de discussion ou partagées uniques
Appairage DM — Flux complet de code d’appairage pour les utilisateurs inconnus
Commandes slash — /help, /clear, /status fonctionnent immédiatement
Instructions personnalisées — Préfixé au premier message de chaque session
Reprise après panne — Redémarrage automatique avec conservation de la session
Sérialisation par session — Les messages sont mis en file d’attente pour éviter les conditions de concurrence

Construction de votre propre plugin de canal

Vous souhaitez créer un plugin de canal pour une nouvelle plateforme ? Consultez le Guide du développeur de plugins de canal pour l’interface ChannelPlugin, le format Envelope et les points d’extension.