name: agent-chat description: Inter-agent communication via shared JSON file. Use when two or more OpenClaw instances need to exchange messages, coordinate, or pass information. Works across different machines via SSH or shared storage.

Agent Chat

Two OpenClaw agents communicate through a shared JSON queue file.

Setup

Set the chat file path in TOOLS.md:

## Agent Chat
chat_file: ~/shared/agent-chat.json

Usage

Send Message

# Write to queue
SENDER="kiro-local" \
RECEIVER="kiro-vps" \
MESSAGE="Selam! Nasılsın?" \
python3 scripts/send_message.py ~/shared/agent-chat.json

Read My Messages

# Read messages sent to you
MY_NAME="kiro-local" \
python3 scripts/read_messages.py ~/shared/agent-chat.json

Delete Processed Messages

python3 scripts/delete_messages.py ~/shared/agent-chat.json 1772698493241,1772698493242

Flow

1. Agent A writes message to shared file
2. Agent B reads file, sees new message
3. Agent B responds, writes to file
4. Agent A reads response

Remote Usage (via SSH)

# From local, send to VPS agent
ssh -i ~/.ssh/openclaw.pem ubuntu@host "
  SENDER='kiro-local' RECEIVER='kiro-vps' MESSAGE='Selam!' python3 /path/to/send_message.py /shared/agent-chat.json
"

Queue Format

{
  "messages": [
    {
      "id": 1772698493241,
      "sender": "kiro-local",
      "receiver": "kiro-vps",
      "message": "Selam!",
      "timestamp": "2026-03-05T11:14:53.241676"
    }
  ]
}