openab 0.1.7

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

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. Create config — Copy the example and edit:

mkdir -p ~/.config/openab
cp config.example.yaml ~/.config/openab/config.yaml
# then edit: set telegram.bot_token and/or discord.bot_token

3. Get a bot token (for Telegram or Discord)

• Telegram: Open @BotFather → send /newbot → follow prompts → copy the token into telegram.bot_token in config (or pass with openab run telegram --token <token>).
• Discord: Discord Developer Portal → New Application → Bot → Reset Token → copy into discord.bot_token (or use --token when running).

4. Allow yourself — After the bot is running, send /whoami (Telegram) or !whoami (Discord) to get your user ID. Then either:

• Add your ID to config: openab config set telegram.allowed_user_ids "YOUR_ID" (or discord.allowed_user_ids), or
• Send the API key (printed when you run openab run serve once) as a message to the bot; it will add you to the allowlist automatically.

5. Run and chat

openab run telegram   # or: openab run discord
# In Telegram/Discord: open your bot, send any message. Use /resume to see session buttons (resume latest, new session, or pick a history session).

• API only: Run openab run serve — no bot token needed. Point clients at http://127.0.0.1:8000/v1 with the printed API key.
• No config? Running openab or openab run will start the API server by default and show a hint.

Full options: Configuration & usage.

---

Docs

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

---

License

MIT — LICENSE