Skip to main content

CSGClaw: built-in Web UI / IM

← Back to CSGClaw overview

Open and load​

  • After csgclaw serve, open the URL from the terminal (often http://127.0.0.1:18080/).
  • The page is the built-in IM workspace; first load fetches the current user, user list, rooms (sessions), etc.

Sessions and members​

  • Create, switch, or manage sessions (rooms) and invite members as the current UI allows.
  • For automation, use the built-in IM APIs in API & config to create rooms, list, invite, delete, etc.

Messages and @mentions​

  • Send messages in a session; @handle in the body forms a mention for targeted notification.
  • History and live updates are pushed; the UI refreshes on events.

Add an agent to a session​

  • Call POST /api/v1/im/agents/join with agent_id, room_id, etc. (see API & config).

Feishu (optional)​

  • Configure channels.feishu in config.toml: set the human admin admin_open_id, and per-bot tables such as [channels.feishu.u-manager] with the Feishu app app_id and app_secret. Bot IDs follow conventions (u-manager is reserved; custom bots often u-{name}). Never expose app_secret publicly.
  • Feishu bot event stream: GET /api/v1/channels/feishu/bots/{id}/events (SSE) with Authorization: Bearer matching [server].access_token.

More HTTP and config detail: API & config.