Execute shell commands for system operations, directory creation, and script execution. When you need to run system commands, execute scripts, install packages, or manage processes. Note - if commands fail consecutively, try different approaches.
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
执行 Shell 命令。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| command | string | 是 | 要执行的 Shell 命令 |
| cwd | string | 否 | 工作目录（可选） |
| timeout | integer | 否 | 超时时间（秒），默认 60，范围 10-600 |
列出目录:
{"command": "ls -la"}
安装依赖:
{"command": "pip install requests", "timeout": 300}
在指定目录执行:
{"command": "npm install", "cwd": "/path/to/project"}
系统会自动将 PowerShell 命令通过 -EncodedCommand（Base64 UTF-16LE）编码执行，
避免 cmd.exe → PowerShell 的多层引号/特殊字符转义破坏。直接传入 PowerShell 命令即可。
| 场景 | 推荐方式 | 原因 |
|---|---|---|
| 简单系统查询（进程/服务/文件列表） | PowerShell cmdlet | Get-Process, Get-ChildItem 等一行搞定 |
| 复杂文本处理（正则、URL 提取、HTML/JSON 解析） | Python 脚本 | 避免 PowerShell 正则 one-liner 的复杂性 |
| 批量文件操作（重命名、过滤、转换） | Python 脚本 | 更可靠，不受 PowerShell 管道转义影响 |
| 网络下载/HTTP 请求 | Python 脚本 | requests/urllib 比 Invoke-WebRequest 更灵活 |
对于复杂文本处理任务，务必使用 write_file + run_shell 组合：
步骤 1: write_file 写入 data/temp/task_xxx.py
步骤 2: run_shell "python data/temp/task_xxx.py"
禁止：在 run_shell 中写包含复杂正则的 PowerShell one-liner，例如：
# 禁止这种写法
powershell -Command "Get-Content file.html | Select-String -Pattern '(?<=src=\")[^\"]+' | ForEach-Object { $_.Matches.Value } | Sort-Object -Unique | Out-File urls.txt"
应改为写 Python 脚本：
import re
from pathlib import Path
html = Path("file.html").read_text(encoding="utf-8")
urls = sorted(set(re.findall(r'src="([^"]+)"', html)))
Path("urls.txt").write_text("\n".join(urls), encoding="utf-8")
get_session_logs 查看详细日志write-file: 写入文件read-file: 读取文件No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Record important information to long-term memory for learning user preferences, successful patterns, and error lessons. When you need to remember user preferences, save successful patterns, or record lessons from errors.
The English summary is being prepared. Showing the original description.
Click page elements by CSS selector or text content. When you need to click buttons, links, or select options. PREREQUISITE - must use browser_navigate to open target page first.
The English summary is being prepared. Showing the original description.
Extract page content and element text from current webpage. When you need to read page information, get element values, scrape data, or verify page content.
The English summary is being prepared. Showing the original description.
List all open browser tabs with their index, URL and title. When you need to check what pages are open, manage multiple tabs, or find a specific tab to switch to.
The English summary is being prepared. Showing the original description.
Navigate browser to specified URL to open a webpage. When you need to open webpages or start web automation. PREREQUISITE - must call before browser_click/type operations. Auto-starts browser if not running.
The English summary is being prepared. Showing the original description.
Open new browser tab and navigate to URL (keeps current page open). When you need to open additional page without closing current, or multi-task across pages. PREREQUISITE - must confirm browser is running first.
The English summary is being prepared. Showing the original description.