Skip to content
AstrBot
Main Navigation HomeBlogRoadmapHTTP API

English

简体中文

English

简体中文

Toggle dark mode

Intro & DeployMessaging PlatformsAI IntegrationUsageDevelopment
Sidebar Navigation

Introduction

What is AstrBot

Community

FAQ

Deployment

Package Manager

One-click Launcher

Docker

Kubernetes

BT Panel

1Panel

Manual

Other Deployments

CasaOS

Compshare GPU

Community-provided Deployment

Support Us

Messaging Platforms

Quick Start

QQ Official Bot

Webhook Method

Websockets Method

WeCom Application

WeCom AI Bot

WeChat Official Account

Lark

DingTalk

Telegram

LINE

Slack

Misskey

Discord

OneBot v11

NapCat

Lagrange

Other Clients

Satori

Using LLOneBot

Using server-satori

Community-provided

Matrix

KOOK

VoceChat

AI Integration

✨ Model Providers

NewAPI

AIHubMix

PPIO Cloud

SiliconFlow

TokenPony

302.AI

Ollama

LMStudio

⚙️ Agent Runners

Built-in Agent Runner

Dify

Coze

Alibaba Bailian

Usage

WebUI

Plugins

Built-in Commands

Tool Use

Anthropic Skills

SubAgent Orchestration

Proactive Tasks

MCP

Web Search

Knowledge Base

Custom Rules

Agent Runner

Unified Webhook Mode

Auto Context Compression

Agent Sandbox

Development

Plugin Development

🌠 Getting Started

Minimal Example

Listen to Message Events

Send Messages

Plugin Configuration

AI

Storage

HTML to Image

Session Control

Publish Plugin

Platform Adapter Integration

AstrBot HTTP API

AstrBot Configuration File

Others

Self-hosted HTML to Image

Open Source Summer

OSPP 2025

On this page

Connect to Lagrange ​

TIP

  • Please control message frequency responsibly. Sending messages too frequently may trigger risk control.
  • This project must not be used for illegal purposes.
  • For the latest deployment steps, always refer to the official Lagrange Docs.

Download ​

Download the latest Lagrange.OneBot from GitHub Releases.

  • Windows: Lagrange.OneBot_win-x64_xxxx
  • Linux x86_64: Lagrange.OneBot_linux-x64_xxx
  • Linux ARM64: Lagrange.OneBot_linux-arm64_xxx
  • macOS Apple Silicon: Lagrange.OneBot_osx-arm64_xxx
  • macOS Intel: Lagrange.OneBot_osx-x64_xxx

Deploy ​

Follow the official docs:

  • Run guide: https://lagrangedev.github.io/Lagrange.Doc/Lagrange.OneBot/Config/#运行
  • Config file guide: https://lagrangedev.github.io/Lagrange.Doc/Lagrange.OneBot/Config/#配置文件

In your config file, add this under Implementations:

json
{
  "Type": "ReverseWebSocket",
  "Host": "127.0.0.1",
  "Port": 6199,
  "Suffix": "/ws",
  "ReconnectInterval": 5000,
  "HeartBeatInterval": 5000,
  "AccessToken": ""
}

Make sure Suffix is exactly /ws.

Connect to AstrBot ​

Configure aiocqhttp Adapter ​

  1. Open AstrBot Dashboard.
  2. Click Bots in the left sidebar.
  3. Click + Create Bot.
  4. Select aiocqhttp (OneBot v11).

Fill in:

  • ID (id): any unique identifier.
  • Enable (enable): checked.
  • Reverse WebSocket host: your machine IP (usually 0.0.0.0).
  • Reverse WebSocket port: an available port, for example 6199.
Edit this page on GitHub

Last updated:

Pager
PreviousNapCat
NextOther Clients

Deployed on Rainyun Logo