wehub-resource-sync
8a21a212f8
Deploy Documentation / deploy (push) Has been cancelled
Canary / build-cli (push) Has been skipped
Canary / Upload Install Script (push) Has been skipped
Canary / bundle-desktop (push) Has been skipped
Canary / bundle-desktop-intel (push) Has been skipped
Canary / bundle-desktop-linux (push) Has been skipped
Canary / bundle-desktop-windows (push) Has been skipped
Canary / bundle-desktop-windows-cuda (push) Has been skipped
Canary / Release (push) Has been skipped
Cargo Deny / deny (push) Has been skipped
Unused Dependencies / machete (push) Has been skipped
Canary / Prepare Version (push) Failing after 1s
Live Provider Tests / check-fork (push) Failing after 0s
Create Minor Release PR / check-version-bump-pr (push) Has been skipped
Publish Ask AI Bot Docker Image / docker (push) Failing after 1s
Live Provider Tests / changes (push) Has been skipped
Scorecard supply-chain security / Scorecard analysis (push) Has been skipped
Publish Docker Image / docker (push) Failing after 1s
CI / changes (push) Failing after 8s
Create Minor Release PR / release (push) Has been skipped
Live Provider Tests / Smoke Tests (push) Has been cancelled
Live Provider Tests / Smoke Tests (Code Execution) (push) Has been cancelled
Live Provider Tests / Compaction Tests (push) Has been cancelled
CI / Build Rust Project on Windows (push) Has been cancelled
Live Provider Tests / Build Binary (push) Has been cancelled
CI / Lint Rust Code (push) Has been cancelled
CI / Check Generated Schemas are Up-to-Date (push) Has been cancelled
CI / Test and Lint Electron Desktop App (push) Has been cancelled
CI / Check Rust Code Format (push) Has been cancelled
CI / Build and Test Rust Project (push) Has been cancelled
CI / Check MSRV (push) Has been cancelled
3.2 KiB
3.2 KiB
title, sidebar_position, sidebar_label, description
| title | sidebar_position | sidebar_label | description |
|---|---|---|---|
| Telegram Gateway | 2 | Telegram Gateway | Chat with goose through Telegram from any device. |
The Telegram Gateway lets you interact with goose through Telegram, enabling remote access from any device where Telegram is available.
:::warning Experimental Feature The Gateway feature is experimental and in active development. Behavior and configuration may change in future releases. :::
How It Works
The Gateway connects your Telegram account to goose through a secure pairing process. Once paired, you can send messages to a Telegram bot that forwards them to goose, and receive formatted responses back in Telegram.
Key details:
- Uses a Telegram bot that you create and configure
- Secure pairing with a one-time code
- Supports formatted responses with code blocks and markdown
- Maintains a persistent session that auto-compacts for long conversations
- Works from any device with Telegram installed
Prerequisites
Before setting up the Telegram Gateway, you need to create a Telegram bot:
- Open Telegram and search for @BotFather
- Send
/newbotand follow the prompts to create your bot - Copy the bot token that BotFather provides (looks like
123456789:ABCdefGHIjklMNOpqrsTUVwxyz)
:::tip Keep your bot token secure. Anyone with the token can control your bot. :::
Setup
Desktop App
- Open goose Desktop
- Go to Settings > Gateways
- In the Telegram section, enter your bot token
- Click Start to activate the gateway
- Click Generate Pairing Code to get a one-time pairing code
Pair Your Telegram Account
- Open Telegram and find your bot (search for the username you gave it)
- Send the pairing code to the bot
- The bot will confirm the pairing is complete
You can now chat with goose through Telegram!
CLI Usage
You can also manage the gateway from the command line:
# Check gateway status
goose gateway status
# Start the Telegram gateway
goose gateway start telegram --bot-token YOUR_BOT_TOKEN
# Generate a pairing code
goose gateway pair telegram
# Stop the gateway
goose gateway stop telegram
What You Can Do
Once paired, you can:
- Send messages to goose and receive responses
- Get formatted code blocks with syntax highlighting
- Continue conversations across multiple sessions
- Access all your configured goose extensions
Managing Paired Users
From the Desktop app's Gateway settings, you can:
- View all paired Telegram users
- See which session each user is connected to
- Unpair users to revoke their access
Troubleshooting
Bot not responding
- Verify the bot token is correct
- Check that the gateway is running in goose Desktop
- Ensure your computer is awake and goose Desktop is open
Pairing code not working
- Pairing codes expire after a few minutes—generate a new one
- Make sure you're sending the code to the correct bot
Messages not formatting correctly
- The gateway converts goose's markdown to Telegram-compatible formatting
- Some complex formatting may be simplified for Telegram compatibility