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"
    }
  ]
}