Интеграции

OpenClaw

Дайте агенту OpenClaw собственный почтовый ящик

Начало работы

OpenClaw (ранее Moltbot) — открытый персональный AI-ассистент, который работает на ваших устройствах и подключается к мессенджерам вроде WhatsApp, Telegram, Discord и Slack. Добавив Agent Inbox, агент сможет отправлять и получать почту — двусторонняя переписка рядом с привычными чатами.

Интегрировать Agent Inbox с OpenClaw можно двумя способами: официальным навыком Agent Inbox или своим кастомным навыком.

Вариант 1: официальный навык Agent Inbox (рекомендуется)

Проще всего добавить почту через официальный навык с skills.sh. Его поддерживает команда Agent Inbox; в нём полный набор почтовых функций.

Установка

Через ClawHub:

$npx clawhub@latest install agentinbox

Настройка

Добавьте API-ключ Agent Inbox в конфигурацию навыка в ~/.openclaw/openclaw.json:

1{
2  "skills": {
3    "entries": {
4      "agentinbox": {
5        "enabled": true,
6        "env": {
7          "AGENTINBOX_API_KEY": "your-api-key-here"
8        }
9      }
10    }
11  }
12}

Ключ выдаётся в консоли Agent Inbox.

Возможности

Официальный навык включает:

  • Почтовые ящики: масштабируемые ящики по запросу с уникальными адресами
  • Сообщения: отправка в тексте и HTML для доставляемости
  • Треды: группировка связанных сообщений
  • Вложения: отправка и приём в Base64
  • Черновики: согласование человеком перед отправкой
  • Pods: изоляция мультитенантности для SaaS
  • Идемпотентность: безопасные повторы операций создания
  • События в реальном времени: WebSocket и вебхуки

Проверка установки

Убедитесь, что навык подхвачен:

$openclaw skills list --eligible

В списке должен быть agentinbox.

Вариант 2: свой навык

Для полного контроля можно собрать кастомный навык Agent Inbox. Навык — это каталог с файлом SKILL.md с инструкциями для OpenClaw.

Создайте каталог навыка

$mkdir -p ~/.openclaw/skills/agentinbox

Создайте файл навыка

Создайте ~/.openclaw/skills/agentinbox/SKILL.md со следующим содержимым:

1---
2name: agentinbox
3description: Send and receive emails using Agent Inbox
4requires:
5  env:
6    - AGENTINBOX_API_KEY
7---
8
9# Agent Inbox Skill
10
11You can send and receive emails using the Agent Inbox API. Use the `exec` tool to run curl commands against the Agent Inbox API.
12
13## API Base URL
14
15```
16https://api.agentinbox.space/v0
17```
18
19## Authentication
20
21Include your API key in the Authorization header:
22
23```
24Authorization: Bearer $AGENTINBOX_API_KEY
25```
26
27## Common Operations
28
29### List inboxes
30
31```bash
32curl -s -H "Authorization: Bearer $AGENTINBOX_API_KEY" \
33  https://api.agentinbox.space/v0/inboxes
34```
35
36### Create an inbox
37
38```bash
39curl -s -X POST -H "Authorization: Bearer $AGENTINBOX_API_KEY" \
40  -H "Content-Type: application/json" \
41  -d '{"display_name": "My Agent"}' \
42  https://api.agentinbox.space/v0/inboxes
43```
44
45### Send an email
46
47```bash
48curl -s -X POST -H "Authorization: Bearer $AGENTINBOX_API_KEY" \
49  -H "Content-Type: application/json" \
50  -d '{
51    "to": ["recipient@example.com"],
52    "subject": "Hello from OpenClaw",
53    "text": "This email was sent by my AI assistant."
54  }' \
55  https://api.agentinbox.space/v0/inboxes/{inbox_id}/messages/send
56```
57
58### List messages in an inbox
59
60```bash
61curl -s -H "Authorization: Bearer $AGENTINBOX_API_KEY" \
62  https://api.agentinbox.space/v0/inboxes/{inbox_id}/messages
63```
64
65### Reply to a message
66
67```bash
68curl -s -X POST -H "Authorization: Bearer $AGENTINBOX_API_KEY" \
69  -H "Content-Type: application/json" \
70  -d '{"text": "Thanks for your email!"}' \
71  https://api.agentinbox.space/v0/inboxes/{inbox_id}/messages/{message_id}/reply
72```

Настройка навыка

Добавьте API-ключ в ~/.openclaw/openclaw.json:

1{
2  "skills": {
3    "entries": {
4      "agentinbox": {
5        "enabled": true,
6        "env": {
7          "AGENTINBOX_API_KEY": "your-api-key-here"
8        }
9      }
10    }
11  }
12}

Проверка навыка

$openclaw skills list --eligible

Должен отображаться agentinbox.

Примеры запросов

После интеграции можно просить агента:

  • «Создай новый почтовый ящик для моего проекта»
  • «Проверь ящик на новые письма»
  • «Отправь письмо на john@example.com о встрече завтра»
  • «Ответь на последнее письмо от Sarah»
  • «Перешли письмо со счётом на accounting@company.com»

Уведомления о новой почте

Для проактивной обработки писем можно связать вебхуки Agent Inbox с вебхуками OpenClaw — ассистент сразу узнаёт о входящих.

  1. Настройте endpoint вебхука в OpenClaw (см. документацию OpenClaw по вебхукам)
  2. Зарегистрируйте вебхук в Agent Inbox:
$curl -X POST -H "Authorization: Bearer $AGENTINBOX_API_KEY" \
>  -H "Content-Type: application/json" \
>  -d '{
>    "url": "https://your-openclaw-webhook-url",
>    "event_types": ["message.received"]
>  }' \
>  https://api.agentinbox.space/v0/webhooks

Тогда OpenClaw будет получать события о новых письмах и сможет сразу реагировать.

Материалы