Files
zCode-CLI-X/TELEGRAM_SETUP.md
admin d7107e162f security: remove all hardcoded paths, usernames, IPs, and chat IDs from tracked files
- start.sh: use dirname instead of hardcoded path
- src/zcode.js: remove hardcoded chat_id fallback
- src/utils/rtk.js: use 'rtk' from PATH instead of hardcoded binary path
- src/telegram-bot.ts: use process.cwd() instead of hardcoded path
- TELEGRAM_SETUP.md: replace token/chat_id with placeholders
- QUICKSTART.md: sanitize all references
- SERVICE_MAP.md: use relative paths instead of absolute
2026-05-05 14:30:57 +00:00

87 lines
1.9 KiB
Markdown

# Telegram Bot Setup - zCode CLI X
## ✅ Status: RUNNING
Your zCode CLI X Telegram bot is now **live and running 24/7**!
## 📊 Current Configuration
- **Bot Token**: Configured via `.env` (`TELEGRAM_BOT_TOKEN`)
- **Allowed Users**: Configured via `.env` (`TELEGRAM_ALLOWED_USERS`)
- **API**: Z.AI GLM-5.1 (Coding Plan)
- **Port**: Configured via `ZCODE_PORT` (default: 3001)
- **Service**: systemd (auto-start on boot)
## 🚀 How to Use
### Via Telegram
1. Open Telegram
2. Search for your bot
3. Send `/start` to initialize
4. Start chatting!
### Check Status
```bash
# Check service status
sudo systemctl status zcode
# View logs
tail -f logs/zcode.log
# Restart service
sudo systemctl restart zcode
# Stop service
sudo systemctl stop zcode
```
## 🔗 Webhook Status
Webhook is **configured and active**. To receive real messages:
1. Get a public URL (e.g., use ngrok):
```bash
ngrok http 3001
```
2. Set the webhook URL:
```bash
curl -F "url=https://your-domain.com/telegram/webhook" \
"https://api.telegram.org/bot<YOUR_TOKEN>/setWebhook"
```
3. Verify webhook:
```bash
curl "https://api.telegram.org/bot<YOUR_TOKEN>/getWebhookInfo"
```
## 🛠️ Available Commands
- `/start` - Start the bot
- `/help` - Show help
- `/status` - Check system status
- `/agents` - List available agents
- `/skills` - List available skills
## 🎯 Features
**Z.AI Integration**: GLM-5.1 model
**Tools**: Bash, FileEdit, WebSearch, Git
**Agents**: Code Reviewer, Architect, DevOps
**Skills**: code_review, bug_fix, refactor, etc.
**24/7 Uptime**: systemd service
**Real-time**: WebSocket support
## 📝 Next Steps
1. **Set bot name**: Talk to @BotFather
2. **Enable webhook**: Use ngrok for local dev
3. **Customize**: Add more tools and skills
4. **Monitor**: Check logs regularly
---
**zCode CLI X is ready! Start chatting via Telegram!** 🚀⚡