// Execute shell commands on a remote host via QuickDesk and return stdout, stderr, and exit code. Use when the user asks to run a command, script, or terminal operation on a remote machine — supports configurable timeout and working directory.
| name | shell-runner |
| description | Execute shell commands on a remote host via QuickDesk and return stdout, stderr, and exit code. Use when the user asks to run a command, script, or terminal operation on a remote machine — supports configurable timeout and working directory. |
| metadata | {"openclaw":{"os":["win32","darwin","linux"],"install":[{"id":"binary","kind":"binary","package":"shell-runner"}]}} |
Run shell commands on a remote host connected through QuickDesk. Commands execute via cmd /C on Windows or sh -c on Unix.
Execute a shell command on the remote host.
Returns:
{
"exit_code": 0,
"stdout": "...",
"stderr": "...",
"stdout_truncated": false,
"stderr_truncated": false
}
Output is truncated at 512 KB per stream if the command produces large output.
run_command with the desired command string.exit_code — 0 means success, non-zero indicates failure.exit_code is non-zero, inspect stderr for error details.timeout_secs beyond the 60-second default.working_dir to execute commands in a specific directory without changing global state.Read, write, list, move, and inspect files and directories on a remote host via QuickDesk. Use when the user needs to browse folders, view file contents, create or edit files, rename or relocate files, or check file metadata (size, permissions, modification time) on a remote machine.
Retrieve system information and list running processes on a remote host via QuickDesk. Use when the user asks to check server health, monitor CPU or memory usage, view disk space, list running processes, or query OS and uptime details on a remote machine.