OpenClaw 常用工具目录

这一页不追求列出所有工具，而是先抓住最常见、最有代表性的几类。

文件类工具

`read`

用途：读取文本文件或图片内容。

适合场景：

查看源码
查看配置
查看文档
局部读取大文件

关键点：

支持 offset / limit 读取
大文件应分段读取
适合做精确上下文收集

`write`

用途：创建或覆盖文件。

适合场景：

新建文档
生成配置
一次性写入完整内容

注意：

它是覆盖写，不是补丁式编辑
对已有文件修改时，若只改小片段，通常 edit 更稳

`edit`

用途：对文件做精确文本替换。

适合场景：

修改已有代码片段
微调配置
做小范围补丁

注意：

oldText 必须精确匹配
更适合“已知上下文 + 小范围修改”

执行类工具

`exec`

用途：执行 shell 命令。

适合场景：

构建项目
跑测试
检查系统状态
SSH 到远程主机排查

关键点：

可设置 timeout
可设置 yieldMs
长任务可以后台运行
需要 TTY 的命令可尝试 pty=true

`process`

用途：管理后台 exec 进程。

常见动作：

poll
log
write
kill

适合场景：

跟踪长任务
查看后台构建日志
向交互进程写入输入

记忆类工具

`memory_search`

用途：语义搜索长期记忆和 daily memory。

何时应该优先用：

用户问“上次我们怎么定的？”
用户问某个决定、偏好、日期、待办
需要引用历史约定

`memory_get`

用途：按文件和行号安全读取记忆片段。

通常与 memory_search 搭配：

先 search
再 get 具体行
最后在回答中引用必要片段

会话类工具

`sessions_spawn`

用途：派生新的隔离会话或 ACP 任务。

适合场景：

复杂任务
长时间任务
需要不同 runtime
需要 thread-bound 持续上下文

`sessions_send`

用途：给另一个会话发送消息。

`subagents`

用途：查看、干预、终止子代理执行。

一个经验法则

短平快 → 本地工具
长链路 / 重分析 → 子代理
用户明确指定外部 coding runtime → ACP harness