Skip to content

Channels

Sidebar → Channels → New

Select the channel type and fill in the credentials, then assign agent + saver + memory. Every user/group chat is isolated automatically.

Supported Channels

TypeRequired fields
Lark / FeishuApp ID, App Secret
SlackBot Token (xoxb-...), App Token (xapp-...)
WeComBot ID, Secret
WeChatQR code login (credentials auto-populated)
DingTalkClient ID, Client Secret (AppKey / AppSecret, Stream mode)
QQApp ID, Client Secret (QQ Bot Open Platform, WebSocket Gateway)
OneBot (QQ)WS Host, WS Port, optional Access Token
XiaoAIMi account ID, Login credential, Speaker name

Lark / Feishu

  1. Create a bot app in the Feishu Developer Console (or the Lark Developer Console for international)
  2. Enable Bot capability
  3. Grant the following permissions under Permissions & Scopes (or use Batch Import with the JSON below):
PermissionDescription
im:message:send_as_botSend messages as bot
im:message.p2p_msg:readonlyReceive direct messages
im:message.group_at_msg:readonlyReceive group @bot messages
im:message.group_msgReceive all group messages
im:message:readonlyRead message content
im:chat:readonlyRead chat/group info
im:resourceRead files and images in messages
contact:user.base:readonlyRead basic user info
contact:contact.base:readonlyRead basic contact info
Batch import JSON
json
{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "im:chat:readonly",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": []
  }
}
  1. Under Events & Callbacks, set the subscription mode to Long Connection
  2. In Web UI → Channels, create a Lark channel and fill in App ID and App Secret

Supports event deduplication, interactive cards, per-user context isolation, and file/image send and receive.

Slack

  1. Create a Slack app at api.slack.com/apps
  2. Enable Socket Mode and generate an App-Level Token (xapp-...) with the connections:write scope
  3. Add bot scopes: chat:write, im:history, im:read, app_mentions:read, channels:history, groups:history, files:read
  4. Install the app to your workspace and copy the Bot User OAuth Token (xoxb-...)
  5. In Web UI → Channels, create a Slack channel and fill in both tokens

WeCom

  1. Create an AI app in the WeCom Admin Console and obtain the Bot ID and Secret
  2. In Web UI → Channels, create a WeCom channel and fill in Bot ID and Secret

Connects via WebSocket for real-time messaging, with file and image support.

WeChat

  1. In Web UI → Channels, create a WeChat channel
  2. Click QR login and scan the code with WeChat to authenticate
  3. Credentials are saved automatically once authenticated, and the channel goes live immediately

WeChat integration connects via the iLink Bot API, with file and image support.

DingTalk

  1. Create a bot app in the DingTalk Open Platform and obtain the Client ID and Client Secret (a.k.a. AppKey / AppSecret)
  2. Use Stream mode for the bot so no public callback URL is required
  3. In Web UI → Channels, create a DingTalk channel and fill in Client ID and Client Secret

QQ

The QQ channel connects an official bot from the QQ Bot Open Platform via its WebSocket Gateway.

  1. Create a bot on the QQ Bot Open Platform and obtain the App ID and Client Secret (AppSecret)
  2. In Web UI → Channels, create a QQ channel and fill in App ID and Client Secret

QQ vs OneBot

Use QQ for an official QQ bot via the open platform. Use OneBot below to bridge an unofficial QQ adapter (NapCat / Lagrange) over reverse WebSocket.

OneBot (QQ / Telegram bridges / etc.)

OneBot is the standard reverse-WS protocol used by NapCat, Lagrange, and other QQ adapters.

  1. In Web UI → Channels, create a OneBot channel and configure:
FieldDescriptionDefault
WS HostWebSocket server bind host0.0.0.0
WS PortWebSocket server port6700
Access TokenOptional token for authenticationempty
Require @mention in groupsOnly respond when @bot in group chatstrue
  1. Configure the OneBot client (NapCat / Lagrange / etc.) to connect via reverse WS to ws://<sbot-host>:<wsPort> with the same access token

XiaoAI

Talk to your XiaoAi smart speaker as a sbot channel.

  1. In Web UI → Channels, create a XiaoAI channel and fill in:
FieldDescription
小米 IDYour Mi account ID
登录方式passToken (recommended, obtained via sbox), or Mi account password
密码 / passTokenThe credential matching the selected login mode
登录设备 IDOptional PassportSDK deviceId, obtained via sbox
音箱名称Target speaker name (matches a device in your Mi account)
  1. The bot logs in to Mi Cloud, listens for voice messages on the device, and replies via TTS through the speaker

Getting passToken and deviceId with sbox

Mi accounts often reject server-side password login (risk control / 2FA), so the recommended path is to log in once with sbox — a desktop helper toolbox — and copy the credentials it extracts:

  1. Download sbox from the releases page and launch it.
  2. Open the XiaoAI Login tool and complete the Mi account login in the popup window.
  3. sbox lists your devices and shows the passToken and deviceId — copy them into the channel fields above.

Released under the MIT License.