1. Create a bot

• Open Telegram, search
  @BotFather
• Send
  /newbot
  , follow prompts
• Copy the token

2. Configure

You can find your User ID in Telegram settings. It is shown as

@yourUserId

. Copy this value without the

@

symbol and paste it into the config file.

3. Run

Uses Socket.IO WebSocket by default, with HTTP polling fallback.

1. Ask nanobot to set up Mochat for you

Simply send this message to nanobot (replace

Read https://raw.githubusercontent.com/HKUDS/MoChat/refs/heads/main/skills/nanobot/skill.md and register on MoChat. My Email account is xxx@xxx Bind me as your owner and DM me on MoChat.

nanobot will automatically register, configure

2. Restart gateway

That's it — nanobot handles the rest!

1. Create a bot

• Go to https://discord.com/developers/applications
• Create an application → Bot → Add Bot
• Copy the bot token

2. Enable intents

• In the Bot settings, enable MESSAGE CONTENT INTENT
• (Optional) Enable SERVER MEMBERS INTENT if you plan to use allow lists based on member data

3. Get your User ID

• Discord Settings → Advanced → enable Developer Mode
• Right-click your avatar → Copy User ID

4. Configure

5. Invite the bot

• OAuth2 → URL Generator
• Scopes:
  bot
• Bot Permissions:
  Send Messages
  ,
  Read Message History
• Open the generated invite URL and add the bot to your server

6. Run

Requires Node.js ≥18.

1. Link device

2. Configure

3. Run (two terminals)

Uses WebSocket long connection — no public IP required.

1. Create a Feishu bot

• Visit Feishu Open Platform
• Create a new app → Enable Bot capability
• Permissions: Add
  im:message
  (send messages)
• Events: Add
  im.message.receive_v1
  (receive messages)
  • Select Long Connection mode (requires running nanobot first to establish connection)
• Get App ID and App Secret from "Credentials & Basic Info"
• Publish the app

2. Configure

encryptKey

and

verificationToken

are optional for Long Connection mode.

allowFrom

: Leave empty to allow all users, or add

["ou_xxx"]

to restrict access.

3. Run

Tip

Feishu uses WebSocket to receive messages — no webhook or public IP needed!

Uses botpy SDK with WebSocket — no public IP required. Currently supports private messages only.

1. Register & create bot

• Visit QQ Open Platform → Register as a developer (personal or enterprise)
• Create a new bot application
• Go to 开发设置 (Developer Settings) → copy AppID and AppSecret

2. Set up sandbox for testing

• In the bot management console, find 沙箱配置 (Sandbox Config)
• Under 在消息列表配置, click 添加成员 and add your own QQ number
• Once added, scan the bot's QR code with mobile QQ → open the bot profile → tap "发消息" to start chatting

3. Configure

• allowFrom
  : Leave empty for public access, or add user openids to restrict. You can find openids in the nanobot logs when a user messages the bot.
• For production: submit a review in the bot console and publish. See QQ Bot Docs for the full publishing flow.

4. Run

Now send a message to the bot from QQ — it should respond!

Uses Stream Mode — no public IP required.

1. Create a DingTalk bot

• Visit DingTalk Open Platform
• Create a new app -> Add Robot capability
• Configuration:
  • Toggle Stream Mode ON
• Permissions: Add necessary permissions for sending messages
• Get AppKey (Client ID) and AppSecret (Client Secret) from "Credentials"
• Publish the app

2. Configure

allowFrom

: Leave empty to allow all users, or add

["staffId"]

to restrict access.

3. Run

Uses Socket Mode — no public URL required.

1. Create a Slack app

• Go to Slack API → Create New App → "From scratch"
• Pick a name and select your workspace

2. Configure the app

• Socket Mode: Toggle ON → Generate an App-Level Token with
  connections:write
  scope → copy it (
  xapp-...
  )
• OAuth & Permissions: Add bot scopes:
  chat:write
  ,
  reactions:write
  ,
  app_mentions:read
• Event Subscriptions: Toggle ON → Subscribe to bot events:
  message.im
  ,
  message.channels
  ,
  app_mention
  → Save Changes
• App Home: Scroll to Show Tabs → Enable Messages Tab → Check "Allow users to send Slash commands and messages from the messages tab"
• Install App: Click Install to Workspace → Authorize → copy the Bot Token (
  xoxb-...
  )

3. Configure nanobot

4. Run

DM the bot directly or @mention it in a channel — it should respond!

Tip

• groupPolicy
  :
  "mention"
  (default — respond only when @mentioned),
  "open"
  (respond to all channel messages), or
  "allowlist"
  (restrict to specific channels).
• DM policy defaults to open. Set
  "dm": {"enabled": false}
  to disable DMs.

Give nanobot its own email account. It polls IMAP for incoming mail and replies via SMTP — like a personal email assistant.

1. Get credentials (Gmail example)

• Create a dedicated Gmail account for your bot (e.g.
  my-nanobot@gmail.com
  )
• Enable 2-Step Verification → Create an App Password
• Use this app password for both IMAP and SMTP

2. Configure

• consentGranted
  must be
  true
  to allow mailbox access. This is a safety gate — set
  false
  to fully disable.
• allowFrom
  : Leave empty to accept emails from anyone, or restrict to specific senders.
• smtpUseTls
  and
  smtpUseSsl
  default to
  true
  /
  false
  respectively, which is correct for Gmail (port 587 + STARTTLS). No need to set them explicitly.
• Set
  "autoReplyEnabled": false
  if you only want to read/analyze emails without sending automatic replies.

3. Run

nanobot uses a Provider Registry (

Step 1. Add a

Step 2. Add a field to

That's it! Environment variables, model prefixing, config matching, and

Common