amernet-ai-saas

## AI SaaS Chatbot

This skill forwards user messages to an AI SaaS chatbot and returns its response. It maintains conversation context per user by using their channel and user identifier as a session key.

### Required Configuration

These environment variables must be set in your `~/.openclaw/openclaw.json` under `skills.entries.amernet-ai-saas.env`:

| Variable | Description |
|---|---|
| `AI_SAAS_API_KEY` | Your API key from the portal (Settings → API Keys). Needs `all` permission. |
| `AI_SAAS_CHATBOT_ID` | The chatbot ID to route all messages to (copy from the Chatbots page). |
| `AI_SAAS_BASE_URL` | Base URL of your AI SaaS instance. Default: `https://saas.salesbay.ai` |

### Message Routing

When the user sends ANY message through any connected channel:

1. Identify the current channel name (e.g. `whatsapp`, `telegram`, `slack`, `discord`) and the user's identifier on that channel (phone number, user ID, or username).

2. Construct a `sender_id` combining both: `<channel>:<user_identifier>`
   - WhatsApp example: `whatsapp:+15551234567`
   - Telegram example: `telegram:123456789`
   - Slack example: `slack:U012AB3CD`
   - Discord example: `discord:123456789012345678`

3. Send a POST request to the chatbot API:

```
POST ${AI_SAAS_BASE_URL}/api/v1/chatbots/${AI_SAAS_CHATBOT_ID}/chat
Authorization: Bearer ${AI_SAAS_API_KEY}
Content-Type: application/json

{
  "sender_id": "<constructed sender_id>",
  "message": "<user message text>"
}
```

4. Parse `data.responses` from the JSON response. Return each item's `text` field as a separate message to the user. If multiple responses exist, send them in order.

5. If the API returns an error or is unreachable, reply: "Sorry, the AI assistant is temporarily unavailable. Please try again in a moment."

### Conversation Reset

If the user explicitly says "reset", "start over", "clear chat", or "/reset":

```
DELETE ${AI_SAAS_BASE_URL}/api/v1/chatbots/${AI_SAAS_CHATBOT_ID}/conversations/<sender_id>
Authorization: Bearer $...

# AI SaaS Skill for OpenClaw

Connect your [AI SaaS](https://saas.salesbay.ai) chatbot to any messaging channel via [OpenClaw](https://openclaw.ai) — WhatsApp, Telegram, Slack, Discord, iMessage, and more.

## Prerequisites

- [OpenClaw](https://openclaw.ai) installed and running (`npm install -g openclaw@latest`)
- An AI SaaS account with at least one active chatbot
- An API key from the AI SaaS portal

## Installation

### 1. Get your credentials from the AI SaaS portal

1. Open **Settings → API Keys** and create a key with **All** permissions. Copy the key.
2. Open the **Chatbots** page and copy the ID of the chatbot you want to route messages to.

You can also visit **Settings → OpenClaw** in the portal for a guided setup that generates the config for you.

### 2. Install the skill

```bash
# Clone into your OpenClaw workspace skills folder
git clone https://github.com/your-org/openclaw-skill-ai-saas \
  ~/.openclaw/workspace/skills/ai-saas

# Or copy manually
cp -r /path/to/openclaw-skill ~/.openclaw/workspace/skills/ai-saas
```

### 3. Configure credentials

Add the following to `~/.openclaw/openclaw.json` under the `skills` key:

```json
{
  "skills": {
    "entries": {
      "ai-saas": {
        "enabled": true,
        "env": {
          "AI_SAAS_API_KEY": "sk_live_your_api_key_here",
          "AI_SAAS_CHATBOT_ID": "your-chatbot-uuid-here",
          "AI_SAAS_BASE_URL": "https://saas.salesbay.ai"
        }
      }
    }
  }
}
```

### 4. Restart OpenClaw

```bash
openclaw restart
```

## Usage

Once installed, all messages sent through your connected channels (WhatsApp, Telegram, Slack, etc.) are automatically forwarded to your AI SaaS chatbot and responses are returned to the user.

### Special Commands

| Command | Action |
|---|---|
| `/reset` | Clear conversation history for the current user |
| `/status` | Check if the AI SaaS chatbot is active |

## How It Works

```
User (WhatsApp/Telegram/Slack/...)
        ↓ message
   OpenClaw Gateway
        ↓ s...