Skip to main content

3.14.1 Connect Feishu

The Feishu channel connects Moss to an enterprise Feishu bot. Team members can:

  • @ the bot in a Feishu group so Moss checks status, analyzes logs, or triggers on-device tasks you have already approved
  • Chat 1:1 with Moss in direct messages
  • See Moss replies and key actions in Feishu for easier tracking

Configuration fields

In Settings center → Message channels · Feishu, set:

Settings center · Message channels · Feishu: channel status, everyday usage, app credentials, and connection mode

FieldRequiredWhere to get it
App IDYesFeishu developer console → your app → Credentials & basic info
App secretYesSame as above
Encryption keyNoFeishu console → Event subscription
Verification tokenNoSame as above

App ID and app secret identify your Feishu custom app. The encryption key and verification token tighten event verification; fill them according to the Feishu console.

Create a Feishu custom app

If your team does not have a custom app yet:

  1. Open the Feishu developer console
  2. Create a new custom app and set name, icon, and description
  3. Under Permission management, enable required permissions: read messages, send messages, group info, etc.
  4. Under Event subscription, subscribe to “receive messages” and set the callback URL
  5. Under Version release, submit the app and wait for enterprise admin approval
  6. After approval, obtain the app ID and app secret

For full steps, refer to Feishu Open Platform official documentation.

Direct message access modes

ModeBehaviorWhen to use
AllowlistOnly listed Feishu users can DM the botStrongly recommended in production
ApprovalAnyone can send a message; an admin approves once before continued useInternal teams that want light control
OpenAnyone who can see the bot can use itTesting or when there is clearly no sensitive operation

Use allowlist mode in production. Open mode means anyone who sees the bot may trigger Moss to act on devices—high risk.

User management

ActionWhere
View bound usersFeishu → User management
Approve pending pairingFeishu → Pending approval
Remove a userUser management → select user → Remove
Start / stop the whole Feishu channelFeishu → Channel switch

What the bot can do in Feishu

The Feishu bot capabilities are nearly the same as AI Dock:

  • Device status: “Show BPU usage on RDK-X5-workstation1”
  • Files: “Send me /tmp/log.txt” (bot sends the file as an attachment to Feishu)
  • Commands: “Restart ROS node camera_publisher”
  • Use loaded related skills

For high‑risk commands, file writes, or tasks that might change device state, the bot will ask you to confirm again in Feishu. Because Feishu is external, confirmation is stricter than inside Studio.