- 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.jsonUsage
Send Message
# Write to queue
SENDER="kiro-local" \
RECEIVER="kiro-vps" \
MESSAGE="Selam! Nasılsın?" \
python3 scripts/send_message.py ~/shared/agent-chat.jsonRead My Messages
# Read messages sent to you
MY_NAME="kiro-local" \
python3 scripts/read_messages.py ~/shared/agent-chat.jsonDelete Processed Messages
python3 scripts/delete_messages.py ~/shared/agent-chat.json 1772698493241,1772698493242Flow
- Agent A writes message to shared file
- Agent B reads file, sees new message
- Agent B responds, writes to file
- 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"
}
]
}