0.5.2

agent-chat-gateway

Turn your AI agent into a team-shared chatbot — in minutes.

Already running Claude Code or OpenCode? agent-chat-gateway connects it to your team's chat system (Rocket.Chat, Mattermost, and more) so everyone can talk to it directly from chat — no terminal required, no code changes to your agent.

Inspired by OpenClaw's vision of making AI agents accessible from any messaging app — built for the team layer.

How it compares to Claude Code Channels: Claude Code's native Channels feature connects a single session to Telegram, Discord, or iMessage — great for personal use. agent-chat-gateway is built for teams: multiple agents, multiple chat systems, per-user roles, human oversight for sensitive operations, and shared sessions across your whole workspace.

---

Features

• 💬 Works with Rocket.Chat and Mattermost — and extensible to Slack, Discord, or any other chat system you use
• 🤖 Bring your own agent — Claude Code and OpenCode work out of the box; plug in any other agent too
• 👥 User-aware in chat — the agent knows who sent each message and can personalize tone, language, and style per person using room profiles
• 🔒 Owner & Guest roles — control who can do what, with different permissions per role
• 🛡️ Human oversight for sensitive actions — the agent pauses and asks for your approval before executing risky operations like file writes or shell commands
• 🔗 Continue your session remotely — pin a chat room to an existing agent session and pick up right where you left off, from anywhere
• 📎 File attachments — send files in chat and the agent can read and work with them
• 🧠 Context injection — pre-load domain knowledge, system prompts, or project context into the agent at startup
• ⚡ Multiple chat systems at once — connect to several chat platforms simultaneously
• ⏰ Built-in task scheduler — let the agent schedule recurring or one-shot tasks directly from chat ("remind me in 5 minutes", "run daily standup at 09:00") without any infrastructure setup
• 🤝 Agent-to-agent collaboration — let multiple AI agents collaborate in a shared room; built-in loop protection keeps conversations bounded and human-observable
• 🛠️ Interactive config TUI — agent-chat-gateway config gives you a full-screen editor with validation, provenance tracking, and safe writes, instead of hand-editing YAML
• 🧪 Voice gateway (experimental) — connect your agent to Siri via iOS Shortcuts; any phone becomes a zero-hardware voice interface with no custom wake word infrastructure

---

What's Supported

---

Quick Start

Option A — AI-guided install (recommended)

The easiest way to install is to ask your AI agent to do it for you — it handles dependencies, configuration, and any troubleshooting automatically.

In Claude Code or OpenCode, run this prompt:

Please install agent-chat-gateway by following the instructions at https://raw.githubusercontent.com/HammerMei/agent-chat-gateway/main/docs/install-agent.md

Option B — Docker (no local dependencies)

If you'd rather skip installing Python, Node.js, or Claude Code locally, run ACG in a container:

# 1. Copy the example directory to your deployment location
cp -r docker/docker-compose.example my-acg
cd my-acg

# 2. Fill in your credentials and settings
#    .env                — Claude Code OAuth token (see file for instructions)
#    config/config.yaml  — chat platform credentials (Rocket.Chat/Mattermost),
#                           owners, rooms, agents — file gets chmod 600 automatically

# 3. Start
docker compose up -d

# Logs
docker compose logs -f

See docker/docker-compose.example/ for the full annotated setup — all files are pre-structured and ready to fill in.

Prefer a native install? See INSTALL.md for step-by-step instructions.

---

Running the Gateway

# Start the gateway
agent-chat-gateway start

# Check status
agent-chat-gateway status

# Stop the gateway
agent-chat-gateway stop

See docs/user-guide.md for the full CLI reference, configuration options, and usage examples.

---

Documentation