OpenClaw Relay
以下のジョブの場合に使用します:
- 「Moltyと話す」
- 「これをOpenClawチャンネルセッションにリレーする」
- 「acpxを使う」
- 「これをacp経由でゲートウェイに送信する」
- 「SSH経由でリモートのOpenClawブリッジを介して作業する」
1つのスキル。2つのトランスポート:
localssh
現在の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_TRANSPORTOPENCLAW_RELAY_HOSTOPENCLAW_RELAY_CWDOPENCLAW_RELAY_ACPX_REPOOPENCLAW_RELAY_GATEWAY_URLOPENCLAW_RELAY_GATEWAY_TOKEN_FILEOPENCLAW_RELAY_SESSIONOPENCLAW_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
障害処理
リレー作業が失敗した場合:
doctorを実行。statusを実行。showを実行。- 制御セッションが停止している場合は
cancelを実行し、その後ensureを実行してから再試行。
ルート発見が不確かな場合:
- 最初にターゲットを解決。
- エイリアスまたは正確なセッションキーを優先。
- 実際のペイロードを送信する前に、小さなプローブ質問を使用。
出力リレー
シェルノイズではなく、実際のアシスタントテキストまたは配信結果を返します。
リレータスクの場合、以下を報告:
- 使用したトランスポート
- ターゲットセッションキー
- ルートプローブ/解決の成功有無
- 最終的に投稿または返された結果