Cross Instance Comm

---
name: cross-instance-comm
description: "Use when sending messages or tasks between multiple OpenClaw instances over Tailscale Gateway, such as asking another machine to execute work or sync context."
author: Daniel Li
---

# 跨 OpenClaw 实例通信 (Tailscale Gateway)

通过 Tailscale 网络向其他 OpenClaw 实例发送消息，实现跨机器 Agent 通信。

## 触发条件

- "给小m发消息"、"发到Mac Mini"、"跨实例通信"
- "在小m上执行"、"远程部署"、"同步到小m"

## 已知实例

| 实例 | 域名 | 端口 | Token |
|------|------|------|-------|
| 小m (Mac Mini M2) | daniellimac-mini.tail0db0a3.ts.net | 18789 | $(pass show api/xiaom-gateway-token) |
| 本机 (Linux) | 127.0.0.1 | 18789 | (本地) |

## 发送消息到远程实例

```bash
# 给小m的主agent发消息
curl -s -X POST "http://daniellimac-mini.tail0db0a3.ts.net:18789/api/message" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"message": "你的消息内容"}'
```

## 通过 OpenClaw sessions_send（推荐）

如果当前 OpenClaw 配置了远程 Gateway，可直接用 sessions_send：

```python
# 在代码中通过 Gateway API
import httpx

def send_to_instance(host, port, token, message, session_key=None):
    url = f"http://{host}:{port}/api/message"
    headers = {"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
    data = {"message": message}
    if session_key:
        data["sessionKey"] = session_key
    resp = httpx.post(url, headers=headers, json=data, timeout=30)
    return resp.json()

# 发到小m
send_to_instance(
    "daniellimac-mini.tail0db0a3.ts.net", 18789,
    "$(pass show api/xiaom-gateway-token)",
    "帮XX公司做GEO，行业是云计算"
)
```

## 脚本快捷方式

```bash
# scripts/send-to-m2.sh
#!/bin/bash
MSG="${1:?用法: send-to-m2.sh '消息内容'}"
curl -s -X POST "http://daniellimac-mini.tail0db0a3.ts.net:18789/api/message" \
  -H "Authorization: Bearer $(pass show api/xiaom-gateway-token)" \
  -H "Content-Type: application/json" \
  -d "{\"message\": \"$MSG\"}"
```

## 注意事项

- 需要 Tailscale 网络连通（两台机器都在同一 Tailnet）
- Token 不要泄露到公开仓库
- 超时建议设 30s（跨网络延迟）
- 远程实例的 Gateway 必须在运行状态