> For the complete documentation index, see [llms.txt](https://docs.dos.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dos.ai/dosclaw/readme.md). # DOSClaw Overview **Autonomous multi-channel AI agent runtime powered by OpenClaw with isolated container execution, tool bindings, and omnichannel messaging.** DOSClaw is DOS.AI's enterprise-grade autonomous agent platform. It provisions, orchestrates, and monitors containerized AI agents that operate 24/7 across multiple communication channels—including Telegram, Zalo Official Account (OA), Facebook Messenger, Discord, Slack, WhatsApp, and Lark / Feishu. *** ## High-Level Architecture Each DOSClaw agent runs inside a dedicated, isolated Docker container powered by the **OpenClaw** multi-agent operating system. Containers are managed across a distributed Docker host fleet via a lightweight, authenticated Status API. ``` ┌────────────────────────────────────────────────────────┐ │ Go API Gateway (Cloud Run) │ │ Routing · Metering · Billing · Lifecycle CRUD │ └───────────────────────────┬────────────────────────────┘ │ Cloudflare Zero Trust Tunnel ──┼── Bearer-Authed Control Plane ▼ ┌───────────────────────────────────────────────────────────────────────────────────────────────────┐ │ Docker Host Fleet (Mumbai Lambda / GCP Singapore / Local Canary) │ │ │ │ ┌────────────────────────────────────────────────────────────────────────────────────────────┐ │ │ │ Node.js Status API (:18090) │ │ │ │ Container CRUD · Volume Uploads · Metrics · Exec Allowlist │ │ │ └───────────────────────────────────────────┬────────────────────────────────────────────────┘ │ │ │ │ │ ┌─────────────────────────────┴─────────────────────────────┐ │ │ ▼ ▼ │ │ ┌───────────────────────────┐ ┌───────────────────────────┐ │ │ │ Agent Container (Em Huyền)│ │ Agent Container (Shop A) │ │ │ │ ├── OpenClaw Runtime │ │ ├── OpenClaw Runtime │ │ │ │ ├── /workspace (Volume) │ │ ├── /workspace (Volume) │ │ │ │ ├── Local loopback ws/http│ │ ├── Local loopback ws/http│ │ │ │ └── dos-grounding plugin │ │ └── dos-grounding plugin │ │ │ └───────────────────────────┘ └───────────────────────────┘ │ │ │ └───────────────────────────────────────────────────────────────────────────────────────────────────┘ ``` *** ## Core System Documentation | Section | Description | | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | | [Architecture & Runtime](/dosclaw/architecture-and-system/architecture.md) | Container fleet architecture, volume lifecycle, health probing, and auto-restart | | [Workspace Files & Prompts](/dosclaw/architecture-and-system/workspace-files.md) | Standard workspace files (`SOUL.md`, `IDENTITY.md`, `MEMORY.md`), template contracts, and dynamic compilation | | [Tools & Action Invariants](/dosclaw/architecture-and-system/tools-and-actions.md) | Action invariants, tool grounding, safe recovery loops, and MCP schema standards | *** ## Messaging Channels DOSClaw connects your AI agents directly to customer inboxes, team workspaces, and social platforms: | Channel | Key Capabilities | Guide | | ---------------------- | --------------------------------------------------- | ------------------------------------------------- | | **Zalo OA** | Follower sync, human takeover, interactive cards | [Zalo OA Guide](/dosclaw/channels/zalo.md) | | **Telegram** | Group chats, MarkdownV2 formatting, instant pairing | [Telegram Guide](/dosclaw/channels/telegram.md) | | **Facebook Messenger** | Page inbox, comment-to-inbox auto-reply | [Messenger Guide](/dosclaw/channels/messenger.md) | | **Discord** | Server moderation, threads, role-based access | [Discord Guide](/dosclaw/channels/discord.md) | | **Slack** | Team assistant, Block Kit messages, mentions | [Slack Guide](/dosclaw/channels/slack.md) | | **WhatsApp** | Global reach, end-to-end encrypted concierge | [WhatsApp Guide](/dosclaw/channels/whatsapp.md) | | **Lark / Feishu** | Enterprise chat, interactive card actions | [Lark Guide](/dosclaw/channels/lark.md) | For setup instructions and event flow architecture, see the [Messaging Channels Overview](/dosclaw/channels/overview.md). *** ## Plugins & MCP Connectors Equip your AI agents with real-time business actions, database queries, and third-party integrations: * **E-Commerce**: [Haravan](/dosclaw/plugins-and-connectors/ecommerce/haravan.md), [Shopee](/dosclaw/plugins-and-connectors/ecommerce/shopee.md), [TikTok Shop](/dosclaw/plugins-and-connectors/ecommerce/tiktokshop.md), [Shopify](/dosclaw/plugins-and-connectors/ecommerce/shopify.md), [KiotViet](/dosclaw/plugins-and-connectors/ecommerce/kiotviet.md), [WooCommerce](/dosclaw/plugins-and-connectors/ecommerce/woocommerce.md). * **CRM & Marketing**: [HubSpot](/dosclaw/plugins-and-connectors/crm/hubspot.md), [Salesforce](/dosclaw/plugins-and-connectors/crm/salesforce.md), [Crove Post](/dosclaw/plugins-and-connectors/crm/crove-post.md), [NueLink](/dosclaw/plugins-and-connectors/crm/nuelink.md), [WordPress](/dosclaw/plugins-and-connectors/crm/wordpress.md), [Meta Ads](/dosclaw/plugins-and-connectors/crm/meta.md). * **Finance & Invoicing**: [MISA Enterprise Suite](/dosclaw/plugins-and-connectors/finance/misa.md), [FinOne / Vbill](/dosclaw/plugins-and-connectors/finance/finone-vbill.md), [Stripe Payments](/dosclaw/plugins-and-connectors/finance/stripe.md). * **Productivity & Developer**: [Google Workspace](/dosclaw/plugins-and-connectors/productivity/google-workspace.md), [GitHub](/dosclaw/plugins-and-connectors/productivity/github.md), [Notion](/dosclaw/plugins-and-connectors/productivity/notion.md), [Brave Search Engine](/dosclaw/plugins-and-connectors/productivity/brave-search.md). For authentication, connection binding, and caching details, see the [Connectors Directory Overview](/dosclaw/plugins-and-connectors/overview.md). *** ## Quickstart: Deploy Your First Agent 1. **Create an Agent**: Open the [DOS.AI Dashboard](https://app.dos.ai/agents) and click **Create Agent**. 2. **Configure Persona & System Instructions**: Provide your bot's identity, target audience, and guidelines. DOSClaw automatically compiles these into standardized workspace files. 3. **Connect a Channel**: Navigate to the **Channels** tab and connect Telegram, Zalo OA, Messenger, or your preferred messaging app. 4. **Attach Connectors & Skills**: Enable web search (Brave Search), CRM, or e-commerce tools from the **Tools & Skills** catalog. 5. **Start Chatting**: Send a message to your bot on your connected channel or test live inside the dashboard playground! --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.dos.ai/dosclaw/readme.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.