cross-team-comm

name	cross-team-comm
description	通过 Tailscale、SSH、Gateway API 与 sessions_send 实现跨团队、跨实例的 OpenClaw 协作通信。
author	Daniel Li

Cross-Team Communication Skill

• Author: Daniel Li
• Copyright © Daniel Li. All rights reserved.

OpenClaw 跨团队/跨实例通信技能。通过 Tailscale + SSH + Gateway API + sessions_send 实现不同 OpenClaw 实例之间的 Agent 协作。

触发词

跨团队通信、跨实例协作、远程 agent、连通其他团队、sessions_send 远程、Tailscale 通信、跨 Gateway

适用场景

• 连接另一个 OpenClaw 实例的 Agent 团队
• 跨团队派发任务 / 获取信息
• 通过飞书/Telegram 等渠道发送跨团队消息
• 远程管理其他实例的配置和 Agent

通信方式（优先级排序）

1. sessions_send（推荐 ✅）

最简单的方式，直接跨 Gateway 发消息给目标 Agent。

sessions_send(
  sessionKey="agent:<agentId>:<channel>:group:<chatId>",
  message="你的消息",
  gatewayUrl="ws://<target-host>:<port>",
  gatewayToken="<token>"
)

示例：

sessions_send(
  sessionKey="agent:main:feishu:group:oc_45acc85cad802bf6cf21ed24e25465e9",
  message="你好！我是小a，来自Daniel团队。",
  gatewayUrl="ws://100.118.109.75:18789",
  gatewayToken="$(pass show team/peter-gateway-token)"
)

优点：原生支持，Agent 可直接回复 限制：需要目标 Gateway 开放 Tailscale 或公网访问；loopback 绑定的需通过 SSH 中转

2. SSH + 本地 API（可靠 ✅）

当 Gateway 只绑定 loopback 时，先 SSH 到目标机器，再调用本地 API。

ssh user@<tailscale-ip>
curl -s -X POST "http://127.0.0.1:<port>/v1/sessions/send" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"sessionKey":"agent:main:...","message":"..."}'

3. 直接调用目标渠道 API（兜底）

当 sessions_send 和 SSH 都不方便时，直接用目标团队的渠道凭据发消息。

飞书示例：

import requests, json

# 1. 获取 tenant_access_token
token_resp = requests.post(
    "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal",
    json={"app_id": "<app_id>", "app_secret": "<app_secret>"}
)
token = token_resp.json()["tenant_access_token"]

# 2. 发送消息
requests.post(
    "https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=chat_id",
    headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"},
    json={
        "receive_id": "<chat_id>",
        "msg_type": "text",
        "content": json.dumps({"text": "消息内容"})
    }
)

首次连通 SOP

Step 1: 网络连通

确保两台机器在同一 Tailscale 网络（或有 SSH 访问）：

tailscale status  # 查看在线设备
ssh user@<ip>     # 测试连通

Step 2: 收集目标信息

SSH 登录后收集：

openclaw --version
openclaw gateway status
cat ~/.openclaw/openclaw.json | grep -E "port|token|feishu|telegram|appId"
find ~/.openclaw/workspace* -name "SOUL.md" -o -name "IDENTITY.md"
ls ~/.openclaw/agents/

Step 3: 测试通信

sessions_send(sessionKey="agent:main:...", message="连通测试")

Step 4: 记录到 MEMORY.md

### 目标团队名 (机器名)
| 项目 | 值 |
|------|------|
| 主机 | <hostname> (<tailscale-ip>) |
| Gateway | 端口 / Token |
| Agents | 列表 |
| 渠道 | 飞书群ID / Telegram群ID |
| 通信方式 | sessions_send / SSH / API |

注意事项

1. Gateway bind: 很多实例默认 bind: loopback，只能本地访问。要远程直连需改为 bind: tailscale 或 0.0.0.0
2. Token 安全: Gateway token 等同于完全控制权，仅存 pass 或 MEMORY.md，不要明文传输
3. 凭据存储: 对方的飞书/Telegram 凭据用 pass insert 存储
4. API 路径: OpenClaw Gateway REST API 路径可能因版本不同而变化，优先用 sessions_send 工具
5. 消息格式: 跨团队发消息时，说明来源（"我是小a，来自Daniel团队"），避免对方 Agent 困惑