odoo_store_manager

# Odoo Store Manager

This skill allows you to manage an Odoo Store using the `src/odoo_manager.py` script.

## Core Capabilities

You **MUST** use the terminal to run these commands within the skill directory.

> [!IMPORTANT]
> **Use the correct path based on your installation folder:** `./src/odoo_manager.py`

### 1. Check Sales & Orders
```bash
python3 src/odoo_manager.py check_sales
```
**Use when:** "Any new orders?", "How are sales today?", "Daily report".

### 2. Check Stock / Search Products
```bash
python3 src/odoo_manager.py check_stock --query "PRODUCT NAME OR BARCODE"
```
**Use when:** "Do we have Catan?", "Check stock of X", "Search for X".

### 3. Update Stock
```bash
python3 src/odoo_manager.py update_stock --ref "PRODUCT NAME OR BARCODE" --qty 10
```
**Use when:** "Set stock of X to 10", "Update inventory".

## Critical Rules

1. **Always run the script.** The script securely handles the XML-RPC Odoo API.
2. **Interpret the output.** Read the raw terminal results from Odoo and summarize them conversationally for the user.
3. **Handle errors gracefully.** If the script fails (e.g. wrong credentials), tell the user exactly what went wrong so they can fix their `.env`.

## Initialization Workflow (For the AI Agent)

When a human user installs this skill and asks you to set it up, you MUST proactively integrate it into your memory systems:

1. **Read your Workspace Identity:** Check if `SOUL.md` and `TOOLS.md` exist in your workspace root.
2. **Update `TOOLS.md`:** Write a clear and concise cheat sheet in your `TOOLS.md` file. You can simply copy and append the following block:

```markdown
## 🏪 Odoo Store Manager

This skill manages the Odoo ERP store. All commands must be run from the skill directory.
*Note: Ensure you are using the absolute path to `skills/odoo_store_manager/src/odoo_manager.py` if running from outside the skill folder.*

- **Check Sales / Pending Orders:**
  `python3 skills/odoo_store_manager/src/odoo_manager.py check_sales`

- **Ch...

# Odoo Store Manager for OpenClaw

An OpenClaw skill to seamlessly interact with your Odoo ERP point of sale, sales, and inventory directly from the terminal or via natural language chat.

Query Odoo data including physical store sales, pending web orders, and inventory levels. It also includes an automated Odoo Discuss bot that replies to natural language queries.

## 🚀 Features

- **Store Dashboard:** Check today's Point of Sale (POS) revenue and pending Web Orders.
- **Inventory Check:** Quickly find the physical and forecasted stock of any product by barcode or name.
- **Stock Updates:** Manually adjust physical inventory right from OpenClaw.
- **Odoo Chat Bot:** Launch the `odoo_listener.py` to get an AI assistant right inside your Odoo Discuss channels.

## 📋 Security & Requirements

This skill handles live store data. 
- **Read-only by default:** Reporting commands are safe.
- **Stock adjustments are destructive:** The `update_stock` command modifies live inventory. Use carefully!

### Dependencies
No extra packages are needed if your Python environment already has standard libraries (`xmlrpc.client`, `ssl`).

## ⚙️ Installation & Setup

1. Copy the `odoo_store_manager` folder into your OpenClaw `skills` directory.
2. In the `odoo_store_manager` folder, duplicate `.env.example` and rename it to `.env`:
   ```bash
   cp .env.example .env
   ```
3. Edit the `.env` file with your Odoo connection details:

| Variable | Description | Secret |
| :--- | :--- | :--- |
| `ODOO_URL` | Your Odoo URL (e.g., https://my-odoo.com) | No |
| `ODOO_DB` | Database name | No |
| `ODOO_USER` | Login email / username | No |
| `ODOO_PASSWORD` | Odoo Password or External API Key | Yes |
| `ODOO_BOT_ID` | Partner ID for the chat bot to reply from | No |

## 🎮 Usage Examples (Chat)

Once installed, just ask OpenClaw naturally:

* "How are the sales doing today?"
* "Do we have any pending web orders to ship?"
* "Check if we have Catan in stock"
* "Set the stock of product 8412345678...