docs: Add DAARWIZZ bot Quick Start guide
@DAARWIZZBot is now live! Bot Information: - Username: @DAARWIZZBot - Bot ID: 8323412397 - Link: https://t.me/DAARWIZZBot - Token: Stored in .env Quick Start Guide includes: - 5-step deployment process - Webhook setup (ngrok or domain) - Testing instructions - Monitoring and troubleshooting - Bot configuration via BotFather - Phase 4 enhancement roadmap Ready to test first dialog!
This commit is contained in:
Ivan Tytar
322
DAARWIZZ-QUICKSTART.md
Normal file
322
DAARWIZZ-QUICKSTART.md
Normal file
@@ -0,0 +1,322 @@
|
||||
# DAARWIZZ Quick Start Guide
|
||||
|
||||
**@DAARWIZZBot** is now live and ready to connect to DAGI Stack!
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Bot Information
|
||||
|
||||
- **Username**: [@DAARWIZZBot](https://t.me/DAARWIZZBot)
|
||||
- **Bot ID**: 8323412397
|
||||
- **Token**: `8323412397:AAFxaru-hHRl08A3T6TC02uHLvO5wAB0m3M` ✅ (stored in `.env`)
|
||||
- **Status**: Active ✅
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Quick Start (5 steps)
|
||||
|
||||
### Step 1: Verify Token
|
||||
|
||||
Token already added to `.env`:
|
||||
```bash
|
||||
TELEGRAM_BOT_TOKEN=8323412397:AAFxaru-hHRl08A3T6TC02uHLvO5wAB0m3M
|
||||
```
|
||||
|
||||
**Test bot**:
|
||||
```bash
|
||||
curl "https://api.telegram.org/bot8323412397:AAFxaru-hHRl08A3T6TC02uHLvO5wAB0m3M/getMe"
|
||||
```
|
||||
|
||||
### Step 2: Deploy Services
|
||||
|
||||
```bash
|
||||
cd /opt/dagi-router
|
||||
|
||||
# Build and start Gateway with DAARWIZZ
|
||||
docker-compose up -d --build gateway
|
||||
|
||||
# Start other services if needed
|
||||
docker-compose up -d router rbac
|
||||
|
||||
# Check status
|
||||
docker-compose ps
|
||||
```
|
||||
|
||||
### Step 3: Get Public URL
|
||||
|
||||
**Option A: Using ngrok (for testing)**
|
||||
```bash
|
||||
# Install ngrok
|
||||
sudo snap install ngrok
|
||||
|
||||
# Start tunnel
|
||||
ngrok http 9300
|
||||
|
||||
# Copy https URL (e.g., https://abc123.ngrok.io)
|
||||
```
|
||||
|
||||
**Option B: Using your domain**
|
||||
```
|
||||
https://your-domain.com:9300
|
||||
```
|
||||
|
||||
### Step 4: Set Webhook
|
||||
|
||||
Replace `YOUR_PUBLIC_URL` with your ngrok or domain URL:
|
||||
|
||||
```bash
|
||||
export BOT_TOKEN="8323412397:AAFxaru-hHRl08A3T6TC02uHLvO5wAB0m3M"
|
||||
export PUBLIC_URL="https://abc123.ngrok.io" # or your domain
|
||||
|
||||
curl -X POST "https://api.telegram.org/bot$BOT_TOKEN/setWebhook" \
|
||||
-d "url=$PUBLIC_URL/telegram/webhook" \
|
||||
-d "drop_pending_updates=true"
|
||||
```
|
||||
|
||||
**Expected response**:
|
||||
```json
|
||||
{
|
||||
"ok": true,
|
||||
"result": true,
|
||||
"description": "Webhook was set"
|
||||
}
|
||||
```
|
||||
|
||||
**Verify webhook**:
|
||||
```bash
|
||||
curl "https://api.telegram.org/bot$BOT_TOKEN/getWebhookInfo"
|
||||
```
|
||||
|
||||
### Step 5: Test DAARWIZZ
|
||||
|
||||
1. **Open Telegram** and search for [@DAARWIZZBot](https://t.me/DAARWIZZBot)
|
||||
2. **Send message**: `/start`
|
||||
3. **Send message**: `Привіт! Хто ти?`
|
||||
|
||||
**Expected response**:
|
||||
```
|
||||
Привіт! Я — DAARWIZZ, AI-агент екосистеми DAARION.city.
|
||||
|
||||
Я допомагаю учасникам розібратися з:
|
||||
• microDAO та їх структурою
|
||||
• Ролями і правами доступу (RBAC)
|
||||
• Процесами голосування та пропозиціями
|
||||
• Завданнями та винагородами
|
||||
|
||||
Чим можу допомогти?
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 Monitoring
|
||||
|
||||
### Check Logs
|
||||
|
||||
```bash
|
||||
# Gateway logs (DAARWIZZ)
|
||||
docker-compose logs -f gateway
|
||||
|
||||
# Router logs
|
||||
docker-compose logs -f router
|
||||
|
||||
# All logs
|
||||
docker-compose logs -f
|
||||
```
|
||||
|
||||
**Expected log entries**:
|
||||
```
|
||||
gateway | INFO: DAARWIZZ system prompt loaded (1243 chars)
|
||||
gateway | INFO: Telegram message from user123 (tg:12345): Привіт! Хто ти?
|
||||
gateway | INFO: Sending to Router: agent=daarwizz, dao=greenfood-dao
|
||||
router | INFO: Received request: mode=chat, agent=daarwizz
|
||||
router | INFO: RBAC context: role=member, entitlements=4
|
||||
router | INFO: Routing to llm_local_qwen3_8b
|
||||
router | INFO: Response generated (234 chars, 3.1s)
|
||||
gateway | INFO: Telegram message sent to chat 12345
|
||||
```
|
||||
|
||||
### Health Checks
|
||||
|
||||
```bash
|
||||
# Gateway health
|
||||
curl http://localhost:9300/health
|
||||
|
||||
# Router health
|
||||
curl http://localhost:9102/health
|
||||
|
||||
# RBAC health
|
||||
curl http://localhost:9200/health
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Troubleshooting
|
||||
|
||||
### Issue: Bot not responding
|
||||
|
||||
**Check webhook status**:
|
||||
```bash
|
||||
curl "https://api.telegram.org/bot$BOT_TOKEN/getWebhookInfo"
|
||||
```
|
||||
|
||||
**Check if public URL is accessible**:
|
||||
```bash
|
||||
curl https://your-ngrok-url.ngrok.io/telegram/webhook
|
||||
# Should return: Method Not Allowed (POST expected)
|
||||
```
|
||||
|
||||
**Check Gateway logs**:
|
||||
```bash
|
||||
docker-compose logs gateway | grep ERROR
|
||||
```
|
||||
|
||||
### Issue: Gateway not receiving messages
|
||||
|
||||
**Verify Gateway is running**:
|
||||
```bash
|
||||
docker-compose ps gateway
|
||||
# STATUS should be "Up (healthy)"
|
||||
```
|
||||
|
||||
**Test Gateway directly**:
|
||||
```bash
|
||||
curl -X POST http://localhost:9300/telegram/webhook \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"message": {
|
||||
"message_id": 1,
|
||||
"from": {"id": 12345, "username": "test"},
|
||||
"chat": {"id": 12345, "type": "private"},
|
||||
"text": "Test"
|
||||
}
|
||||
}'
|
||||
```
|
||||
|
||||
### Issue: LLM not responding
|
||||
|
||||
**Check Ollama**:
|
||||
```bash
|
||||
curl http://localhost:11434/api/tags
|
||||
```
|
||||
|
||||
**If Ollama not running**:
|
||||
```bash
|
||||
# Start Ollama
|
||||
ollama serve &
|
||||
|
||||
# Pull model
|
||||
ollama pull qwen3:8b
|
||||
```
|
||||
|
||||
**Check Router config**:
|
||||
```bash
|
||||
cat router-config.yml | grep -A5 llm_local
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎛️ Configuration
|
||||
|
||||
### Bot Settings (via BotFather)
|
||||
|
||||
1. **Set Description** (shown in bot info):
|
||||
```
|
||||
/setdescription @DAARWIZZBot
|
||||
```
|
||||
```
|
||||
DAARWIZZ - Official AI agent for DAARION.city ecosystem.
|
||||
Helps members navigate microDAO processes, roles, and governance.
|
||||
```
|
||||
|
||||
2. **Set About** (shown when starting bot):
|
||||
```
|
||||
/setabouttext @DAARWIZZBot
|
||||
```
|
||||
```
|
||||
I'm DAARWIZZ, your AI guide for DAARION.city microDAOs.
|
||||
Ask me about roles, permissions, proposals, and DAO operations!
|
||||
```
|
||||
|
||||
3. **Set Commands**:
|
||||
```
|
||||
/setcommands @DAARWIZZBot
|
||||
```
|
||||
```
|
||||
start - Start conversation with DAARWIZZ
|
||||
help - Show available commands
|
||||
info - Get your role and permissions
|
||||
docs - View microDAO documentation
|
||||
proposals - List active proposals
|
||||
```
|
||||
|
||||
4. **Set Profile Picture**:
|
||||
- Upload DAARWIZZ logo via `/setuserpic @DAARWIZZBot`
|
||||
|
||||
### Customize DAARWIZZ Personality
|
||||
|
||||
Edit system prompt:
|
||||
```bash
|
||||
nano gateway-bot/daarwizz_prompt.txt
|
||||
```
|
||||
|
||||
Rebuild and restart:
|
||||
```bash
|
||||
docker-compose build gateway
|
||||
docker-compose restart gateway
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📈 Next Steps
|
||||
|
||||
### Phase 4 Enhancements
|
||||
|
||||
1. **Knowledge Base Integration**
|
||||
- Connect DAARWIZZ to microdao-daarion docs
|
||||
- Implement RAG for contextual answers
|
||||
|
||||
2. **Workflow Triggers**
|
||||
- `/onboard` → triggers CrewAI onboarding workflow
|
||||
- `/review` → triggers code review workflow
|
||||
|
||||
3. **Multi-language Support**
|
||||
- Auto-detect user language (UK/EN)
|
||||
- Respond in user's language
|
||||
|
||||
4. **Analytics**
|
||||
- Track usage patterns
|
||||
- Identify common questions
|
||||
- Improve responses iteratively
|
||||
|
||||
---
|
||||
|
||||
## 🔗 Resources
|
||||
|
||||
- **Bot Link**: https://t.me/DAARWIZZBot
|
||||
- **Telegram Bot API**: https://core.telegram.org/bots/api
|
||||
- **DAARWIZZ Docs**: [docs/DAARWIZZ.md](docs/DAARWIZZ.md)
|
||||
- **Gateway Code**: [gateway-bot/http_api.py](gateway-bot/http_api.py)
|
||||
- **System Prompt**: [gateway-bot/daarwizz_prompt.txt](gateway-bot/daarwizz_prompt.txt)
|
||||
|
||||
---
|
||||
|
||||
## ✅ Checklist
|
||||
|
||||
- [x] Bot created (@DAARWIZZBot)
|
||||
- [x] Token stored in .env
|
||||
- [ ] Services deployed (docker-compose up -d)
|
||||
- [ ] Public URL obtained (ngrok or domain)
|
||||
- [ ] Webhook configured
|
||||
- [ ] First dialog tested
|
||||
- [ ] Logs verified
|
||||
- [ ] Bot description set (optional)
|
||||
- [ ] Profile picture uploaded (optional)
|
||||
|
||||
---
|
||||
|
||||
**DAARWIZZ is ready to chat!** 🎉
|
||||
|
||||
Open Telegram → https://t.me/DAARWIZZBot → Start conversation!
|
||||
|
||||
**Version**: 0.2.0
|
||||
**Last Updated**: 2024-11-15
|
||||
Reference in New Issue
Block a user