openclaw-relay

---
name: openclaw-relay
description: "Use when working with openClaw session relay: prompts/posts via local/remote acpx over SSH from steipete/agent-scripts."
source: https://github.com/steipete/agent-scripts/tree/main/skills/openclaw-relay
generated: 2026-05-27T20:56:14.115Z
category: tool
audience: engineers
---

## When to use

- The job is:.
- Using the openclaw-relay skill's upstream workflow, guardrails, and local-tool assumptions.
- Auditing commands or operational steps before changing openclaw relay behavior.
- Needing a compact agent reference for openClaw session relay: prompts/posts via local/remote acpx over SSH.

## Key concepts

### 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: steipete@steipete-macstudio.local 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/sessionaliases.json Useful env vars: OPENCLAWRELAYTRANSPORT...

### Async Workflow

Queue work and poll the same control session:.

### Target Aliases

config/sessionaliases.json ships with placeholders. Replace them with real values for your setup. Example shape:.

### 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.

## API reference

```
npx skills add steipete/agent-scripts --skill openclaw-relay
```

Install the openclaw-relay skill from steipete/agent-scripts.

```
npx skills add steipete/agent-scripts --skill openclaw-relay
```

```
python3 scripts/openclawrelay.py doctor.
```

Command or snippet documented by the upstream openclaw-relay skill.

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

```
python3 scripts/openclawrelay.py targets.
```

Command or snippet documented by the upstream openclaw-relay skill.

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

```
python3 scripts/openclawrelay.py resolve --target maintainers.
```

Command or snippet documented by the upstream openclaw-relay skill.

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

```
python3 scripts/openclawrelay.py ask \.
```

Command or snippet documented by the upstream openclaw-relay skill.

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

```
python3 scripts/openclawrelay.py force-send \.
```

Command or snippet documented by the upstream openclaw-relay skill.

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

```
python3 scripts/openclawrelay.py force-send \.
```

Command or snippet documented by the upstream openclaw-relay skill.

```
python3 scripts/openclaw_relay.py force-send \
  --transport ssh \
  --host steipete@steipete-macstudio.local \
  --target maintainers \
  --text "Demo video." \
  --media /tmp/demo.mp4
```

## Gotchas

- Ask a target session a question privately:.

---
Generated by SkillMake from https://github.com/steipete/agent-scripts/tree/main/skills/openclaw-relay on 2026-05-27T20:56:14.115Z.
Verify against source before relying on details.

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