echo-ai

# Echo AI

Connect your agent to [Echo AI](https://echoai.so) — a platform where businesses and creators build AI-powered assistants (called Echos) for sales, support, and customer engagement.

With this skill, your agent can discover Echos, read their knowledge bases, and have conversations with them.

## Get started

1. Sign up at [echoai.so](https://echoai.so) (free tier available)
2. Create your first Echo or browse existing ones
3. Go to Settings → API Keys and generate a key
4. Set the environment variable `ECHO_API_KEY` to your key

## What this skill can do

### 1. List available Echos (free, no credits)

Discover which AI assistants are available under your API key.

```
GET https://auth.echoai.so/functions/v1/api/assistants
Header: X-API-Key: $ECHO_API_KEY
```

Response:
```json
{
  "assistants": [
    {
      "id": "uuid",
      "name": "Sales Assistant",
      "bio": "I help qualify leads and answer product questions",
      "slug": "sales-assistant",
      "avatar_url": "https://...",
      "tone": "professional",
      "style": "concise",
      "topics": ["pricing", "features", "onboarding"]
    }
  ]
}
```

### 2. Get Echo details and knowledge base (free, no credits)

Retrieve an Echo's full profile including FAQs, suggested questions, and personality.

```
GET https://auth.echoai.so/functions/v1/api/assistant/{id}
Header: X-API-Key: $ECHO_API_KEY
```

Response includes: name, bio, FAQs, preset questions, topics, tone, style, and lore.

**If the user's question can be answered from FAQs, answer directly — no chat call needed.**

### 3. Chat with an Echo (costs credits)

Send a message and get a response from the Echo's AI.

```
POST https://auth.echoai.so/functions/v1/api/chat
Header: X-API-Key: $ECHO_API_KEY
Content-Type: application/json
```

Request:
```json
{
  "message": "What pricing plans do you offer?",
  "assistant_id": "the-echo-uuid",
  "session_id": "optional — pass from previous response for continuity",
  "visitor_id": "optional — your...

# Echo AI Skill for OpenClaw

Query and interact with [Echo AI](https://echoai.so) assistants directly from your OpenClaw agent.

## Installation

1. Copy the `openclaw-skill/` folder to your OpenClaw skills directory:
   ```bash
   cp -r openclaw-skill/ ~/.openclaw/workspace/skills/echo-assistant/
   ```

2. Get an API key from [echoai.so](https://echoai.so) → Settings → API Keys

3. Set the environment variable:
   ```bash
   export ECHO_API_KEY="ek_your_api_key_here"
   ```

4. Enable the skill in `~/.openclaw/openclaw.json`:
   ```json
   {
     "skills": {
       "entries": [
         {
           "path": "~/.openclaw/workspace/skills/echo-assistant/SKILL.md",
           "enabled": true
         }
       ]
     }
   }
   ```

5. Restart OpenClaw

## Usage

Once installed, you can ask your OpenClaw agent:

- "List my Echo assistants"
- "What can my Echo assistant do?"
- "Tell me about my Echo named [name]"
- "Chat with my Echo assistant about [topic]"

## Safety

- **Read-only by default**: Listing and viewing assistants costs zero credits
- **Chat requires confirmation**: The agent will always ask before sending chat messages (which consume credits)
- **Rate limited**: Respects the per-key rate limits set by the Echo owner
- **API key scoped**: Assistant-scoped keys can only access their assigned Echo

## Links

- [Echo AI](https://echoai.so)
- [Echo API Documentation](https://echoai.so/help)
- [OpenClaw Skills Documentation](https://docs.openclaw.ai/skills)