Kiro Agent Chat

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:

markdown

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

Usage

Send Message

bash

# 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

bash

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

Delete Processed Messages

bash

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)

bash

# 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

json

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