openab 0.1.9

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

中文 · English

OpenAB

Open Agent Bridge — Connect AI agents to chat platforms. One config, one bridge. Currently implemented: Cursor, Codex. Gemini, Claude, OpenClaw not yet implemented.

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 (implemented) Gemini, Claude, OpenClaw not yet implemented	Telegram, Discord, OpenAI-compatible HTTP API (openab run serve), more planned

---

Quick start

1. Install (Python 3.10+)

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

2. Run and follow the prompts

openab run

You’ll choose serve (API), telegram, or discord, enter bot token and allowlist when asked; choices are saved to ~/.config/openab/config.yaml. Then open your bot in the app and chat, or use the API at http://127.0.0.1:8000/v1 with the printed key. Use /resume or !resume in chat to switch sessions.

• Tokens: Telegram → @BotFather /newbot; Discord → Developer Portal → Bot → Reset Token.
• Unauthorized? Send /whoami or !whoami to get your ID, then openab config set telegram.allowed_user_ids "ID" (or send the API key to the bot to self-add).

Full options: Configuration & usage.

---

Docs

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

---

License

MIT — LICENSE