К основному содержанию
скилл CX Codex

openclaw-relay — скилл для Claude Code и Codex

Скилл openclaw-relay для Claude Code, Codex, Cursor и других агентных сред — пересылает промпты и сообщения в сессии OpenClaw через локальный acpx или SSH-транспорт. Работает с именованными алиасами сессий из config/session_aliases.json.

MIT 120 установок ★ 7 554 обновлён 2026-10-20

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add steipete/agent-scripts --skill openclaw-relay -a claude-code
Открыть на GitHub

Что делает openclaw-relay

В основе — Python-скрипт scripts/openclaw_relay.py с двумя транспортами: local для прямой работы с текущим чекаутом OpenClaw и ssh для релея на другую машину. Выбор транспорта задаётся флагом --transport или переменной окружения OPENCLAW_RELAY_TRANSPORT.

Сессионные алиасы хранятся в config/session_aliases.json — файл поставляется с плейсхолдерами, их нужно заменить на реальные значения. Команды делятся по назначению: ask запрашивает приватный ответ, force-send гарантированно постит в канал, send держит контрольную сессию живой, а start / wait / show организуют асинхронную очередь. Многострочный текст удобнее передавать через --text-file - вместо экранирования в shell.

По умолчанию local-транспорт ищет acpx в <cwd>/extensions/acpx, а SSH-транспорт подключается к [email protected] — эти пути перекрываются через env-переменные или флаги. Если что-то не работает, первый шаг — python3 scripts/openclaw_relay.py doctor.

Какие задачи решает

  • Переслать промпт в OpenClaw-сессию на другой машине через SSH
  • Отправить сообщение в канал Discord через force-send с медиафайлом
  • Запустить асинхронное задание и дождаться ответа агента через wait
  • Разрешить алиас сессии и проверить маршрут до отправки реального payload
  • Провести health-check транспорта командой doctor

Примеры запросов агенту

  • Перешли это сообщение в сессию maintainers через openclaw-relay
  • Запусти openclaw_relay.py doctor и покажи результат
  • Используй ssh-транспорт и отправь текст из report.txt в сессию main

Как установить openclaw-relay

1Через Skills CLI (Vercel)

npx skills add steipete/agent-scripts --skill openclaw-relay -a claude-code

2Вручную: положить файлы

~/.claude/skills/openclaw-relay/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/openclaw-relay/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об openclaw-relay

Как установить openclaw-relay в Claude Code?

Выполните npx skills add steipete/agent-scripts --skill openclaw-relay -a claude-code. Скилл появится по пути ~/.claude/skills/openclaw-relay/SKILL.md.

Что делает openclaw-relay?

Скилл пересылает промпты и сообщения в именованные сессии OpenClaw — локально через acpx или на удалённую машину через SSH. Он выбирает транспорт, резолвит алиас сессии и возвращает реальный ответ агента, а не вывод shell.

Нужно ли что-то настраивать перед первым запуском?

Файл config/session_aliases.json поставляется с плейсхолдерами — замените их на реальные идентификаторы сессий. Для SSH-транспорта нужен доступ к целевому хосту; токен шлюза читается из ~/.openclaw/gateway.token.

Исходный текст

SKILL.md · MIT
---
name: openclaw-relay
description: "OpenClaw session relay: prompts/posts via local/remote acpx over SSH."
---

# OpenClaw Relay

Use this when the job is:

- "talk to Molty"
- "relay this into an OpenClaw channel session"
- "use acpx"
- "send this through the gateway via acp"
- "work through a remote OpenClaw bridge over SSH"

Not for team.openclaw.ai: starting or inspecting Roboclaw sessions on the Team server is
`$team-handoff` from openclaw/agent-skills (one Gateway request as Peter through Cloudflare Access; operator values live in `~/.config/openclaw/team-handoff.env`).

One skill. Two transports:

1. `local`
2. `ssh`

Default to `local` for direct telephone-game work from the current OpenClaw checkout. Use `ssh` when the target agent/session lives on another machine.

For Peter's setup, Molty normally lives on the Mac Studio gateway, reached as `[email protected]`; avoid the `mac-studio` SSH alias for one-shot relay work because that alias auto-attaches tmux.

Script path: `scripts/openclaw_relay.py`

Target aliases file: `config/session_aliases.json`

## Mode Selection

Choose `local` when:

- the user explicitly says `acpx`
- the target session is on the current machine
- the goal is quick relay or private ask

Choose `ssh` when:

- the target agent/session lives on another host
- you want a persistent bridge session
- you need async queue/wait/show flows on a remote machine

## Defaults

The script avoids baked-in personal paths. Override with env or flags when needed.

- transport: `local`
- local repo cwd: current working directory
- local acpx repo: `<cwd>/extensions/acpx`
- ssh host: `[email protected]`
- remote repo cwd: `<remote-home>/clawdbot`
- remote acpx repo: `<remote-home>/Projects/oss/acpx`
- gateway token file: `<home>/.openclaw/gateway.token`
- control session name: `codex-bridge`
- target aliases file: `config/session_aliases.json`

Useful env vars:

- `OPENCLAW_RELAY_TRANSPORT`
- `OPENCLAW_RELAY_HOST`
- `OPENCLAW_RELAY_CWD`
- `OPENCLAW_RELAY_ACPX_REPO`
- `OPENCLAW_RELAY_GATEWAY_URL`
- `OPENCLAW_RELAY_GATEWAY_TOKEN_FILE`
- `OPENCLAW_RELAY_SESSION`
- `OPENCLAW_RELAY_TARGETS_FILE`

## Quick Start

Health check:

```bash
python3 scripts/openclaw_relay.py doctor
```

List known target aliases:

```bash
python3 scripts/openclaw_relay.py targets
```

Resolve a target alias:

```bash
python3 scripts/openclaw_relay.py resolve --target maintainers
```

Ask a target session a question privately:

```bash
python3 scripts/openclaw_relay.py ask \
  --target maintainers \
  --message "Summarize the current vibe in this channel."
```

Force-send text to the resolved target:

```bash
python3 scripts/openclaw_relay.py force-send \
  --target maintainers \
  --text "Deploy is done."
```

For multiline posts, use `--text-file <path>` or `--text-file -` instead of
shell-quoting the message.

Force-send media when the user explicitly wants a channel post:

```bash
python3 scripts/openclaw_relay.py force-send \
  --transport ssh \
  --host [email protected] \
  --target maintainers \
  --text "Demo video." \
  --media /tmp/demo.mp4
```

Use the persistent control session:

```bash
python3 scripts/openclaw_relay.py ensure
python3 scripts/openclaw_relay.py send --message "Reply with exactly OK."
python3 scripts/openclaw_relay.py show
```

Remote host example:

```bash
python3 scripts/openclaw_relay.py doctor --transport ssh --host [email protected]
python3 scripts/openclaw_relay.py send \
  --transport ssh \
  --host [email protected] \
  --message "Reply with exactly OK."
```

## Async Workflow

Queue work and poll the same control session:

```bash
python3 scripts/openclaw_relay.py start --message "Work on X and reply when done."
python3 scripts/openclaw_relay.py wait --after-seq <last-seq>
python3 scripts/openclaw_relay.py show
```

## Target Aliases

`config/session_aliases.json` ships with placeholders. Replace them with real values for your setup.

Example shape:

```json
{
  "main": "agent:<agentId>:main",
  "maintainers": "agent:<agentId>:discord:channel:<channelId>"
}
```

## Session Rules

Use these rules when choosing a command:

- Want a private reply from a specific session: `ask`
- Want the target session to decide whether to post: `publish`
- Want a guaranteed direct post: `force-send`
- Want blocking continuity with the control brain: `send`
- Want fire-and-forget async: `start`, then `wait` and `show`
- Want to stop queued work: `cancel`

## Failure Handling

If relay work fails:

1. Run `doctor`.
2. Run `status`.
3. Run `show`.
4. If the control session is wedged, run `cancel`, then `ensure`, then retry.

If route discovery is uncertain:

1. Resolve the target first.
2. Prefer alias or exact session key.
3. Use a tiny probe ask before sending the real payload.

## Output Relay

Return the actual assistant text or delivery result, not shell noise.

For relay tasks, report:

- transport used
- target session key
- whether the route probe/resolve succeeded
- final posted or returned result

© steipete · MIT · steipete/agent-scripts

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
openclaw-config adisinghstudent Скилл openclaw-config помогает управлять конфигурацией бота OpenClaw, диагностировать каналы связи и находить сбои в шлюзе или сессиях. CX Codex +1 2 900установок nemo-relay-install NVIDIA Corporation and Affiliates Скилл nemo-relay-install помогает выбрать и установить NeMo Relay для агента, фреймворка или приложения. Разбирается в целевой платформе и подтягивает актуальный стабильный релиз с проверкой доступности. CX Codex +1 227установок competition-relay-coercion-chain zhaoxuya520 Скилл competition-relay-coercion-chain для Claude Code прослеживает принудительную аутентификацию и ретрансляцию в CTF-песочнице, определяя принимающий сервис и последствия. CX Codex +1 109установок loki-mode-openclaw asklokesh Скилл loki-mode-openclaw запускает Loki Mode для автономного цикла разработки: от требований в PRD до развёртывания. Агент следит за фазами, задачами и бюджетом сессии. CX Codex +1 ★ 1 120звёзд репо openclaw-audit-watchdog prompt-security Скилл openclaw-audit-watchdog запускает глубокий аудит безопасности агентов OpenClaw по расписанию и присылает отчёт в личные сообщения. Почту можно подключить отдельно. CX Codex +1 756установок OpenClaw MCP Server freema Связывает чат с OpenClaw через OAuth 2.1, чтобы поручать задачи боту прямо из IDE — бот берётся за их выполнение вплоть до запуска Claude для правок. CX Codex +1 ★ 187звёзд репо

Из того же набора20

Весь набор →
instruments-profiling Скилл instruments-profiling для Claude Code профилирует macOS- и iOS-приложения через Instruments и xctrace, записывает трассы и выгружает стеки. Помогает искать медленные участки. CX Codex +1 242установок ssh-doctor Скилл ssh-doctor диагностирует сбои SSH на macOS: обрывы до авторизации, зависшие сессии sshd и проблемы службы Remote Login. CX Codex +1 239установок domain-dns-ops Скилл domain-dns-ops для Claude Code ведёт операции с доменами, зонами Cloudflare и редиректами. Настраивает новые домены и проверяет DNS и HTTPS. CX Codex +1 192установок discord-clawd Скилл discord-clawd для отправки вопросов Discord-бэкированному агенту через OpenClaw реле. Не для поиска в архивах — используйте для прямого общения с сессией. CX Codex +1 122установок mac-maintenance Скилл mac-maintenance запускает рутинную очистку macOS: обновляет Homebrew, подтягивает чистые git-репозитории и очищает корзину Finder. CX Codex +1 117установок cloudflare-registrar Проверяет доступность доменов и цены в Cloudflare Registrar и регистрирует их прямо из редактора кода. CX Codex +1 108установок codex-debugging Скилл codex-debugging помогает находить и устранять ошибки в кодовой базе codex-rs. Пригодится при разборе поведения интерфейса, протоколов и файлов конфигурации. CX Codex +1 108установок github-project-triage Скилл github-project-triage для Claude Code разбирает открытые GitHub issues и pull requests по команде «triage». Показывает приоритеты, блокеры, проверки и следующий шаг для каждой задачи. CX Codex +1 105установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой