> 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 (GCP Singapore VM dos / Beta VM dosclaw-beta) │ │ │ │ ┌────────────────────────────────────────────────────────────────────────────────────────────┐ │ │ │ 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` 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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.