乐于分享
好东西不私藏

OpenClaw内部命令详解exec + sessions + subagents + 工具篇

OpenClaw内部命令详解exec + sessions + subagents + 工具篇

掌握这些命令,让你的Agent更强大

你有没有想过:

OpenClaw能执行shell命令吗?

能管理多个会话吗?

能调用外部工具吗?

答案是:都能! OpenClaw提供了丰富的内部命令!

今天,全面解析OpenClaw的内部命令!

一、exec命令:执行Shell命令

exec是OpenClaw的Shell命令执行器

基本用法:

exec({ command: “ls -la” })

常用参数:

command:要执行的命令(必须)

timeout:超时时间(默认60秒)

workdir:工作目录

elevated:是否提升权限

实战示例:

exec({ command: “node script.js” }):运行Node脚本

exec({ command: “git status”, workdir: “/project” }):查看项目状态

exec({ command: “npm install”, timeout: 300 }):安装依赖(5分钟超时)

注意事项:

危险的删除命令需要确认(trash > rm)

Windows使用PowerShell命令

长时间任务设置合理的timeout

二、sessions命令:会话管理

sessions系列命令用于管理Agent会话

1. sessions_list:查看所有会话

sessions_list():列出所有可见会话

可筛选:kinds, activeMinutes, messageLimit

2. sessions_history:查看会话历史

sessions_history({ sessionKey: “agent:xxx” })

limit:限制返回消息数量

includeTools:是否包含工具调用

3. sessions_send:向会话发送消息

sessions_send({ sessionKey: “agent:xxx”, message: “hello” })

timeoutSeconds:等待回复超时

4. sessions_spawn:创建新会话

创建独立子会话运行任务

runtime:subagent 或 acp

三、subagents命令:子Agent管理

subagents命令用于管理多Agent协作中的子Agent

1. subagents(action=list):查看子Agent

列出当前会话的所有子Agent

recentMinutes:查看最近活跃的子Agent

2. subagents(action=steer):引导子Agent

向特定子Agent发送指令

target:子Agent的ID

message:要发送的消息

3. subagents(action=kill):终止子Agent

终止不需要的子Agent

target:子Agent的ID

使用示例:

subagents(action=list):查看当前有哪些子Agent在运行

subagents(action=steer, target=”agent-123″, message=”继续执行”)

四、工具类命令详解

OpenClaw还提供了丰富的工具命令:

1. memory_search:记忆搜索

memory_search({ query: “用户偏好” })

MEMORY.md和daily notes中搜索

2. memory_get:精确读取记忆

memory_get({ path: “MEMORY.md” })

读取指定路径的记忆文件

3. message:消息发送

message({ action: “send”, channel: “feishu”, message: “hello” })

发送消息到指定渠道

4. browser:浏览器控制

browser({ action: “screenshot” }):截图

browser({ action: “open”, url: “https://…” }):打开网页

browser({ action: “act”, kind: “click”, selector: “button” }):点击

五、TTS与媒体生成命令

OpenClaw支持多媒体生成:

1. tts:文字转语音

tts({ text: “要转化的文字” })

channel:指定输出格式

2. image_generate:图片生成

image_generate({ prompt: “描述”, size: “1024×1024” })

aspectRatio:宽高比

count:生成数量

3. music_generate:音乐生成

music_generate({ prompt: “描述” })

durationSeconds:时长

4. video_generate:视频生成

video_generate({ prompt: “描述” })

durationSeconds:时长

六、命令组合实战

实际使用中,命令往往组合使用:

场景1:自动化日报生成

exec({ command: “git log –since=yesterday” }):获取今日代码提交

memory_search({ query: “项目进度” }):查询项目状态

生成日报文档

message({ action: “send”, message: “日报已生成” }):通知用户

场景2:多Agent协作

subagents(action=spawn, agents=[pm, fs]):启动子Agent

sessions_send({ sessionKey: pm_key, message: “规划任务” })

subagents(action=list):监控子Agent状态

subagents(action=kill, target: fs_key):完成后终止

场景3:生成配图发送

image_generate({ prompt: “科技感封面” }):生成图片

message({ action: “send”, media: “图片路径” }):发送图片

七、总结:命令是Agent的武器

今天你学到了:

exec:执行Shell命令

sessions系列:管理Agent会话

subagents系列:管理子Agent

memory系列:记忆管理

message:消息发送

browser:浏览器控制

tts/image/music/video_generate:多媒体生成

掌握这些命令,让你的OpenClaw Agent无所不能!

下一步建议

OpenClaw中尝试使用exec命令执行简单任务

使用sessions系列命令管理多个任务

结合多个命令,创建自动化工作流

阅读OpenClaw官方文档了解更多命令

相关资源:

OpenClaw文档: docs.openclaw.ai/tools

—— 感谢阅读 ——

4月25日 技术教程 | OpenClaw内部命令详解

觉得有用请点赞收藏,转发给更多朋友!