path vs file_path

[fluid pier]

@krill i want to understand whether read tool required path or file_path as the parameter name. it is confusing since both seem to be working or failing in different times. need clarity on the right parameter to use my agent.md file when instructing my agent. running 2026.4.20

[grizzled delta]

To help others find answers, you can mark your question as solved via Right click solution message -> Apps -> ✅ Mark Solution

[boreal timber]

Use path.

For OpenClaw’s built-in read tool in 2026.4.20, the required parameter group is explicitly:

read: [{ keys: ["path"], label: "path" }]

So in your AGENTS.md, tell it:

When using the OpenClaw read/write/edit file tools, use the canonical parameter name `path`.
Do not use `file_path` or `filePath` for the built-in `read` tool.
Example: read({ "path": "README.md" })

Why the confusion: file_path is recognized in a few display/diagnostic/rendering paths so legacy/malformed tool calls can be shown nicely, but runtime validation for the actual built-in file tools expects path.