Talk2Stock OpenClaw Plugin

OpenClaw plugin that lets AI agents manage your Talk2Stock inventory and orders through the Talk2Stock REST API.

Build

cd extensions/talk2stock-openclaw
pnpm install
pnpm build

Install from ClawHub

openclaw install clawhub:@banyawat/talk2stock-openclaw-plugin

Configure

After installation, set the API base URL and your Talk2Stock API key:

openclaw config set plugins.entries.talk2stock.config.apiBaseUrl "https://api.talk2stock.co"
openclaw config set plugins.entries.talk2stock.config.apiKey "your-api-key-here"

Then restart your OpenClaw gateway so the plugin picks up the new config.

Local Development Install

For in-repo bundled plugin work, OpenClaw discovers source-checkout plugin packages from the extensions/* workspace. Link or copy this directory to your OpenClaw extensions path:

mkdir -p ~/.openclaw/extensions
ln -s "$(pwd)" ~/.openclaw/extensions/talk2stock

Then enable it and set your API key in ~/.openclaw/openclaw.json:

{
  "plugins": {
    "enabled": true,
    "entries": {
      "talk2stock": {
        "enabled": true,
        "config": {
          "apiBaseUrl": "https://api.talk2stock.co",
          "apiKey": "tsk_your_api_key_here"
        }
      }
    }
  }
}

Getting an API Key

1. Open the Talk2Stock webapp
2. Go to Settings > API Keys
3. Generate a new key
4. Copy the key (starts with tsk_) into the plugin config

Naming Strategy

Important: The plugin parameter names are intentionally generic/worldwide-friendly, while the underlying API field names remain Thailand-specific for backward compatibility.

Example: the plugin uses domestic_shipping (generic), but the API receives thai_shipping (Thailand-specific). When we eventually migrate the API to worldwide-friendly names, only the mapping layer in client.ts needs to change — the plugin tool schemas stay the same.

Always follow this pattern: plugin parameters = generic names, API payload = legacy names with mapping in the client layer.

Tools

The plugin registers the following tools for OpenClaw agents:

• talk2stock_list_inventory — List products and stock levels
• talk2stock_search_inventory — Search products by name/SKU
• talk2stock_get_product — Get product details by SKU
• talk2stock_list_stock_batches — View stock batch history
• talk2stock_get_inventory_movements — View inventory movements
• talk2stock_create_order — Create a new customer order from SKUs
• talk2stock_calculate_order — Preview order totals before saving (SKUs)
• talk2stock_create_order_by_name — Create a new customer order from product names and customer name
• talk2stock_calculate_order_by_name — Preview an order from product names and customer name
• talk2stock_list_orders — List recent orders
• talk2stock_get_order — Get order details by order number
• talk2stock_ship_order — Ship an order with a tracking number (requires order number)
• talk2stock_ship_order_by_name — Ship an order by customer name and tracking number
• talk2stock_cancel_order — Cancel an order
• talk2stock_create_supply_order — Create a supply order
• talk2stock_calculate_supply_order — Preview supply order before saving
• talk2stock_list_supply_orders — List supply orders
• talk2stock_get_supply_order — Get supply order details
• talk2stock_mark_in_transit_supply_order — Mark supply order as in-transit
• talk2stock_receive_supply_order — Receive supply order into inventory (optionally with domestic_shipping)
• talk2stock_get_daily_report — Get today's sales summary

Example Usage

After installation, ask OpenClaw:

"How much stock do I have for SKU LW0001?" "Create an order for Somchai, phone 081-234-5678, 2x LW0001 at 1500 each." "Somchai wants 2 brown wallets." "Ship Somchai's brown wallet order with tracking SP1234567890." "Ship order JTO-20260530-143022-001 with tracking SP1234567890."

License

MIT