Mall Shopping Plugin

Native OpenClaw plugin for Uniclaw shared pods. It exposes mall product tools backed by the mall MCP server over Streamable HTTP.

Tools

• mall-shopping__search_products maps to MCP tool search_products.
• Search results promote product jump payloads into products[].detail_url and reply_markdown so agents can show direct Markdown links.
• mall-shopping__get_product_detail maps to MCP tool get_product_detail. The current mall MCP phase returns PRODUCT_NOT_FOUND.
• mall-shopping__prepare_cart_checkout maps to MCP tool prepare_cart_checkout. The current mall MCP phase returns SKU_NOT_FOUND; agents should prefer product jump links from search results.

Configuration

Recommended shared-pod configuration keeps credentials in environment variables:

{
  "plugins": {
    "entries": {
      "plugin-mall-shopping": {
        "enabled": true,
        "config": {
          "mallShopping": {
            "endpointEnv": "UNICLAW_MALL_MCP_ENDPOINT",
            "appIdEnv": "UNICLAW_MALL_MCP_APP_ID",
            "appSecretEnv": "UNICLAW_MALL_MCP_APP_SECRET",
            "timeoutMs": 20000,
            "maxAttempts": 3
          }
        }
      }
    }
  }
}

For local tests only, direct values are also supported:

{
  "mallShopping": {
    "endpoint": "https://mall-mcp.example.com/mcp",
    "appId": "d8frrg4o6slopn0gphug",
    "appSecret": "***"
  }
}

The plugin signs every request with the mall MCP HMAC protocol using the exact JSON bytes sent on the wire. It automatically performs initialize, sends notifications/initialized, caches Mcp-Session-Id, and reinitializes once when the MCP session is rejected.

Deployment

1. Publish @dai_ming/[email protected].
2. Run sql/033_mall_shopping_plugin.sql in the target gateway database.
3. Configure UNICLAW_MALL_MCP_ENDPOINT, UNICLAW_MALL_MCP_APP_ID, and UNICLAW_MALL_MCP_APP_SECRET in OpenClaw pod environment values.
4. Rebuild the managed image from DB plugin registry state and redeploy shared pods.

Gateway-only deployment is not enough because runtime plugin packages are baked into managed images.