What's Going Wrong?
Summary
When running Hermes Agent from the official Docker image in Dokploy and enabling Telegram via webhook mode, the gateway fails to start because the image appears to be missing the optional PTB webhook dependency.
Environment
- Hermes repo:
NousResearch/hermes-agent
- Docker image:
nousresearch/hermes-agent:latest
- Deployment method: Dokploy (Docker)
- Platform: Telegram webhook
Expected behavior
Telegram webhook mode should work from the official Docker image, or the image/docs should clearly state that webhook support is not included.
Actual behavior
Gateway startup fails with:
RuntimeError: To use `start_webhook`, PTB must be installed via `pip install "python-telegram-bot[webhooks]"`.
WARNING gateway.run: ✗ telegram failed to connect
ERROR gateway.run: Gateway failed to connect any configured messaging platform: telegram: Telegram startup failed: To use `start_webhook`, PTB must be installed via `pip install "python-telegram-bot[webhooks]"`.
### Steps Taken
Why this looks like a packaging/image issue
Hermes advertises Telegram support in the messaging gateway, but the official Docker image seems not to include the dependency required for Telegram webhook mode.
Reproduction
1. Deploy nousresearch/hermes-agent:latest in Docker
2. Configure Telegram to use webhook mode
3. Start the gateway
4. Observe the startup failure above
Questions
• Is this an image packaging bug?
• Should the official Docker image include python-telegram-bot[webhooks]?
• If webhook mode is intentionally excluded from the image, could the docs mention that explicitly and document the recommended workaround?
Possible fix
Ensure the Docker image installs the Telegram webhook extra, e.g. the equivalent of:
### Installation Method
Install script (curl | bash)
### Operating System
Ubuntu 24.04
### Python Version
_No response_
### Hermes Version
latest
### Output of `hermes doctor`
```shell
Full Error Output
RuntimeError: To use `start_webhook`, PTB must be installed via `pip install "python-telegram-bot[webhooks]"`.
WARNING gateway.run: ✗ telegram failed to connect
ERROR gateway.run: Gateway failed to connect any configured messaging platform: telegram: Telegram startup failed: To use `start_webhook`, PTB must be installed via `pip install "python-telegram-bot[webhooks]"`.
What I've Already Tried
No response
What's Going Wrong?
Summary
When running Hermes Agent from the official Docker image in Dokploy and enabling Telegram via webhook mode, the gateway fails to start because the image appears to be missing the optional PTB webhook dependency.
Environment
NousResearch/hermes-agentnousresearch/hermes-agent:latestExpected behavior
Telegram webhook mode should work from the official Docker image, or the image/docs should clearly state that webhook support is not included.
Actual behavior
Gateway startup fails with:
Full Error Output
What I've Already Tried
No response