什么是 OpenClaw Messenger？

OpenClaw Messenger 是一款专为桥接独立 OpenClaw 实例而设计的专业工具。它允许开发者和用户建立一个强大的消息网络，使智能体能够交换信息、互相进行可用性测试（ping）以及管理受信任的联系人名录。通过利用 WebSocket，它促进了分布式 AI 环境之间的实时数据流和系统级事件注入。

作为 Openclaw Skills 生态系统的一部分，该工具对于构建复杂多智能体工作流的开发者至关重要。无论是跨机器协调任务，还是简单地向同事的 AI 发送消息，此技能都为安全高效的实例间通信提供了必要的基础设施。

下载入口:https://github.com/openclaw/skills/tree/main/skills/tagryu/openclaw-messenger

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

OpenClaw Messenger 应用场景

• 通知另一个 OpenClaw 实例任务完成情况或特定的状态更新。
• 向同伴的 AI 智能体发送直接消息，以进行协作编程或实时调试。
• 构建一个共享上下文、资源或指令的去中心化 AI 智能体网络。
• 使用 ping 功能坚控不同机器或地理位置上智能体的连接性及健康状况。

1. 获取目标 OpenClaw 实例的网关 WebSocket URL 及其特定的访问令牌。
2. 建立到目标实例的安全 WebSocket 连接。
3. 发送格式化为系统事件的消息，随后这些消息将被注入到接收者的活动会话中。
4. 可选使用中继模式（Relay Mode），通过唯一 ID 经由中央服务器转发消息，从而无需在个人用户之间直接交换 IP 或令牌。

OpenClaw Messenger 配置指南

要在您的 Openclaw Skills 设置中使用此功能，请确保已安装 ws 包并遵循以下配置步骤：

# 安装所需依赖
npm install ws

# 向本地名录添加新联系人
node scripts/messenger.js contacts add --name "PeerBot" --url "ws://192.168.1.50:18789" --token "your_token_here"

# 向已保存的联系人发送测试消息
node scripts/messenger.js send --to "PeerBot" --message "来自我的 OpenClaw 的问候！"

# 启动本地服务器以接收消息
node scripts/messenger.js listen --port 19900

OpenClaw Messenger 数据架构与分类体系

name: openclaw-messenger
description: Send and receive messages between OpenClaw instances. Use when you need to communicate with another OpenClaw agent on a different machine, send a message to a friend's OpenClaw, manage OpenClaw contacts, or set up inter-instance messaging. Supports contact management, ping, and webhook-based message listening.

OpenClaw Messenger

Send messages to other OpenClaw instances and manage contacts.

Quick Start

# ??? ??
node scripts/messenger.js contacts add --name "???" --url "ws://192.168.1.50:18789" --token "abc123" --desc "??? OpenClaw"

# ??? ???
node scripts/messenger.js send --to "???" --message "??! ?? Tames?" --from "Tames"

# ?? URL? ???
node scripts/messenger.js send --url "ws://host:port" --token "token" --message "Hello!"

# ? ???
node scripts/messenger.js ping --to "???"

# ??? ??
node scripts/messenger.js contacts list

Commands

• send — ??? ?? (--to ??? ?? --url/--token ?? ??)
• contacts list — ??? ??
• contacts add — ??? ?? (--name, --url, --token, --desc)
• contacts remove — ??? ?? (--name)
• ping — ?? ??? (--to ?? --url)
• listen — ??? ?? ?? ?? (--port, ?? 19900)

How It Works

1. ?? OpenClaw? Gateway WebSocket URL? ??? ??
2. WebSocket?? ???? ??? ???? ??? ??
3. ???? ??? ???? ??? ???? ???

Security

• ??? contacts.json? ?? ?? (?? ?? ??)
• ???? ??? ???? ??? ?? ??
• Gateway? loopback ????? ?? ?? ?? → Tailscale ? ??

Relay Mode (??? — ??!)

????? ?? IP/?? ?? ?? ID??? ??? ??:

# ??? ?? ?? (?? ??)
node scripts/relay-client.js setup --relay https://circuit-website-revealed-detail.trycloudflare.com

# ??
node scripts/relay-client.js register --id my-id --name "? ??" --secret ???

# ??? ???
node scripts/relay-client.js send --to ??ID --message "??!"

# ?? ??? ??
node scripts/relay-client.js poll

# ??? ??
node scripts/relay-client.js listen

# ??? ??
node scripts/relay-client.js users

Requirements

• ws npm package (npm install ws in skill directory)