- Rewrite index.mdx as proper getting started guide - New: chat.mdx (modes, permissions, context management) - New: skills.mdx (categories, marketplace, local skills) - New: design-agent.mdx (single/batch image generation) - New: gallery.mdx (browsing, filtering, detail view) - Rewrite providers.mdx — CLI env auth, cc switch caveat, API Key vs Auth Token, Chinese provider presets, model mapping, priority chain - Rewrite mcp.mdx — three transport types, dual view modes - Rewrite assistant-workspace.mdx — align with Settings > Assistant tab - Rewrite faq.mdx — comprehensive Q&A - Bridge split into 5 pages: overview + Telegram + Discord + Feishu + QQ - Flatten single-page folders to remove sidebar expand arrows - Update meta.json with new pages Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
87 lines
3.5 KiB
Plaintext
87 lines
3.5 KiB
Plaintext
---
|
|
title: Message Bridge
|
|
description: Bridge Claude conversations to Telegram, Discord, Feishu / Lark, and QQ.
|
|
---
|
|
|
|
# Message Bridge
|
|
|
|
The Message Bridge lets you chat with Claude from instant messaging apps on your phone. Start CodePilot on your desktop, configure a Bot, and you can interact with Claude anytime through Telegram, Discord, Feishu / Lark, or QQ.
|
|
|
|
## Supported Platforms
|
|
|
|
| Platform | Highlights |
|
|
|----------|------------|
|
|
| **Telegram** | Long-polling mode, streaming preview, permission buttons, rich Markdown rendering |
|
|
| **Discord** | WebSocket mode, streaming preview, channel and DM dual-mode |
|
|
| **Feishu / Lark** | WebSocket mode, domestic / international edition switching, group policy control |
|
|
| **QQ** | REST API mode, image sending, DM bridging |
|
|
|
|
## How It Works
|
|
|
|
```
|
|
Phone IM → Bot receives message → CodePilot forwards to Claude → Claude replies → Bot sends reply back to IM
|
|
```
|
|
|
|
1. You send a message to the Bot in your messaging platform
|
|
2. CodePilot's Bridge service receives the message and forwards it to Claude
|
|
3. Claude processes the request and generates a reply
|
|
4. The reply is sent back to your messaging platform via the Bot
|
|
5. If Claude needs permission confirmation (e.g. writing a file), it sends a confirmation button in the IM
|
|
|
|
## Basic Setup
|
|
|
|
### Enable the Bridge
|
|
|
|
1. Click **Bridge** in the sidebar
|
|
2. On the Bridge overview page, turn on the **Bridge master switch**
|
|
3. Enable the channels you need (Telegram / Discord / Feishu / QQ)
|
|
4. Go to each channel's page to configure Bot credentials
|
|
5. Click **Start**
|
|
|
|
### Bridge Global Settings
|
|
|
|
On the Bridge overview page you can configure:
|
|
|
|
- **Default working directory** — Default project path for new conversations
|
|
- **Default model** — Model used for bridge conversations
|
|
- **Default provider** — API provider used for bridge conversations
|
|
- **Auto-start** — Automatically start the bridge service when CodePilot launches
|
|
|
|
### Bridge Status
|
|
|
|
The Bridge page shows real-time status:
|
|
|
|
- Master service status (Connected / Disconnected)
|
|
- Status of each channel adapter
|
|
- Number of active session bindings
|
|
- Time of the last message
|
|
|
|
## Slash Commands
|
|
|
|
You can use slash commands in the IM to control CodePilot:
|
|
|
|
| Command | Arguments | Description |
|
|
|---------|-----------|-------------|
|
|
| `/new` | `[path]` | Start a new conversation, optionally specifying a working directory |
|
|
| `/bind` | `<session-id>` | Bind the current IM chat to an existing CodePilot conversation |
|
|
| `/cwd` | `/path/to/dir` | Switch the working directory for the current conversation |
|
|
| `/mode` | `plan\|code\|ask` | Switch conversation mode |
|
|
| `/status` | — | View current conversation status (ID, working directory, mode, model) |
|
|
| `/sessions` | — | List recent conversations for the current channel (up to 10) |
|
|
| `/stop` | — | Abort the currently running task |
|
|
| `/help` | — | View available commands |
|
|
|
|
## Usage Tips
|
|
|
|
- **Keep CodePilot running** — The bridge relies on the desktop app as a relay; the Bot cannot respond if CodePilot is closed
|
|
- **System tray mode** — Minimize to the system tray so the bridge stays active without taking up desktop space
|
|
- **Prefer DMs** — Using DMs is recommended; group chats may be noisy with other messages
|
|
- **Permission confirmations** — When Claude needs to perform a sensitive operation it sends a confirmation button in the IM; make sure to respond promptly
|
|
|
|
## Channel Configuration
|
|
|
|
- [Telegram Setup](/docs/bridge/telegram)
|
|
- [Discord Setup](/docs/bridge/discord)
|
|
- [Feishu / Lark Setup](/docs/bridge/feishu)
|
|
- [QQ Setup](/docs/bridge/qq)
|