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内部命令详解
觉得有用请点赞收藏,转发给更多朋友!
夜雨聆风