← Back to Skills Marketplace
172
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install computer-use-linux
Description
Top-level Linux computer-use skill with a bundled standalone runtime that bootstraps itself without any local Claude installation, private native modules, or...
README (SKILL.md)
Linux Computer-Use Skill
Use this skill when the task needs a portable Linux computer-use skill bundled with its own standalone runtime and MCP server.
What this skill does
- uses the bundled
linux-computer-use-skillproject under the installed skill directory - builds the standalone MCP server
- lets the server auto-bootstrap its Python runtime on first launch
- avoids any dependency on local Claude binaries,
.nodemodules, or extracted app assets - stays explicitly Linux-only because the underlying desktop-control backend is Linux-specific
Default bundled project path
After installation, assume the standalone project lives at:
~/.codex/skills/computer-use-linux/project
If the user installed the skill under a custom CODEX_HOME, use that equivalent path instead.
Build
Always build from the bundled project:
cd ~/.codex/skills/computer-use-linux/project
npm install
npm run build
Run
cd ~/.codex/skills/computer-use-linux/project
node dist/cli.js
The first real run will automatically create .runtime/venv and install the public Python dependencies.
Validation notes
- Version
0.1.1fixes the shared system-key blocklist and tool capability typings so Linux builds use Linux-specific shortcut protections instead of a broken copied platform branch. - This project has been statically validated from macOS for TypeScript build health, bundled project integrity, and Python helper syntax, but still needs end-to-end runtime validation on a real Linux desktop.
Guardrails
- Treat this host as trusted-local only.
- Do not tell the user to search their local Claude install for binaries or hidden assets.
- Be explicit that this runtime is standalone and uses public dependencies only.
- Mention that the current runtime reports
screenshotFiltering: none, so action gating is handled at the MCP layer.
Usage Guidance
What to consider before installing:
- Functionality & sensitivity: this skill captures screenshots, accesses clipboard/process info, enumerates installed/running apps, and can synthesize keyboard/mouse events — these are powerful and privacy-sensitive capabilities. Only install if you trust the author and intend to grant those abilities.
- Missing metadata: the skill fails to declare required binaries (Node >=20, npm, Python). Confirm those prerequisites on your system before installing, and request the author update the metadata.
- Network & disk activity: the build/run steps run `npm install` and will create a Python virtualenv and `pip install` packages from PyPI — expect network downloads and files written into your home directory (~/.codex/skills/... and a .runtime/venv). If you require offline or audited installs, review package-lock.json and runtime/requirements.txt and consider installing in a VM or sandbox first.
- Review code & scripts: inspect scripts/install.sh and the runtime (runtime/linux_helper.py and the TypeScript files) yourself or have someone you trust review them. Look specifically for subprocess.exec/execFile calls or any unexpected outbound network calls in the omitted files.
- Run safely: if you want to try it, run the server in an isolated environment (VM, container, or non-production account) and monitor network traffic and filesystem changes. Consider denying autonomous invocation until you’re comfortable with behavior, or run the skill only when explicitly invoked.
- If you need help: ask the author to (1) declare required binaries/env in registry metadata, (2) document exactly what files/paths it writes, and (3) provide a reproducible minimal install/test plan for offline review.
Capability Analysis
Type: OpenClaw Skill
Name: computer-use-linux
Version: 0.1.1
The 'computer-use-linux' skill bundle is a comprehensive implementation of a Linux desktop automation tool using the Model Context Protocol (MCP). It provides capabilities for screenshots, mouse/keyboard control, and clipboard access via a Node.js CLI and a Python helper script (linux_helper.py). The project demonstrates a high degree of security awareness, incorporating robust features such as an application allowlist, a system-level shortcut blocklist (keyBlocklist.ts), and tiered permissions that restrict interaction with sensitive apps like browsers and terminals (deniedApps.ts). The runtime bootstrap process (pythonBridge.ts) and installation script (install.sh) follow standard practices for managing local environments. While the skill possesses high-risk capabilities inherent to desktop control, its behavior is strictly aligned with its stated purpose and includes significant safeguards to prevent abuse.
Capability Assessment
Purpose & Capability
The skill's description says it's a standalone Linux computer-use runtime and MCP server, and the code implements X11 screenshotting, keyboard/mouse control, process/app enumeration, and first-run virtualenv bootstrapping — that matches purpose. However the registry metadata lists no required binaries/env but the SKILL.md and code require Node (>=20), npm, and a Python runtime (to be bootstrapped). The omission of required binaries in metadata is an incoherence developers should fix.
Instruction Scope
SKILL.md explicitly instructs building (npm install, npm run build) and running node dist/cli.js from the bundled project and allows the server to auto-bootstrap a Python venv and pip-install runtime deps. The runtime code enumerates displays, captures screenshots, lists installed/running apps, reads process executable paths (psutil), and can synthesize input via pyautogui — all within the claimed scope. There is no instruction to read unrelated user files or call external endpoints in the SKILL.md, but the runtime will access local process and display state (sensitive).
Install Mechanism
No formal install spec is declared (instruction-only), but SKILL.md requires running npm install and the first-run bootstraps a Python virtualenv and pip-installs requirements from PyPI. That implies network downloads and writing files into the user home (~/.codex/skills/... and .runtime/venv). Using npm/pip is expected for this project, but it is higher risk than an instruction-only, no-download skill because it pulls code from registries at install/run time.
Credentials
The skill does not request credentials or environment secrets. It references optional env flags (CLAUDE_COMPUTER_USE_DEBUG, CODEX_THREAD_ID etc.) which are reasonable for runtime configuration. No disproportionate or unrelated credentials are required.
Persistence & Privilege
The skill is not always-enabled and follows the default model-invocation policy (agent may call the skill autonomously). It writes files under the user's home (config/lock files and the bundled project path) and creates a Python venv on first run — expected for this runtime but means it gains persistent presence and the ability to perform desktop actions on the host. Autonomous invocation combined with desktop-control capabilities increases blast radius; consider whether you want automatic agent-initiated GUI actions.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install computer-use-linux - After installation, invoke the skill by name or use
/computer-use-linux - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.1
Fix Linux shared platform typing and system-key blocklist logic, sync bundled skill payload, and upgrade multilingual README plus validation notes.
Metadata
Frequently Asked Questions
What is Computer Use Linux?
Top-level Linux computer-use skill with a bundled standalone runtime that bootstraps itself without any local Claude installation, private native modules, or... It is an AI Agent Skill for Claude Code / OpenClaw, with 172 downloads so far.
How do I install Computer Use Linux?
Run "/install computer-use-linux" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Computer Use Linux free?
Yes, Computer Use Linux is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Computer Use Linux support?
Computer Use Linux is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Computer Use Linux?
It is built and maintained by wimi321 (@wimi321); the current version is v0.1.1.
More Skills