steipete/openclaw-relay

OpenClawセッションリレー:ローカル/リモートのacpx経由でプロンプトや投稿をSSH越しに転送します。

openclaw-relay とは?

このスキルは、OpenClawエージェントセッション間でメッセージをリレーするためのツールです。`local`(同一マシン上の直接作業)と`ssh`(リモートホスト経由)の2つのトランスポートをサポートしており、`acpx` CLIツールを使用してターゲットセッションにプロンプトや投稿を送信します。主なユースケースは、Claude CodeやCodexなどのAIエージェントが、別のエージェントや人間が監視するチャンネルと非同期に通信したい場合です。`ask`(プライベート質問)、`force-send`(強制投稿)、`send`(制御セッション経由の連続通信)、`start`/`wait`/`show`(非同期ワークフロー)などのコマンドを提供します。リモートホストの例として、Peterのセットアップでは`[email protected]`が指定されており、`config/session_aliases.json`でターゲットエイリアスを管理します。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/openclaw-relay

Installed? Explore more 生産性&コラボレーション skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

OpenClaw Relay

以下のジョブの場合に使用します:

  • 「Moltyと話す」
  • 「これをOpenClawチャンネルセッションにリレーする」
  • 「acpxを使う」
  • 「これをacp経由でゲートウェイに送信する」
  • 「SSH経由でリモートのOpenClawブリッジを介して作業する」

1つのスキル。2つのトランスポート:

  1. local
  2. ssh

現在のOpenClawチェックアウトから直接電話ゲーム形式で作業する場合は、デフォルトでlocalを使用します。ターゲットエージェント/セッションが別のマシンにある場合はsshを使用します。

Peterのセットアップでは、Moltyは通常Mac Studioゲートウェイ上にあり、[email protected]でアクセスします。1回限りのリレー作業ではmac-studio SSHエイリアスは使用を避けてください。そのエイリアスはtmuxを自動アタッチするためです。

スクリプトパス:scripts/openclaw_relay.py

ターゲットエイリアスファイル:config/session_aliases.json

モード選択

以下の場合はlocalを選択:

  • ユーザーが明示的にacpxと指定した場合
  • ターゲットセッションが現在のマシン上にある場合
  • 目的がクイックリレーまたはプライベートな質問の場合

以下の場合はsshを選択:

  • ターゲットエージェント/セッションが別のホスト上にある場合
  • 永続的なブリッジセッションが必要な場合
  • リモートマシン上で非同期キュー/待機/表示フローが必要な場合

デフォルト

スクリプトは個人のパスを埋め込みません。必要に応じて環境変数またはフラグで上書きします。

  • トランスポート:local
  • ローカルリポジトリのカレントワーキングディレクトリ:現在の作業ディレクトリ
  • ローカルacpxリポジトリ:<cwd>/extensions/acpx
  • SSHホスト:[email protected]
  • リモートリポジトリのカレントワーキングディレクトリ:<remote-home>/clawdbot
  • リモートacpxリポジトリ:<remote-home>/Projects/oss/acpx
  • ゲートウェイトークンファイル:<home>/.openclaw/gateway.token
  • 制御セッション名:codex-bridge
  • ターゲットエイリアスファイル:config/session_aliases.json

便利な環境変数:

  • 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

クイックスタート

ヘルスチェック:

python3 scripts/openclaw_relay.py doctor

既知のターゲットエイリアスをリスト表示:

python3 scripts/openclaw_relay.py targets

ターゲットエイリアスを解決:

python3 scripts/openclaw_relay.py resolve --target maintainers

ターゲットセッションにプライベートに質問:

python3 scripts/openclaw_relay.py ask \
  --target maintainers \
  --message "このチャンネルの現在の雰囲気を要約してください。"

解決されたターゲットにテキストを強制送信:

python3 scripts/openclaw_relay.py force-send \
  --target maintainers \
  --text "デプロイが完了しました。"

複数行の投稿には、シェル引用符の代わりに --text-file <path> または --text-file - を使用します。

ユーザーが明示的にチャンネル投稿を希望する場合、メディアを強制送信:

python3 scripts/openclaw_relay.py force-send \
  --transport ssh \
  --host [email protected] \
  --target maintainers \
  --text "デモ動画" \
  --media /tmp/demo.mp4

永続的な制御セッションを使用:

python3 scripts/openclaw_relay.py ensure
python3 scripts/openclaw_relay.py send --message "正確にOKと返信してください。"
python3 scripts/openclaw_relay.py show

リモートホストの例:

python3 scripts/openclaw_relay.py doctor --transport ssh --host [email protected]
python3 scripts/openclaw_relay.py send \
  --transport ssh \
  --host [email protected] \
  --message "正確にOKと返信してください。"

非同期ワークフロー

同じ制御セッションに作業をキューイングし、ポーリング:

python3 scripts/openclaw_relay.py start --message "Xに取り組み、完了したら返信してください。"
python3 scripts/openclaw_relay.py wait --after-seq <last-seq>
python3 scripts/openclaw_relay.py show

ターゲットエイリアス

config/session_aliases.json にはプレースホルダーが含まれています。実際の値に置き換えてください。

設定例:

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

セッションルール

コマンド選択時は以下のルールを使用:

  • 特定のセッションからプライベートな返信が必要:ask
  • ターゲットセッションに投稿するかどうかを決定させたい:publish
  • 確実な直接投稿が必要:force-send
  • 制御ブレインとのブロッキング連続性が必要:send
  • ファイア・アンド・フォーゲットの非同期処理:start、その後 wait と show
  • キューに入った作業を停止:cancel

障害処理

リレー作業が失敗した場合:

  1. doctor を実行。
  2. status を実行。
  3. show を実行。
  4. 制御セッションが停止している場合は cancel を実行し、その後 ensure を実行してから再試行。

ルート発見が不確かな場合:

  1. 最初にターゲットを解決。
  2. エイリアスまたは正確なセッションキーを優先。
  3. 実際のペイロードを送信する前に、小さなプローブ質問を使用。

出力リレー

シェルノイズではなく、実際のアシスタントテキストまたは配信結果を返します。

リレータスクの場合、以下を報告:

  • 使用したトランスポート
  • ターゲットセッションキー
  • ルートプローブ/解決の成功有無
  • 最終的に投稿または返された結果

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

関連スキル