乐于分享
好东西不私藏

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内部命令详解

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