Bug type

Behavior bug (incorrect output/state without crash)

Summary

问题： Kimi 系列模型调用 read 工具时反复漏传 path 参数，导致循环报错 Missing required parameter: path alias
复现场景： 使用 kimi-coding / kimi-moonshot 作为 agent 模型，启动新会话执行 BOOTSTRAP 流程时必现
根本原因： Kimi 对 required 字段遵循不稳定，需要在工具的 description 字段里也明确说明参数必填
建议修复： 在 read 工具定义的 description 中加一句，例如：
"path 参数必填，例如：path='BOOTSTRAP.md'"
日志内容：16:09:41+08:00 typing TTL reached (2m); stopping typing indicator
16:09:48+08:00 [agent/embedded] read tool called without path: toolCallId=tool_gdgU9WjBxrBSZOX4Wy3I3KTI argsType=object
16:09:48+08:00 [agent/embedded] read tool called without path: toolCallId=tool_tDBt6C95lkZ65lZmNB5y7AU9 argsType=object
16:09:48+08:00 [agent/embedded] read tool called without path: toolCallId=tool_1GNBUqC529XIElDCmgvAgvRQ argsType=object
16:09:48+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:09:48+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:09:48+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:10:05+08:00 [agent/embedded] read tool called without path: toolCallId=tool_LHs6N5c5BEuJCLE9dRNr5J8J argsType=object
16:10:05+08:00 [agent/embedded] read tool called without path: toolCallId=tool_V8qhH8eRhvgV0i6z1WFnNNih argsType=object
16:10:05+08:00 [agent/embedded] read tool called without path: toolCallId=tool_Q9QRGSL4vxi6YRgtSac1jCYp argsType=object
16:10:05+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:10:05+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:10:05+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:10:06+08:00 [ws] ⇄ res ✓ config.schema 159ms conn=c4d7bd8d…4e8c id=b0d65675…9599
16:10:06+08:00 [ws] ⇄ res ✓ config.get 56ms conn=c4d7bd8d…4e8c id=69e62825…bd93
16:10:13+08:00 [ws] ⇄ res ✓ config.get 236ms conn=c4d7bd8d…4e8c id=b1cc81e9…e296
16:10:16+08:00 [agent/embedded] read tool called without path: toolCallId=tool_TePj641OvjftDFYWXkyyo3bB argsType=object
16:10:16+08:00 [agent/embedded] read tool called without path: toolCallId=tool_dmjEeJZZjIUUJgthuZYFawNX argsType=object
16:10:16+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:10:16+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:10:27+08:00 [ws] ⇄ res ✓ chat.history 85ms conn=c4d7bd8d…4e8c id=36e60ecb…167e
16:11:00+08:00 [agent/embedded] read tool called without path: toolCallId=tool_f3Mu1xMktz6HbslxCWV93goj argsType=object
16:11:00+08:00 [agent/embedded] read tool called without path: toolCallId=tool_WpWdjjnLBjWtFcpUHUXjrmSi argsType=object
16:11:00+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:11:00+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:11:14+08:00 [agent/embedded] read tool called without path: toolCallId=tool_9aweyinjsy56zmxLrx3NTKS1 argsType=object
16:11:14+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:11:41+08:00 [agent/embedded] read tool called without path: toolCallId=tool_xAuRaDveH4pRUFIh3Z9YAPgF argsType=object
16:11:41+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:12:14+08:00 [agent/embedded] read tool called without path: toolCallId=tool_ciM3NsaqnA5uA7Qfr6TQdoif argsType=object
16:12:14+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:12:51+08:00 [agent/embedded] read tool called without path: toolCallId=tool_lAwYt44xSmEyh87vAhUf9F9e argsType=object
16:12:53+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:13:27+08:00 [agent/embedded] read tool called without path: toolCallId=tool_xtf5o3bTHmw0fiZMgHiustz5 argsType=object
16:13:27+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:13:50+08:00 [agent/embedded] read tool called without path: toolCallId=tool_zzc09mVQF4b8CnClofkEI8OV argsType=object
16:13:50+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:14:08+08:00 [agent/embedded] read tool called without path: toolCallId=tool_Ywy2mPNhfaoytswLA7E0PHEd argsType=object
16:14:08+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:14:22+08:00 [agent/embedded] read tool called without path: toolCallId=tool_Z0fvUjRWO0g6QcqeZZiV0iTW argsType=object
16:14:22+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:14:53+08:00 [agent/embedded] read tool called without path: toolCallId=tool_jNnD5TyCdg4zsjfuJCxNytES argsType=object
16:14:53+08:00 [agent/embedded] read tool called without path: toolCallId=tool_WIH89jszr0laGNzXkv9Adi2U argsType=object
16:14:53+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:14:53+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:15:04+08:00 [agent/embedded] read tool called without path: toolCallId=tool_AAy0R3vZwWtYokEq7gJuCS7P argsType=object
16:15:04+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:15:04+08:00 [ws] ⇄ res ✓ sessions.list 53ms conn=c4d7bd8d…4e8c id=02c69a09…3eca
16:15:15+08:00 [agent/embedded] read tool called without path: toolCallId=tool_dWtbqAXXiHL9i3VS9yaI6YrM argsType=object
16:15:15+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:15:42+08:00 [diagnostic] lane wait exceeded: lane=session:agent:main:feishu:direct:ou_effd346519030cba456e8300610635fb waitedMs=270913 queueAhead=0

Steps to reproduce

根本原因： Kimi 对 required 字段遵循不稳定，需要在工具的 description 字段里也明确说明参数必填

Expected behavior

建议修复： 在 read 工具定义的 description 中加一句，例如：
"path 参数必填，例如：path='BOOTSTRAP.md'"

Actual behavior

建议修复： 在 read 工具定义的 description 中加一句，例如：
"path 参数必填，例如：path='BOOTSTRAP.md'"

OpenClaw version

2026.3.24

Operating system

win10

Install method

node.js/cmd

Model

kimi-coding / kimi-moonshot

Provider / routing chain

moonshot

Additional provider/model setup details

No response

Logs, screenshots, and evidence

16:09:41+08:00 typing TTL reached (2m); stopping typing indicator
16:09:48+08:00 [agent/embedded] read tool called without path: toolCallId=tool_gdgU9WjBxrBSZOX4Wy3I3KTI argsType=object
16:09:48+08:00 [agent/embedded] read tool called without path: toolCallId=tool_tDBt6C95lkZ65lZmNB5y7AU9 argsType=object
16:09:48+08:00 [agent/embedded] read tool called without path: toolCallId=tool_1GNBUqC529XIElDCmgvAgvRQ argsType=object
16:09:48+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:09:48+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:09:48+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:10:05+08:00 [agent/embedded] read tool called without path: toolCallId=tool_LHs6N5c5BEuJCLE9dRNr5J8J argsType=object
16:10:05+08:00 [agent/embedded] read tool called without path: toolCallId=tool_V8qhH8eRhvgV0i6z1WFnNNih argsType=object
16:10:05+08:00 [agent/embedded] read tool called without path: toolCallId=tool_Q9QRGSL4vxi6YRgtSac1jCYp argsType=object
16:10:05+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:10:05+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:10:05+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:10:06+08:00 [ws] ⇄ res ✓ config.schema 159ms conn=c4d7bd8d…4e8c id=b0d65675…9599
16:10:06+08:00 [ws] ⇄ res ✓ config.get 56ms conn=c4d7bd8d…4e8c id=69e62825…bd93
16:10:13+08:00 [ws] ⇄ res ✓ config.get 236ms conn=c4d7bd8d…4e8c id=b1cc81e9…e296
16:10:16+08:00 [agent/embedded] read tool called without path: toolCallId=tool_TePj641OvjftDFYWXkyyo3bB argsType=object
16:10:16+08:00 [agent/embedded] read tool called without path: toolCallId=tool_dmjEeJZZjIUUJgthuZYFawNX argsType=object
16:10:16+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:10:16+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:10:27+08:00 [ws] ⇄ res ✓ chat.history 85ms conn=c4d7bd8d…4e8c id=36e60ecb…167e
16:11:00+08:00 [agent/embedded] read tool called without path: toolCallId=tool_f3Mu1xMktz6HbslxCWV93goj argsType=object
16:11:00+08:00 [agent/embedded] read tool called without path: toolCallId=tool_WpWdjjnLBjWtFcpUHUXjrmSi argsType=object
16:11:00+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:11:00+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:11:14+08:00 [agent/embedded] read tool called without path: toolCallId=tool_9aweyinjsy56zmxLrx3NTKS1 argsType=object
16:11:14+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:11:41+08:00 [agent/embedded] read tool called without path: toolCallId=tool_xAuRaDveH4pRUFIh3Z9YAPgF argsType=object
16:11:41+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:12:14+08:00 [agent/embedded] read tool called without path: toolCallId=tool_ciM3NsaqnA5uA7Qfr6TQdoif argsType=object
16:12:14+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:12:51+08:00 [agent/embedded] read tool called without path: toolCallId=tool_lAwYt44xSmEyh87vAhUf9F9e argsType=object
16:12:53+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:13:27+08:00 [agent/embedded] read tool called without path: toolCallId=tool_xtf5o3bTHmw0fiZMgHiustz5 argsType=object
16:13:27+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:13:50+08:00 [agent/embedded] read tool called without path: toolCallId=tool_zzc09mVQF4b8CnClofkEI8OV argsType=object
16:13:50+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:14:08+08:00 [agent/embedded] read tool called without path: toolCallId=tool_Ywy2mPNhfaoytswLA7E0PHEd argsType=object
16:14:08+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:14:22+08:00 [agent/embedded] read tool called without path: toolCallId=tool_Z0fvUjRWO0g6QcqeZZiV0iTW argsType=object
16:14:22+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:14:53+08:00 [agent/embedded] read tool called without path: toolCallId=tool_jNnD5TyCdg4zsjfuJCxNytES argsType=object
16:14:53+08:00 [agent/embedded] read tool called without path: toolCallId=tool_WIH89jszr0laGNzXkv9Adi2U argsType=object
16:14:53+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:14:53+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:15:04+08:00 [agent/embedded] read tool called without path: toolCallId=tool_AAy0R3vZwWtYokEq7gJuCS7P argsType=object
16:15:04+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:15:04+08:00 [ws] ⇄ res ✓ sessions.list 53ms conn=c4d7bd8d…4e8c id=02c69a09…3eca
16:15:15+08:00 [agent/embedded] read tool called without path: toolCallId=tool_dWtbqAXXiHL9i3VS9yaI6YrM argsType=object
16:15:15+08:00 [tools] read failed: Missing required parameter: path alias. Supply correct parameters before retrying.
16:15:42+08:00 [diagnostic] lane wait exceeded: lane=session:agent:main:feishu:direct:ou_effd346519030cba456e8300610635fb waitedMs=270913 queueAhead=0

Impact and severity

卡任务

Additional information

No response