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