Skip to content

Kook Adapter

The Kook adapter supports connecting to onebots service through Kook Open Platform API.

Status

Implemented and Available

Features

  • ✅ Channel Messages
  • ✅ Private Chat Messages
  • ✅ Server Management
  • ✅ Member Management
  • ✅ Rich Text Messages
  • ✅ Card Messages

Installation

Open Extensions in the Web console and select the adapter, or run:

bash
onebots ui --data-dir <workspace> --setup

The manager installs the adapter and its required peer dependencies into a verified immutable runtime generation. Do not run package-manager install commands directly in the OneBots runtime directory.

Configuration Example

yaml
kook.my_bot:
  # Protocol configuration
  onebot.v11:
    use_http: true
    use_ws: true
    access_token: 'your_token'
  
  # Kook platform configuration
  token: 'your_kook_bot_token'

Client SDK Usage

Connect the client to the complete account protocol root, for example http://localhost:6727/kook/{account_id}/onebot/v12. See the Client SDK Guide for Client creation, receive modes, existing-Host integration, and API calls.