Gateways and sandboxes Private repository

feishu-botd

A local sidecar that speaks Feishu so your services don't have to.

feishu-botd is a small local gateway and agent runtime for Feishu/Lark bots. One process owns one or more apps, along with their credentials, token lifecycle, chat routing, and dynamic CardKit messages. Local services and agents talk to it over a protobuf/gRPC contract on a Unix socket, without handling raw chat ids. Agents can stream progressive card updates and receive normalized button callbacks.

The source isn't public yet. This page tracks what it does today.

What it does

  • Protobuf/gRPC contract over a Unix socket
  • Multi-app bot ownership
  • Progressive CardKit agent responses

Try it

  • cp config/feishu-botd.example.json config/feishu-botd.json
  • docker compose up -d --build
  • POST /v1/notify

Character

Delivers messages to the team chat Courier pigeon with a gRPC badge