microdao-daarion/DAARWIZZ-QUICKSTART.md

DAARWIZZ Quick Start Guide

@DAARWIZZBot is now live and ready to connect to DAGI Stack!

---

🎯 Bot Information

• Username: @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:

TELEGRAM_BOT_TOKEN=8323412397:AAFxaru-hHRl08A3T6TC02uHLvO5wAB0m3M

Test bot:

curl "https://api.telegram.org/bot8323412397:AAFxaru-hHRl08A3T6TC02uHLvO5wAB0m3M/getMe"

Step 2: Deploy Services

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)

# 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:

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:

{
  "ok": true,
  "result": true,
  "description": "Webhook was set"
}

Verify webhook:

curl "https://api.telegram.org/bot$BOT_TOKEN/getWebhookInfo"

Step 5: Test DAARWIZZ

1. Open Telegram and search for @DAARWIZZBot
2. Send message: /start
3. Send message: Привіт! Хто ти?

Expected response:

Привіт! Я — DAARWIZZ, AI-агент екосистеми DAARION.city.

Я допомагаю учасникам розібратися з:
• microDAO та їх структурою
• Ролями і правами доступу (RBAC)
• Процесами голосування та пропозиціями
• Завданнями та винагородами

Чим можу допомогти?

---

📊 Monitoring

Check Logs

# 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

# 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:

curl "https://api.telegram.org/bot$BOT_TOKEN/getWebhookInfo"

Check if public URL is accessible:

curl https://your-ngrok-url.ngrok.io/telegram/webhook
# Should return: Method Not Allowed (POST expected)

Check Gateway logs:

docker-compose logs gateway | grep ERROR

Issue: Gateway not receiving messages

Verify Gateway is running:

docker-compose ps gateway
# STATUS should be "Up (healthy)"

Test Gateway directly:

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:

curl http://localhost:11434/api/tags

If Ollama not running:

# Start Ollama
ollama serve &

# Pull model
ollama pull qwen3:8b

Check Router config:

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:

nano gateway-bot/daarwizz_prompt.txt

Rebuild and restart:

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
• Gateway Code: gateway-bot/http_api.py
• System Prompt: gateway-bot/daarwizz_prompt.txt

---

✅ Checklist

• Bot created (@DAARWIZZBot)
• 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