Prerequisites

• Odoo 18.0 or higher
• OpenClaw Gateway server (external platform)
• Internet connection for webhook communication

Create a Bot

1. Navigate to OpenClaw > Bots
2. Click "Create"
3. Fill in the required fields:
   • Bot Name: Display name for the bot
   • Bot Code: Unique identifier (alphanumeric only)
   • Description: Optional description
4. Click "Save"
5. The system will automatically:
   • Create an API key
   • Create a res.partner record
   • Create a res.users account

Configure Channels

1. Navigate to OpenClaw > Channels
2. Click "Create"
3. Link to a bot
4. Configure channel settings:
   • Channel Type: discuss, wechat, dingtalk, slack, etc.
   • Channel ID: External platform channel identifier
   • Odoo Channel: Link to an Odoo discuss.channel (optional)

Debug Mode

Enable debug mode for testing without external platforms:

1. Open the bot configuration
2. Check "Debug Mode"
3. Add mock response rules under "Mock Response Rules" tab
4. Test the bot in Odoo discuss channels

Actions

receive

Receive a message from OpenClaw and save it to Odoo.

Request:

{
    "action": "receive",
    "bot_code": "your-bot-code",
    "sender_id": "user-123",
    "sender_name": "John Doe",
    "content": "Hello, bot!",
    "message_id": "msg-456",
    "discuss_channel_id": 1,
    "attachments": []
}

Response:

{
    "success": true,
    "message_id": 1,
    "bot_code": "your-bot-code",
    "sender": "John Doe",
    "has_attachment": false
}

poll

Get unreplied messages from Odoo.

Request:

{
    "action": "poll",
    "bot_code": "your-bot-code",
    "limit": 10
}

Response:

{
    "success": true,
    "count": 2,
    "messages": [
        {
            "id": 1,
            "sender_id": "user-123",
            "sender_name": "John Doe",
            "message_content": "Hello",
            "message_id": "msg-456"
        }
    ]
}

reply

Reply to a message and sync to Odoo discuss channel.

Request:

{
    "action": "reply",
    "message_id": 1,
    "content": "Hello back!",
    "bot_code": "your-bot-code",
    "attachments": []
}

Response:

{
    "success": true,
    "reply_id": 2,
    "original_message_id": 1,
    "attachments_count": 0
}

sync

Update message sync status.

Request:

{
    "action": "sync",
    "message_id": 1,
    "sync_status": "synced"
}

Response:

{
    "success": true,
    "message_id": 1,
    "sync_status": "synced"
}

get_attachment

Get attachment data for a message.

Request:

{
    "action": "get_attachment",
    "message_id": 1,
    "attachment_index": 0
}

Response:

{
    "success": true,
    "attachment": {
        "id": 1,
        "name": "file.pdf",
        "attachment_type": "file",
        "file_data": "base64-encoded-data"
    }
}

Basic Chat Flow

1. User sends message on external platform (WeChat/DingTalk/Slack)
2. OpenClaw gateway receives the message
3. Gateway calls receive action to Odoo webhook
4. Message is saved to openclaw.message model
5. Message is synced to linked discuss.channel
6. Odoo user replies in discuss channel
7. Reply is saved to openclaw.message with type outbound
8. Gateway polls for new outbound messages via poll action
9. Gateway sends reply back to external platform

File Sharing

Files can be sent and received through attachments:

Receive attachment:

{
    "action": "receive",
    "attachments": [
        {
            "name": "invoice.pdf",
            "type": "file",
            "url": "https://example.com/file.pdf"
        }
    ]
}

Send attachment:

{
    "action": "reply",
    "content": "Here is the file",
    "attachments": [
        {
            "name": "report.pdf",
            "type": "file",
            "data": "base64-encoded-file-content"
        }
    ]
}

Markdown Rendering

Messages support full Markdown syntax:

• Headers: # Title, ## Subtitle
• Bold: **text**
• Italic: *text*
• Code: `code`
• Code blocks: ` ```code` ```
• Lists: - item or 1. item
• Tables: | Header | Header |
• Links: [text](url)
• Images: 

The module automatically converts Markdown to HTML for display in Odoo.

Mock Response Rules

For testing without external platforms, use mock response rules:

1. Enable debug mode on a bot
2. Navigate to "Mock Response Rules" tab
3. Create a new rule:
   • Trigger Pattern: Regex pattern to match incoming messages
   • Response Text: Text to send when pattern matches
   • Response Type: text or markdown
4. Test the bot in Odoo discuss channels

Example:

• Trigger: .*help.*
• Response: I'm here to help! Please describe your issue.

Messages not syncing to discuss.channel

Check the following:

1. Bot has a linked discuss.channel
2. Bot has an associated user account
3. Bot user is active and has proper permissions
4. Channel is accessible to the bot user

Webhook not receiving messages

Check the following:

1. OpenClaw gateway URL is correct
2. API key matches between Odoo and gateway
3. Bot is active
4. Network connectivity between gateway and Odoo
5. Check Odoo logs for webhook errors

Attachments not working

Check the following:

1. File size is under 16MB limit
2. File format is supported
3. Base64 encoding is correct for binary data
4. Attachment URLs are accessible