feat(telegram): add Telegram channel integration

[salma-marei]

Summary

Add Telegram as a supported NetClaw channel.

Changes

• Receive Telegram messages, photos, albums, and files.
• Send generated files to Telegram.
• Support private chats and group mention rules.
• Add Telegram tool-approval buttons.
• Support proactive messages to approved users and groups.
• Add Telegram to netclaw init and netclaw config.
• Add per-user and per-group audience controls.
• Validate bot tokens and chat IDs through the Telegram API.
• Add Telegram health and doctor checks.
• Restore Telegram chat sessions after daemon restarts.
• Format headings, lists, quotes, code, and strikethrough.
• Show Telegram typing indicators.
• Update the configuration schema and operational documentation.

Validation

• Full solution build passes with 0 warnings and 0 errors.
• All 55 Telegram-focused tests pass.
• Slopwatch passes with 0 issues.
• Copyright-header verification passes.
• git diff --check passes.
• Manual end-to-end testing passes for:
  • Personal and Public private chats
  • Team groups with mention-only behavior
  • Tool approvals
  • Inbound and outbound files
  • Proactive private and group messages
  • Formatting
  • Restart recovery
  • Health and doctor checks

Local test notes

The full local suite reported three unrelated failures:

• Two memory-prompt snapshot tests
• One reminder retry test

This branch does not modify those tests or features.

The native Linux and macOS smoke suites were not available in the Windows development environment. GitHub Actions will run them.

[Aaronontheweb]

@salma-marei thank you for your contribution! this is very exciting - I will review this as soon as I am able, which might take a few days

[salma-marei]

@salma-marei thank you for your contribution! this is very exciting - I will review this as soon as I am able, which might take a few days

Thank you!