How dgatom/dg-claw works
DG Claw runs self-hosted AI agents behind a web chat: a browser reaches the authenticated Web service, which routes messages to the appropriate persistent runner and its Claude Code or Codex session; replies return through the same path. The repository also includes agent administration, isolated agent resources, optional WhatsApp, document anonymization, and operational features such as task visibility, semantic memory, health checks, and emergency support. Unsampled subsystems are included where README capabilities establish their role; their internal wiring is not inferred.
Main entry points: panel/server.js Agent panel · web/server.js DG Claw Web · servidor.ts Agent runner · conversa.js Web conversation
Components 23
Web access
- DG Claw Web
web/server.js - Web authentication
web/lib/auth.js - Agent panel
panel/server.js - Panel authentication
panel/lib/auth.js - Web conversation
web/lib/conversa.js - Panel conversation
panel/lib/conversa.js
Agents and sessions
- Agent runner
runner/src/servidor.ts - Session manager
runner/src/sessoes.ts - Isolated agent container
- Per-agent key vault
web/lib/cofre-agente.js
Agent operations
- Agent applications
panel/lib/apps.js - Task desk
web/lib/mesa.js - Semantic memory
scripts/memory_index - Health and safe mode
panel/lib/saude.js - Emergency support
panel/lib/socorro.js
User channels
- WhatsApp bridge
canais/whatsapp/ponte.mjs
Product capabilities
- Document anonymization
anonimizar/documentos.py - Office document handling
anonimizar/ooxml.py - Hidden display mode
web/lib/anonimizar.js
Other components
- Browser user
- HTTPS proxy
- Claude Code or Codex
- WhatsApp user
Connections 23
- Browser user → HTTPS proxy: sends HTTPS
- HTTPS proxy → DG Claw Web: forwards requests
- DG Claw Web → Web authentication: authenticates
web/server.js - DG Claw Web → Web conversation: routes chat
web/server.js - DG Claw Web → Agent runner: forwards messages
- Agent runner → Session manager: manages sessions
runner/src/index.ts - Session manager → Claude Code or Codex: runs session
- Agent runner → Isolated agent container: runs inside
- Web conversation → Browser user: returns replies
- Agent panel → Panel authentication: authenticates
panel/server.js - Agent panel → Panel conversation: routes conversation
panel/server.js - Agent panel → Agent applications: serves app data
panel/server.js - Agent applications → Isolated agent container: reads agent files
- Isolated agent container → Per-agent key vault: uses isolated vault
- Agent panel → Task desk: shows task status
- Agent panel → Semantic memory: offers memory search
- Agent panel → Health and safe mode: checks agent health
- Agent panel → Emergency support: offers recovery guidance
- WhatsApp user → WhatsApp bridge: sends messages
- WhatsApp bridge → Agent runner: delivers messages
- DG Claw Web → Document anonymization: offers anonymization
- Document anonymization → Office document handling: handles Office formats
anonimizar/documentos.py - DG Claw Web → Hidden display mode: provides hidden mode
web/server.js