> 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/plugins-and-connectors/overview.md).

# Overview

DOSClaw Connectors allow your AI agents to query live data, perform actions, and integrate business workflows with external platforms—including e-commerce stores, CRMs, social scheduling tools, accounting software, and developer services.

## How Connectors Work

```
User in Chat
     │
     ▼
[AI Agent] ─── Decides to call tool (e.g. search_products)
     │
     ▼
[DOSClaw Model Context Protocol (MCP) Runtime]
     │
     ▼
[Connector Cache Shield] (Singleflight + In-memory TTL Cache)
     │
     ▼
[DOS-Me Vault] (Secure OAuth Tokens & API Credentials)
     │
     ▼
[Third-Party Service API] (Haravan, Shopee, HubSpot, etc.)
```

### Two-Layer Security & Connection Architecture

Following the DOS Platform security model:

1. **Authentication & Token Storage (`DOS-Me`)**: OAuth connections, API tokens, and secret credentials are encrypted and stored in `public.provider_connections` and secured in the DOS-Me Vault. Raw secrets are never exposed to browser clients, agent containers, or LLM reasoning prompts.
2. **Agent Binding & Governance (`DOS.AI`)**: Individual AI agents are bound to provider connections via `dosai.agent_connection_bindings`. Workspace admins specify:
   * **Enabled Tools**: Selectively turn on or off specific capabilities (e.g. allow `search_products` and `check_order_status`, but disable `create_order`).
   * **Governance Policy**:
     * `autonomous`: Agent executes allowed read and write tools automatically.
     * `approval_required`: Agent prepares action parameters and requests human confirmation before mutating data.
     * `draft_only`: Agent can only read and prepare drafts; never commits live records.

***

## Connector Directory

### E-Commerce & Retail

* [Haravan Omnichannel](/dosclaw/plugins-and-connectors/ecommerce/haravan.md) — Vietnam retail, inventory, orders, customer sync.
* [Shopee Open Platform](/dosclaw/plugins-and-connectors/ecommerce/shopee.md) — SEA marketplace product lookup, live shipping, stock.
* [TikTok Shop](/dosclaw/plugins-and-connectors/ecommerce/tiktokshop.md) — Video commerce, live stream product specs, order status.
* [Shopify Storefront & Admin](/dosclaw/plugins-and-connectors/ecommerce/shopify.md) — Global e-commerce catalog, cart assistance, order lookup.
* [KiotViet Retail POS](/dosclaw/plugins-and-connectors/ecommerce/kiotviet.md) — Vietnam retail POS, branch stock, offline-to-online sync.
* [WooCommerce](/dosclaw/plugins-and-connectors/ecommerce/woocommerce.md) — Open-source WordPress store integration.

### CRM & Marketing

* [HubSpot CRM](/dosclaw/plugins-and-connectors/crm/hubspot.md) — Inbound contacts, companies, deals, pipelines.
* [Salesforce Enterprise CRM](/dosclaw/plugins-and-connectors/crm/salesforce.md) — Enterprise accounts, leads, opportunities, cases.
* [Crove Post](/dosclaw/plugins-and-connectors/crm/crove-post.md) — Multi-platform social scheduler and campaign analytics.
* [NueLink](/dosclaw/plugins-and-connectors/crm/nuelink.md) — Cross-platform social publishing automation.
* [WordPress Direct CMS](/dosclaw/plugins-and-connectors/crm/wordpress.md) — Blog post drafting, SEO metadata, media uploads.
* [Meta Ads & Lead Ads](/dosclaw/plugins-and-connectors/crm/meta.md) — Real-time lead form webhook, instant follow-up, CAPI.

### Finance & Invoicing

* [MISA Enterprise Suite](/dosclaw/plugins-and-connectors/finance/misa.md) — meInvoice, Inbound E-Invoice, ASP, AMIS Accounting, WeSign, eSign.
* [FinOne / Vbill](/dosclaw/plugins-and-connectors/finance/finone-vbill.md) — Revenue statistics, reconciliation, QR payment generation.
* [Stripe Payments](/dosclaw/plugins-and-connectors/finance/stripe.md) — Instant checkout links, subscription verification.

### Productivity & Developer

* [Google Workspace](/dosclaw/plugins-and-connectors/productivity/google-workspace.md) — Google Sheets, Calendar & Meet, Drive documents.
* [GitHub](/dosclaw/plugins-and-connectors/productivity/github.md) — Issue triage, PR summaries, commit history.
* [Notion](/dosclaw/plugins-and-connectors/productivity/notion.md) — Company wiki search, database queries, meeting notes.

***

## Connector Cache Shield

High-traffic bots serving peak concurrent customer queries benefit from the built-in **Connector Cache Shield**:

* **Singleflight Requests**: Prevents thundering herds by de-duplicating simultaneous requests for identical resources (e.g. 50 customers asking about the same flash-sale product).
* **Fast Read Cache**: Safe read operations (product searches, category lists) are cached in memory for sub-10ms response times.
* **Fail-Closed Write Safety**: Write and mutation operations (`create_order`, `refund`) always bypass the cache with strict idempotency keys.


---

# 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/plugins-and-connectors/overview.md?ask=<question>&goal=<endgoal>
```

`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.
