lsbot

April 16, 2026 · View on GitHub

English | 中文

lsbot — Lean & Secure Bot

Lean. Secure. Yours.

lsbot — Lean & Secure Bot

Go Version License Website CN Mirror

lsbot is a lean, secure AI Bot — single static binary, zero dependencies, end-to-end encrypted by default. Your data stays on your machine.

📖 Docs: lsbot.org/docs | China Mainland mirror: lsbot.net

Core Advantages:

  • End-to-End Encrypted — E2EE on by default (P-256 ECDH + AES-256-GCM), out-of-band key verification
  • Single Static Binary — ~15MB, no Node.js/Python runtime, no package manager, just scp and run
  • Local-First — All data stays on your machine; nothing is uploaded to the cloud
  • Cloud Relay — No public server, domain registration, or HTTPS certificate needed; 5-min setup for WeCom/WeChat
  • Browser Automation — Built-in CDP protocol control, snapshot-then-act pattern, no Puppeteer/Playwright installation
  • 75+ MCP Tools — Covers files, Shell, system, network, calendar, Git, GitHub, and more
  • China Platform Native — DingTalk, Feishu, WeCom, WeChat Official Account ready out-of-box
  • Built-in Web Chat UI — Open in any browser, no client needed. Supports multiple simultaneous sessions each with isolated AI memory, persists across page refreshes
  • Embedded Friendly — Compile to ARM/MIPS, easy deployment to Raspberry Pi, routers, NAS
  • Multi-AI Backend — 16 AI providers including Claude, DeepSeek, Kimi, MiniMax, Gemini, OpenAI, with per-platform/channel model overrides
  • Claude Extended Thinking — Native Anthropic Thinking API support, real chain-of-thought reasoning via /think high
  • Docker Support — Multi-stage Dockerfile and docker-compose.yml for containerized deployment
  • Health Diagnostics — lsbot doctor checks config, connectivity, dependencies in one command

Supports WeCom, Feishu, DingTalk, Slack, Telegram, Discord, WhatsApp, LINE, Teams, and more — 19 chat platforms in total — plus a built-in browser Web Chat UI with multiple parallel sessions. Either 5-minute cloud relay or OpenClaw-style self-hosted deployment. Check Roadmap for more features.

Quick Start

Two steps — no platform account, no public server required:

Step 1: Install

# macOS / Linux / WSL
curl -fsSL https://files.lingti.com/install-lsbot.sh | bash

# Windows (PowerShell)
irm https://files.lingti.com/install-lsbot.ps1 | iex

Step 2: Run relay with your AI provider and key

lsbot relay --provider deepseek --api-key sk-xxx

It immediately prints your personal bot page:

Your bot page: https://lsbot.org/bots/xxx
E2E fingerprint: sha256:a3f7c91b2d4e8f06

Open the link to chat with your bot in the browser — one command, no platform setup needed.

China Mainland users: your bot page is also accessible at https://lsbot.net/bots/xxx.

Supported --provider values: deepseek, claude, kimi, minimax, gemini, openai, and more. See AI-PROVIDERS.md.

Advanced: Connect a Messaging Platform (WeCom, Feishu, etc.)

To integrate with WeCom, Feishu, DingTalk, or other platforms, add the platform-specific flags:

# WeCom (Enterprise WeChat)
lsbot relay --platform wecom \
  --wecom-corp-id ww... --wecom-agent-id 1000002 \
  --wecom-secret xxx --wecom-token xxx --wecom-aes-key xxx \
  --provider deepseek --api-key sk-xxx

# Feishu
lsbot relay --platform feishu \
  --feishu-app-id cli_xxx --feishu-app-secret xxx \
  --provider claude --api-key sk-ant-xxx

See Cloud Relay docs for all platforms.

Installation

Examples

Intelligent Chat, File Management, Information Retrieval

Smart Assistant WeCom File Transfer Information Search
Smart Chat WeCom File Transfer Information Search
Background Running Demo — make && dist/lsbot gateway
Terminal Demo

Clone, compile and run directly, paired with DeepSeek model, processing DingTalk messages in real-time

Why lsbot?

Security-First. Single Binary. Local-First.

Unlike traditional Bot frameworks that require Docker, databases, or complex runtime environments, lsbot is built around three core principles:

  1. End-to-End Encrypted by Default — P-256 ECDH key exchange + AES-256-GCM message encryption, enabled automatically on every relay session. Use --plain only when connecting to legacy infrastructure that cannot negotiate E2EE.
  2. Single Static Binary — ~15MB binary, no external dependencies. scp to any server and run immediately.
  3. Local-First — All your data stays on your machine. No telemetry, no cloud sync, no third-party data exposure.
  4. Out-of-Band Key Verification — Public key fingerprint is printed on relay start so you can verify the connection independently of the relay server.
  5. Embedded Friendly — Pure Go implementation, compilable to ARM/MIPS, deployable to Raspberry Pi, routers, NAS.
  6. Code Restraint — Every line of code has a clear reason to exist, rejecting over-design.
# Clone, compile, run
git clone https://github.com/ruilisi/lsbot.git
cd lsbot && make
./dist/lsbot gateway --provider deepseek --api-key sk-xxx

Single Binary

# Compile
make build

# Ready to use
./dist/lsbot serve

No Docker, no database, no cloud service required.

Local-First

All functions run locally, data is not uploaded to the cloud. Your files, calendar, and process information are safely kept locally.

Cross-Platform Support

Core functions support macOS, Linux, Windows. macOS users can enjoy native calendar, reminders, notes, music control and more.

Supported Platforms:

PlatformArchitectureBuild Command
macOSARM64 (Apple Silicon)make darwin-arm64
macOSAMD64 (Intel)make darwin-amd64
LinuxAMD64make linux-amd64
LinuxARM64make linux-arm64
LinuxMIPSmake linux-mips
WindowsAMD64make windows-amd64

Architecture

MCP Server — Claude Desktop Native Integration

lsbot is primarily an MCP (Model Context Protocol) Server that provides rich local tools for Claude Desktop and other MCP-compatible clients.

Quick Start:

  1. Install lsbot:
    • macOS / Linux / WSL: curl -fsSL https://files.lingti.com/install-lsbot.sh | bash
    • Windows (PowerShell): irm https://files.lingti.com/install-lsbot.ps1 | iex
  2. Configure Claude Desktop MCP: ~/.config/Claude/claude_desktop_config.json 
    {
  "mcpServers": {
    "lsbot": {
      "command": "lsbot",
      "args": ["serve"]
    }
  }
}
  3. Restart Claude Desktop, you can now use 75+ local tools

Multi-Platform Gateway — Message Router

In addition to MCP mode, lsbot can also run as a message router, connecting multiple messaging platforms simultaneously.

Supported Platforms:

PlatformConnection MethodSetupFile SendingStatus
WeComCallback APICloud Relay / Self-hostedAll formats✅
WeChat OfficialCloud Relay10 secondsImage/Voice/Video✅
DingTalkStream ModeOne-clickPlanned✅
Feishu/LarkWebSocketOne-clickPlanned✅
SlackSocket ModeOne-clickPlanned✅
TelegramBot APIOne-clickPlanned✅
DiscordGatewayOne-clickPlanned✅
WhatsAppWebhook + Graph APISelf-hostedPlanned✅
LINEWebhook + Push APISelf-hostedPlanned✅
Microsoft TeamsBot FrameworkSelf-hostedPlanned✅
Matrix / ElementHTTP SyncSelf-hostedPlanned✅
Google ChatWebhook + RESTSelf-hostedPlanned✅
MattermostWebSocket + RESTSelf-hostedPlanned✅
iMessageBlueBubblesSelf-hostedPlanned✅
Signalsignal-cli RESTSelf-hostedPlanned✅
TwitchIRCSelf-hosted—✅
NOSTRWebSocket RelaysSelf-hostedPlanned✅
ZaloWebhook + RESTSelf-hostedPlanned✅
Nextcloud TalkHTTP PollingSelf-hostedPlanned✅
Web Chat UIWebSocket (built-in)--webapp-port—✅

File sending details (setup, supported types, limitations): File Sending Guide

Full list with config details and env vars: Chat Platforms

Cloud Relay Advantage: No public server, no domain registration, no HTTPS certificate, no firewall configuration, 5 minutes to complete integration.

Relay servers: lsbot.org (International) · lsbot.net (China Mainland mirror). All relay traffic is end-to-end encrypted — the relay sees only ciphertext.

MCP Toolset — 75+ Local System Tools

Covers all aspects of daily work, making AI your all-around assistant.

CategoryToolsFeatures
File Operations9Read/write, search, organize, batch delete, trash
Shell Commands2Command execution, path finding
System Info4CPU, memory, disk, environment variables
Process Management3List, details, terminate
Network Tools4Interfaces, connections, Ping, DNS
Calendar6View, create, search, delete events (macOS)
Browser Automation12Snapshot, click, input, screenshot, tab management
Scheduled Tasks5Create, list, delete, pause, resume cron jobs

Scheduled Tasks — Automate Your Workflow

Use standard Cron expressions to schedule periodic tasks for true unattended automation.

Core Features:

  • Support standard Cron expressions (minute, hour, day, month, weekday)
  • Task persistence, auto-resume after restart
  • Pause/resume task execution
  • Record execution status and error information
  • Call any MCP tool

Quick Examples:

# Daily backup at 2 AM
cron_create(
  name="daily-backup",
  schedule="0 2 * * *",
  tool="shell_execute",
  arguments={"command": "tar -czf ~/backup-$(date +%Y%m%d).tar.gz ~/data"}
)

# Check disk space every 15 minutes
cron_create(
  name="disk-check",
  schedule="*/15 * * * *",
  tool="disk_usage",
  arguments={"path": "/"}
)

# Weekday morning standup reminder at 9 AM
cron_create(
  name="morning-standup",
  schedule="0 9 * * 1-5",
  tool="notification_send",
  arguments={"title": "Standup Reminder", "message": "Time for daily standup!"}
)

Cron Expression Format:

* * * * *
│ │ │ │ │
│ │ │ │ └─ Day of week (0-6, 0=Sunday)
│ │ │ └─── Month (1-12)
│ │ └───── Day of month (1-31)
│ └─────── Hour (0-23)
└───────── Minute (0-59)

Common Examples:

  • 0 * * * * - Every hour
  • */15 * * * * - Every 15 minutes
  • 0 9 * * 1-5 - Weekdays at 9 AM
  • 0 0 1 * * - First day of every month
  • 30 8-18 * * * - Every hour from 8:30 to 18:30

Task configuration saved to ~/.lingti.db (SQLite), auto-resume after MCP service restart.

Built-in Web Chat UI — Open in Any Browser

No client apps needed. Start the web chat interface with a single flag:

lsbot gateway --provider deepseek --api-key sk-xxx --webapp-port 8080
# Open http://localhost:8080

Web Chat UI Demo

Key features:

FeatureDetails
Multiple simultaneous sessionsEach session in the sidebar is fully independent — talk to the bot on different tasks at the same time without interference
Isolated memory per sessionEach session has its own channelID → separate AI conversation history. What you say in session A never bleeds into session B
True parallel processingStart a long task in session A, immediately switch to session B and send a new message — both are processed concurrently
Session persistenceSession list and chat history are saved in browser localStorage — survive page refreshes and browser restarts
Markdown renderingBot replies render full Markdown: code blocks with syntax hints, tables, lists, bold/italic
Auto port incrementIf the configured port is busy, automatically tries the next port until one is free
Zero extra dependenciesUI is a single embedded HTML file — no Node.js, no npm, no build step

Multiple sessions in action:

Browser tab (http://localhost:8080)
├── Session A  ── "Analyze this CSV file..." (AI still working)
├── Session B  ── "Write a poem about cats" (AI responded instantly)
└── Session C  ── Yesterday's conversation (still accessible)

Via config file:

# ~/.lsbot.yaml
platforms:
  webapp:
    port: 8080

Via environment variable:

WEBAPP_PORT=8080 lsbot gateway --provider deepseek --api-key sk-xxx

Skills — Modular Capability Packs

Skills are modular capability packs that teach lsbot how to use external tools. Each skill is a directory containing a SKILL.md file with YAML frontmatter for metadata and Markdown body for AI instructions.

# List all discovered skills
lsbot skills

# Check readiness status
lsbot skills check

# Get details on a specific skill
lsbot skills info github

Ships with 8 bundled skills: Discord, GitHub, Slack, Peekaboo (macOS UI automation), Tmux, Weather, 1Password, and Obsidian. Supports user-custom and project-specific skills.

See Skills Guide for full documentation.

Multi-AI Backend

Supports 15 AI providers covering mainstream LLM platforms globally:

#ProviderNameDefault Model
1deepseekDeepSeek (recommended)deepseek-chat
2qwenQwen / 通义千问qwen-plus
3claudeClaude (Anthropic)claude-sonnet-4-20250514
4kimiKimi / Moonshotmoonshot-v1-8k
5minimaxMiniMax / 海螺 AIMiniMax-Text-01
6doubaoDoubao / 豆包 (ByteDance)doubao-pro-32k
7zhipuZhipu GLM / 智谱glm-4-flash
8openaiOpenAI (GPT)gpt-4o
9geminiGemini (Google)gemini-2.0-flash
10yiYi / 零一万物yi-large
11stepfunStepFun / 阶跃星辰step-2-16k
12baichuanBaichuan / 百川智能Baichuan4
13sparkSpark / 讯飞星火 (iFlytek)generalv3.5
14siliconflowSiliconFlow / 硅基流动 (aggregator)Qwen/Qwen2.5-72B-Instruct
15grokGrok (xAI)grok-2-latest

Full list with API key links and aliases: AI Providers

# Specify provider via command line
lsbot gateway --provider qwen --api-key "sk-xxx" --model "qwen-plus"

# Override default model
lsbot relay --provider openai --api-key "sk-xxx" --model "gpt-4o-mini"

Documentation

License

MIT License - see LICENSE file for details

Contact