OdooPilot — AI Chatbot for Odoo | Telegram & WhatsApp
by OdooPilot Contributors https://github.com/arunrajiah/odoopilot| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 1977 |
| Technical Name |
odoopilot |
| License | LGPL-3 |
| Website | https://github.com/arunrajiah/odoopilot |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 1977 |
| Technical Name |
odoopilot |
| License | LGPL-3 |
| Website | https://github.com/arunrajiah/odoopilot |
OdooPilot
Query live Odoo data and take real actions via Telegram and WhatsApp
— in plain language, with a safety confirmation before every write.
Completely free. Self-hosted. No cloud dependency. No SaaS fees. Ever.
Powered by Anthropic Claude · OpenAI GPT-4 · Groq (free tier) · Ollama (local AI)
100% Free — forever
No purchase, no subscription, no vendor lock-in. Competitors charge EUR 200–355 for read-only access to a single channel. OdooPilot is LGPL-3 open-source — install, fork, customise freely.
Write actions, not just queries
Every competing free Odoo AI tool is read-only. OdooPilot can confirm sale orders, approve leaves, move CRM stages, and create leads — with a mandatory Yes / No safety gate before any record changes.
Both channels: TG & WhatsApp
Telegram Bot and WhatsApp Cloud API — full feature parity on both. No other free Odoo AI app supports even one external channel. Your team uses whichever app they already have.
Your data stays on your server
Pure Odoo addon. No Docker, no separate Python service, no cloud backend. API keys never leave your server. Run Ollama for 100% local AI — zero data leaves your infrastructure.
Domains
TG + WA
incl. local AI
supported
to first chat
forever
Your Odoo ERP — answerable on any channel
Type a question in Telegram or WhatsApp. OdooPilot reads your live Odoo data and replies in seconds. Write actions — like confirming a sale order or approving a leave — require your explicit Yes / No approval before touching any record.
Total: EUR 14,320
Oldest: Acme Corp — 42 days
Acme Corp — EUR 4,800?
[!] Update product catalogue
[-] Review Q2 sales report
[-] Onboard new supplier
Jane Smith (Mon – Wed)?
8 Business Domains — natural language, zero training required
OdooPilot maps plain-language questions directly to live Odoo data. No forms to configure, no reports to build. Just ask — from Telegram or WhatsApp.
Projects & Tasks
“Show my open tasks” · “What’s due this week?” · “Mark task X as done”
CRM & Opportunities
“List my pipeline” · “Move deal to Won” · “Create new lead for Acme Corp”
Invoices & Accounting
“Show overdue invoices” · “Total outstanding balance” · “Oldest unpaid bill”
Sales Orders
“List draft orders” · “Confirm SO-0042” · “Revenue this month”
Inventory & Stock
“Check stock for Widget A” · “Which products are out of stock?”
Purchase Orders
“Show pending RFQs” · “Supplier deliveries this week”
HR & Employees
“List employees in Sales” · “Who’s in the engineering team?”
Leaves & Time Off
“Show pending approvals” · “Approve Jane’s leave” · “My leave balance”
Not just read-only — take real Odoo actions, safely
The only free Odoo AI assistant that lets you write back to Odoo directly from Telegram or WhatsApp. Every mutating action triggers an inline Yes / No confirmation before touching any record.
Mark Task Done
Complete any project task directly from chat, without opening Odoo.
Confirm Sale Order
Move draft sales orders to confirmed state with a single chat message.
Approve Leave
Validate or refuse employee leave requests without logging into Odoo.
Move CRM Stage
Progress opportunities through your pipeline pipeline from chat.
Create CRM Lead
Create new leads or opportunities for any contact, directly from a message.
Who is it for?
OdooPilot is built for the employees who live in Telegram and WhatsApp all day — and shouldn’t have to open Odoo just to check a status or approve a request.
Sales & Account Managers
On a customer call and need your pipeline or latest invoice status? Ask in Telegram. Confirm the sale order before you hang up — without touching the laptop.
HR & Team Managers
Someone messages you about their leave — check their balance and approve it right from WhatsApp. See who is out this week without logging into Odoo at all.
Finance & Operations
Wake up to an automatic WhatsApp summary of every overdue invoice. Ask for a specific customer balance mid-meeting. Get stock availability before promising a delivery.
Project & Operations Leads
Ask what tasks are overdue on any project, mark a task done after a standup, or check supplier delivery status — all without switching out of your messaging app.
Multi-language AI replies NEW v17.0.6
Each user sets their preferred reply language with a single bot command. OdooPilot instructs the LLM to always respond in that language — no admin configuration required. Supports 15 languages out of the box.
Proactive push alerts — no polling required
OdooPilot doesn’t wait for users to ask. It proactively delivers important updates to each user’s Telegram or WhatsApp every morning via Odoo scheduled actions.
You have 2 overdue and 3 due today:
[!] Update product catalogue — E-Commerce — overdue
[!] Q1 invoice reconciliation — Finance — overdue
[-] Supplier call — Acme Corp
[-] Review new hire onboarding
[-] Ship pending orders (3 items)
Reply with a question or action — e.g. “mark the first task done”
• INV/2024/0031 — Beta Ltd — EUR 2,100 (due 15 Mar)
• INV/2024/0028 — Gamma AG — EUR 4,800 (due 12 Mar)
… and 5 more
Reply “show overdue invoices” for the full list.
Daily task digest — 08:00 UTC
Each linked user receives their overdue + today’s tasks every morning via Telegram or WhatsApp. Skipped automatically when nothing is due — no noise.
Overdue invoice alerts — 09:00 UTC
Users with accounting access receive a daily overdue invoice summary. Automatically skipped for users without the Accounting group.
Fully configurable
Scheduled actions are standard Odoo cron jobs — adjust timing, frequency, or recipients directly from the Odoo Technical menu. No code changes required.
Choose your AI engine — bring your own key
OdooPilot supports all major LLM providers. Your API key, your data, no middleman. Switch providers at any time from Odoo Settings. No SDK dependencies — provider APIs are called directly via Python requests.
claude-sonnet-4
claude-opus-4
gpt-4o
gpt-4-turbo
-versatile
endpoint
How It Works — 4 steps
Unlike SaaS AI integrations, OdooPilot is a single self-contained Odoo addon. No separate server, no Docker container, no subscription, no data sent to a middleman.
Webhook delivery
User sends a Telegram or WhatsApp message. The platform calls your Odoo webhook with token/HMAC validation. Processed asynchronously in a background thread.
Identity & session lookup
Odoo matches the chat ID to the linked Odoo user. The AI agent runs as that user, inheriting their Odoo access rights automatically.
Agentic LLM tool loop
The question is sent to your chosen LLM. It selects the right Odoo ORM tools in a multi-turn agent loop. Read tools execute immediately; write tools pause for inline confirmation.
Reply + audit log
The answer is sent back to the user. Every tool call is recorded in the immutable OdooPilot audit log: user, tool, arguments, result, and timestamp.
Up and running in 5 minutes
No extra server. No Docker. No additional Python packages. No infrastructure.
Install the addon
Copy odoopilot/ into your Odoo addons path and run -u odoopilot, or install from the Odoo App Store. No extra pip packages required.
Create your bot
Telegram: message @BotFather → /newbot → copy token.
WhatsApp: create a Meta app, note your Phone Number ID and Access Token.
Add your LLM key
Get a key from Anthropic, OpenAI, or Groq. Groq’s free tier requires no credit card — ideal for getting started.
Paste & activate
Go to Settings → OdooPilot. Enter your bot credentials and LLM key, then click Register Webhook. Start chatting immediately.
How OdooPilot compares
The only free, open-source Odoo AI agent with dual-channel support, write-action capability, multi-language replies, and proactive push notifications.
| Feature | OdooPilot | Paid AI Copilot ~EUR 256 |
Paid AI Chatbot ~EUR 200 |
AI Analytics ~EUR 355 |
|---|---|---|---|---|
| Price | Free (LGPL-3) | EUR 256 one-time | EUR 200 one-time | EUR 355 one-time |
| Odoo 17 Community | ✓ Yes | ∼ Mixed | ∼ Mixed | ∼ Mixed |
| Telegram bot | ✓ Native | ✗ No | ✗ No | ✗ No |
| WhatsApp bot | ✓ Cloud API | ✗ No | ✓ Yes | ✗ No |
| Write actions (confirm orders, approve leaves) | ✓ 5 write tools | ✗ Read-only | ✗ Read-only | ✗ Read-only |
| Proactive push notifications | ✓ Tasks + invoices | ✗ No | ✗ No | ✗ No |
| Multi-LLM (Claude, GPT-4, Groq, Ollama) | ✓ 4+ providers | ∼ OpenAI + Gemini | ∼ OpenAI only | ∼ OpenAI + Gemini |
| Multi-language replies (15 languages) | ✓ /language command | ✗ No | ✗ No | ✗ No |
| Self-hosted — no external service | ✓ Pure Odoo addon | ∼ May need cloud | ∼ May need cloud | ∼ May need cloud |
| Confirmation gate for write actions | ✓ Inline Yes / No | ✗ N/A | ✗ N/A | ✗ N/A |
| Immutable audit trail | ✓ Full log | ∼ Basic | ✗ No | ∼ Basic |
| Open-source license | ✓ LGPL-3 | ✗ OPL | ✗ OPL | ✗ OPL |
| Employee-facing (not customer-facing) | ✓ Employee AI agent | ∼ Both | ✗ Customer-facing | ✗ Customer-facing |
Frequently Asked Questions
Everything you need to know before installing OdooPilot.
-
Does this work with Odoo 17 Community Edition?Yes. OdooPilot is built specifically for Odoo 17 Community and requires no Enterprise licence. It depends only on mail, base_setup, and web — modules included in every Odoo install.
-
Does it work on Odoo.sh or Odoo Online?Odoo.sh: yes — install like any standard addon. Odoo Online (odoo.com SaaS): not supported, as Odoo Online does not allow custom addon installation. OdooPilot requires a self-hosted or Odoo.sh instance accessible from the internet for webhook delivery.
-
Which messaging channels are supported?Both Telegram (Bot API webhook) and WhatsApp (Meta WhatsApp Cloud API) are supported with full feature parity — including the /link identity flow, write-action confirmations, proactive notifications, and multi-language support. Both channels can be active simultaneously.
-
Which AI / LLM providers are supported?Anthropic Claude (claude-3-5-haiku, claude-opus-4, claude-sonnet-4), OpenAI ChatGPT / GPT-4 (gpt-4o, gpt-4o-mini, gpt-4-turbo), Groq (llama-3.3-70b-versatile — free tier), and any OpenAI-compatible endpoint including Ollama for a fully local, private AI deployment. No SDKs required.
-
How does multi-language support work?Send /language fr in Telegram or WhatsApp to set French as your reply language. OdooPilot stores the preference in the Odoo identity record and instructs the LLM to always respond in that language. Send /language auto to revert to auto-detect. Administrators can set language per user in the Odoo backend.
-
Do I need all Odoo modules installed?No. OdooPilot detects which modules are installed and activates only the relevant tools. No CRM installed? CRM tools are silently skipped. No HR module? Leave tools are hidden. No errors — no manual configuration required.
-
Is my Odoo data sent to a third party?Only the user’s question and the Odoo data retrieved by the AI tools are sent to your chosen LLM provider. Nothing is sent to OdooPilot — because there are no OdooPilot servers. For complete data privacy, use Ollama: then no data leaves your server at all.
-
Which LLM is recommended for production use?Anthropic Claude 3.5 Haiku offers the best balance of speed and accuracy (~$0.001 per conversation). For zero API cost, Groq’s free tier (Llama 3.3 70B) works well. For complete data privacy, Ollama with a local model means no data leaves your server.
-
Can I add custom tools for my own Odoo models?Yes. The tool registry in services/tools.py is designed to be extended. Add a function, register it in TOOL_DEFINITIONS, and it is immediately available in the AI agent. The module is fully open-source (LGPL-3) — fork and customise freely.
Resources & Contact
Everything you need to get started, contribute, or get help.
▶ Documentation
→ GitHub README → CHANGELOG.md → GitHub Issues — Report a bug → GitHub Discussions — Ask & share▶ Community
→ github.com/arunrajiah/odoopilotOdooPilot is free — powered by sponsors
Solo open-source project — no VC funding, no SaaS revenue, no enterprise tier. If OdooPilot saves your team time every day, please consider sponsoring. Even $5 / month helps keep the project alive and growing.
Cancel anytime · No lock-in · Managed via GitHub Sponsors
LGPL-3 open-source · Odoo AI agent · Telegram & WhatsApp · Multi-LLM · Built for the Odoo Community
GitHub Discussions Report Issue Changelog
Please log in to comment on this module