Skip to content

[Bug]: read and write tools fail with "Missing required parameter" after session runs for a while #54920

Description

@StockholmStar

Bug type

Regression (worked before, now fails)

Summary

read and write tools fail with "Missing required parameter" after ~15 minutes of session activity

Steps to reproduce

  1. Start a new OpenClaw session
  2. Use read tool successfully (e.g., {"file":"memory/2026-03-25.md"})
  3. Continue conversation for approximately 15 minutes
  4. Try read tool again with the same parameter format
  5. Error occurs: "Missing required parameter: path alias"

Expected behavior

read and write tools should continue to work throughout the session, accepting the file parameter correctly.

Actual behavior

After ~15 minutes, both read and write tools return:

{
  "status": "error",
  "tool": "read",
  "error": "Missing required parameter: path alias. Supply correct parameters before retrying."
}

Even when explicitly providing the file parameter, the system reports it as missing.

OpenClaw version

OpenClaw 2026.3.24 (cff6dc9)

Operating system

Linux 6.8.0-106-generic (Ubuntu)

Install method

curl -fsSL https://openclaw.ai/install.sh | bash

Model

kimi/k2p5

Provider / routing chain

feishu

Additional provider/model setup details

Session started via Feishu (飞书) channel. Gateway restart temporarily fixes the issue.

Logs, screenshots, and evidence

04:42:19+00:00 warn agent/embedded {"subsystem":"agent/embedded"} read tool called without path: toolCallId=tool_kFT5QhsaGJGy7gVbdN72MGgP argsType=object
04:42:19+00:00 error [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
04:42:19+00:00 error [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
04:42:21+00:00 warn agent/embedded {"subsystem":"agent/embedded"} read tool called without path: toolCallId=tool_m0OzvLUB6Ysx11j4SZiI3v4H argsType=object
04:42:21+00:00 error [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
04:42:21+00:00 error [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
04:42:23+00:00 warn agent/embedded {"subsystem":"agent/embedded"} read tool called without path: toolCallId=tool_Z9IAOP0KRTWnwejRKv4bFfI9 argsType=object
04:42:23+00:00 error [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
04:42:23+00:00 error [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
04:42:25+00:00 warn agent/embedded {"subsystem":"agent/embedded"} read tool called without path: toolCallId=tool_Z8gmQfuAdsWUGKAV4IsXAioO argsType=object
04:42:25+00:00 error [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
04:42:25+00:00 error [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
04:42:27+00:00 warn agent/embedded {"subsystem":"agent/embedded"} read tool called without path: toolCallId=tool_6S3cC9hWaWBTpMsjmknLsIY1 argsType=object
04:42:27+00:00 error [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
04:42:27+00:00 error [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
04:42:29+00:00 warn agent/embedded {"subsystem":"agent/embedded"} read tool called without path: toolCallId=tool_lRRwBRv5sW0hZ1p2wJhpuHjv argsType=object
04:42:29+00:00 error [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
04:42:29+00:00 error [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.

Impact and severity

Medium - Tools become unusable after short session duration, requiring gateway restart

Additional information

  • Error first observed: 2026-03-26
  • Frequency: Consistent after ~15 minutes
  • Workaround exists but disrupts workflow
  • exec tool continues to work normally when read/write fail
  • Workaround: Use exec + cat to read files, exec + echo to write files
  • Manual openclaw gateway restart restores read/write functionality
  • Issue is reproducible: happens consistently after ~15 minutes of session activity

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingregressionBehavior that previously worked and now fails

    Type

    No type

    Fields

    Priority

    None yet

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions