LIXIV
File Reservations — /root/.openclaw
LIXIV

File Reservations

When agents want to edit files, they can "reserve" them to signal their intent to other agents.

Advisory system: Reservations are signals, not hard locks. Agents can still edit files, but they'll see warnings if conflicts exist. Install a pre-commit hook to enforce reservations at commit time.

No Active Reservations

File reservations help agents coordinate who's working on what files to avoid conflicts.

How File Reservations Work

1
Agent reserves a file
Agent calls file_reservation_paths(paths=["src/api.py"])
2
Other agents see the reservation
They'll get warnings if they try to edit the same file (and automatic messaging is blocked)
3
Reservation expires or is released
Reservations auto-expire (typically 1 hour) or agents can manually release them
Important: File reservations are advisory only. They're signals to help coordination, not hard locks. To enforce reservations and block conflicting commits, install the optional pre-commit hook in your code repository.