openab 0.1.5

Open Agent Bridge — connect agent backends (CLIs, APIs) to chat platforms (Telegram, …).

OpenAB

Open Agent Bridge — Connect AI agents (Cursor, Codex, Gemini, Claude, OpenClaw) to chat platforms. One config, one bridge.

中文 · Configuration & usage

---

What it does

OpenAB forwards messages from chat platforms (or HTTP API) to an agent backend you choose and sends the reply back. One config, one bridge.

Agents	Chats / API
Cursor, Codex, Gemini, Claude, OpenClaw	Telegram, Discord, OpenAI-compatible HTTP API (openab run serve), more planned

---

Quick start

1. Install (Python 3.10+)

pip install openab
# or: uv pip install -e .   (from repo)
# or: uv tool install openab

2. Config — Put a YAML/JSON config in ~/.config/openab/ (see config.example.yaml). You need at least a bot token (Telegram/Discord) or nothing for API-only; allowlist or api.key for auth. You can also pass tokens via CLI: openab run telegram --token <token>, openab run serve --token <api_key>. Full options: docs/en/guide.md.

3. Run

openab run serve     # OpenAI-compatible API (optional: --token, --host, --port)
openab run telegram  # Telegram bot (optional: --token, --workspace, --verbose)
openab run discord   # Discord bot (optional: --token, --workspace, --verbose)

• No config? Run openab or openab run — you get a hint and the API server starts by default.
• Then open the bot in your chat app, or point any OpenAI-compatible client at http://127.0.0.1:8000/v1 with the API key printed at startup.

---

Docs

• Configuration & usage — Config keys, agent setup, commands, API server, security, i18n.
• 中文说明 — 配置与使用（中文）

---

License

MIT — LICENSE