Интеграция

Руководство по OpenClaw

Дайте Ami управление рабочим столом.

Конфиденциальность: OpenClaw работает полностью на вашем устройстве.

В этом руководстве

Требования Установка Запуск шлюза Подключение Ami Настройка рабочего пространства Доступные инструменты Устранение неполадок Обновление Архитектура

Требования

macOS нужен для Apple Notes, Напоминаний, Календаря и Музыки.

Node.js 22+ — проверьте: node --version

Если нет Node 22+:

bash

brew install node@22

Step 1

Установка OpenClaw

Запустите установщик:

bash

curl -fsSL https://openclaw.ai/install.sh | bash

CLI установлен, мастер настройки запущен.

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

bash

openclaw doctor

openclaw не найден, добавьте в PATH:

bash

echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Step 2

Запуск шлюза

Мастер устанавливает фоновый процесс. Проверка:

bash

openclaw gateway status

Ручной запуск:

bash

openclaw gateway --port 18789

Найдите токен шлюза

Токен в ~/.openclaw/openclaw.json под gateway.auth.token. Просмотр:

bash

cat ~/.openclaw/openclaw.json | grep '"token"' | head -1

Сохраните токен для следующего шага.

Step 3

Подключение Ami

Откройте Ami → Настройки
Прокрутите к разделу Расширенные
Раскройте OpenClaw Gateway
Заполните поля:

Поле	Значение
URL шлюза	`ws://127.0.0.1:18789`
Токен шлюза	(вставьте токен из Шага 2)

5. Включите маршрутизацию чата через OpenClaw

6. Нажмите Сохранить

Дополнительно

Настройка	Описание
Синхронизация личности	Отправляет имя и характер Ami на шлюз
Получение воспоминаний	Импорт воспоминаний при загрузке персонажа
Отправка воспоминаний	Авто-синхронизация каждые 10 минут

Step 4

Настройка рабочего пространства

OpenClaw использует папку. Путь по умолчанию: ~/.openclaw/workspace-ami/

Нужно два файла:

SOUL.md — Личность

Авто-синхронизация из приложения.

~/.openclaw/workspace-ami/SOUL.md

TOOLS.md — Инструкции

Справочник Ami по macOS инструментам.

~/.openclaw/workspace-ami/TOOLS.md

Файл содержит osascript команды.

Доступные инструменты

После подключения попросите Ami:

Apple Заметки

“Напиши заметку о покупках”

“Сохрани заметку Планы”

Напоминания

“Напомни позвонить стоматологу в 15:00”

“Напоминание полить цветы”

Календарь

“Что у меня сегодня?”

“Добавь встречу в пятницу”

Музыка

“Включи музыку”

“Пауза”

“Следующий трек”

“Что играет?”

Системные настройки

“Тёмный режим”

“Таймер 5 минут”

“Уровень батареи?”

Открыть приложения и URL

“Открой Safari”

“Открой twitter.com”

Устранение неполадок

Обновление OpenClaw

bash

npm update -g openclaw

Или перезапустите установщик:

bash

curl -fsSL https://openclaw.ai/install.sh | bash

Архитектура

Как Ami общается с рабочим столом:

┌──────────────┐     WebSocket      ┌──────────────────┐     osascript     ┌──────────────┐
│   Ami App    │ ──────────────────► │ OpenClaw Gateway │ ────────────────► │  macOS APIs  │
│  (browser)   │ ◄────────────────── │  (localhost)     │ ◄──────────────── │ Notes, Music │
│              │    SSE streaming    │  Port 18789      │    tool results   │ Calendar etc │
└──────────────┘                     └──────────────────┘                   └──────────────┘
                                            │
                                     ┌──────┴──────┐
                                     │  Workspace  │
                                     │  SOUL.md    │
                                     │  TOOLS.md   │
                                     └─────────────┘

1. Вы отправляете сообщение Ami

2. Приложение определяет запрос инструмента

3. Сообщение через WebSocket к шлюзу

4. Агент читает TOOLS.md и выполняет osascript команду

5. Агент отвечает, Ami озвучивает

Готовы начать?

Установите OpenClaw, подключите Ami и управляйте рабочим столом голосом.

Открыть приложение