xbot

xbot — Self-hosted AI Agent with a first-class Web UI

Browser · Feishu · Terminal — one agent, one config, your server

简体中文  ·  Documentation  ·  Changelog

What is xbot?

xbot is a self-hosted AI agent you run on your own server and drive from the browser. It uses tools — Shell, file I/O, web search, scheduled tasks, sub-agents, plugins — to get real work done, and your data never leaves your server.

The Web UI is the primary surface: sessions and live streaming, file preview, git diffs, a built-in terminal, plugin panels, and a model picker — all in the browser. Feishu / terminal channels connect the same agent to wherever your team already works, sharing one LLM configuration.

Quick start

1. Install (one command)

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/ai-pivot/xbot/master/scripts/install.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/ai-pivot/xbot/master/scripts/install.ps1 | iex

curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/ai-pivot/xbot/master/scripts/install-cn.sh | bash

One command installs everything: binary + Web UI + every built-in plugin, with the web channel already enabled.

Already installed? Re-run xbot-cli setup to repair, or xbot-cli setup --check to diagnose.

Or: paste this into your AI agent and let it do the install

Install and start xbot on this machine:
1. curl -fsSL https://raw.githubusercontent.com/ai-pivot/xbot/master/scripts/install.sh | bash
2. xbot-cli setup --check        # exit code 0 means a complete install
3. nohup xbot-cli serve >/tmp/xbot.log 2>&1 &
4. curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:8082   # must print 200
If anything fails, read https://ai-pivot.github.io/xbot/installation/ (Troubleshooting).

There are exactly 5 optional flags (MODE / PORT / XBOT_HOME / INSTALL_PATH / CHANNEL); everything else lives in Install & configure.

2. Start the server

xbot-cli serve

That's it — the installer already enabled the web channel. Want it to survive reboots? Reinstall with the service mode: MODE=server-client bash install.sh (writes and starts the systemd --user unit xbot-server; see the installation guide).

3. Open the Web UI and configure

Browse to http://localhost:8082:

1. Create account — the first registration becomes the operator account (no invite code needed on a fresh install).
2. Add your LLM — gear icon (bottom-right) → LLM → add a subscription: provider, base URL (https://…/v1), API key, then pick a model.
3. Start chatting — create a session in the left sidebar and type below.

Web UI at a glance

Built-in plugins

Shipped with every release and installed by xbot-cli setup:

Plugin activation: a channel plugin also needs channels.<name>.enabled = true in config.json — xbot-cli setup writes it automatically (and never overwrites an explicit false).

See the plugin docs for the full manifest / permission / web-view reference.

Channels

Every channel drives the same agent and shares the same LLM configuration.

Web (primary)

{ "web": { "enable": true, "port": 8082 } }

Feishu

Create an app on the Feishu Open Platform, then:

{
  "feishu": {
    "enabled": true,
    "app_id": "cli_xxx",
    "app_secret": "xxx"
  }
}

Required permissions: im:message, im:message.receive_v1, im:message:send_as_bot, contact:user.base:readonly

Other channels

See the Channels documentation.

Built-in tools

The agent can call these tools in conversation:

Extensibility

• Skills — Markdown capability packs in ~/.xbot/skills/
• SubAgents — role-based child agents (explore, code-reviewer, …); custom roles in ~/.xbot/agents/
• Group chat — multi-agent moderated discussion (meeting mode)
• MCP — global and per-session MCP servers (stdio + HTTP), pooled across sessions
• Hooks — command / script handlers on tool and lifecycle events

Documentation

License

MIT