Channels Guide

Guide Research-Claw IM channel configuration and troubleshooting across seven messaging platforms.

850|114|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/wentorai/Research-Claw --skill channels-guide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Channels Guide
Source: https://github.com/wentorai/Research-Claw/tree/main/skills/channels-guide
Command: npx skills add https://github.com/wentorai/Research-Claw --skill channels-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This Skill helps you configure, connect, and troubleshoot Research-Claw’s messaging (IM) channels when tokens, QR login, plugins, or gateway restarts cause failures.

Core Features & Use Cases

  • Channel onboarding and configuration for Telegram, Discord, WeChat (微信), Feishu (飞书), QQ, Slack, and WhatsApp, including bot-token setup and WeChat/WhatsApp QR login paths.
  • Reliable restart and lifecycle behavior guidance for how config.patch triggers gateway restart, what to expect during drains, and how dashboard reconnects.
  • Fast diagnostics for common errors such as 401 Unauthorized loops, missing plugin registration (plugins.allow / plugins.load.paths), invalid credentials, provider not running, and native module ABI issues.
  • Use Case: When your channel shows “not configured” or repeatedly crashes after startup, follow the steps to verify tokens/credentials, ensure plugin sync across config and dashboard, and restore the channel to a working state.

Quick Start

Ask an assistant to walk you through configuring your specific channel in Research-Claw by using the Channels tab flow (or the IM-only QR/login tool) and then applying the correct config patch so the gateway restarts cleanly.

Frequently Asked Questions about Channels Guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix a 401 Unauthorized error on my Telegram or Discord bot token?

To fix a 401 Unauthorized error on your Telegram or Discord bot token, verify the token credentials are correctly entered, ensure the provider is running, and apply the correct config patch so the gateway restarts cleanly and establishes a valid connection.

Why does my IM channel show not configured or crash after gateway restart?

IM channels show not configured or crash after a gateway restart when plugin registration fails. Check plugins.allow and plugins.load.paths settings, verify config patch expectations, and ensure plugin sync across the dashboard to restore the channel to a working state.

How do I set up WeChat QR login for my messaging channel?

To set up WeChat QR login, use the IM-only QR login tool to scan the authentication code, complete the login flow, and apply the resulting configuration patch so the gateway recognizes the WeChat channel and connects properly.

What is the correct config patch behavior for gateway restarts and drains?

Config patch behavior for gateway restarts involves triggering a drain process where active connections pause, the gateway reloads the updated configuration, and the dashboard automatically reconnects once the restart cycle completes successfully.

Can I configure Feishu, QQ, Slack, and WhatsApp channels using the same process?

Yes, you can configure Feishu, QQ, Slack, and WhatsApp channels using the same process, applying channel-specific bot token setup or QR login paths and verifying plugin sync to ensure each provider connects without native module ABI issues.

How do I enable, disable, or delete an IM channel configuration?

To enable, disable, or delete an IM channel configuration, navigate to the Channels tab flow, select the target channel, apply the desired operational state change, and verify that the config patch triggers a clean gateway restart to finalize the action.