中文文档 · Documentation

RingCentral AI Agent Bridge — connect RingCentral Team Messaging to AI agents (Claude, Codex, Gemini, Kimi, etc.).

Inspired by WeClaw — the original WeChat AI Agent Bridge.

# One-line install (macOS/Linux)
curl -sSL https://raw.githubusercontent.com/ringclaw/ringclaw/main/install.sh | sh

# One-line install (Windows PowerShell)
irm https://raw.githubusercontent.com/ringclaw/ringclaw/main/install.ps1 | iex

# Configure (creates ~/.ringclaw/config.json) and start
ringclaw setup
ringclaw start

All configuration lives in ~/.ringclaw/config.json. On first start, RingClaw auto-detects installed AI agents and updates the file. Environment variables like RC_BOT_TOKEN are no longer read — use ringclaw setup or edit the file directly.

🤖 AI Agent Setup: Let your AI agent handle the full setup — AI Agent Setup Guide

• Multi-Agent Support — route messages to Claude, Codex, Gemini, Kimi, and more via ACP/CLI/HTTP. → Agents
• Chat Commands — /cc, /cx, /cs aliases, multi-agent broadcast, session management. → Commands
• Chat Summarization — summarize conversations across chats with natural language. → Summarize
• AI-Driven Actions — agents auto-create notes, tasks, events, and adaptive cards. → Actions
• Cron & Heartbeat — scheduled tasks and periodic agent check-ins. → Cron · → Heartbeat
• Proactive Messaging — CLI and HTTP API for sending messages and media. → Media & API
• Security — API token auth, Host validation, ACP write permissions, credential redaction. → Security
• Full CLI — manage messages, chats, tasks, notes, events, cards, users, files from the command line. → CLI
• Image Analysis — send images to the bot for AI-powered visual analysis (ACP agents). → Image Analysis
• Docker & systemd — background mode, auto-start on boot. → Deployment

graph LR
    User -->|sends message| RC[RingCentral]
    RC -->|WebSocket event| RingClaw
    RingClaw -->|routes to| Codex
    RingClaw -->|routes to| Claude[Claude Code]
    RingClaw -->|routes to| More[More Agents...]
    RingClaw -->|replies| RC
    RC -->|displays reply| User

📖 Full documentation: ringclaw.github.io/ringclaw

MIT