Hardware FixRecommendedDevice not working? Your driver may be the problemCheck updates for common hardware issues.Fix DriversHalloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsClean PCRecommendedOne scan can reveal what keeps slowing WindowsLook for cleanup and repair opportunities.Run Scan×
FREEDOM251

Freedom251 › Blog › AI agents

OpenClaw Skills: What They Are and How to Install Them on a VPS

By Freedom251 Team · · 11 min read

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

OpenClaw skills are directory-based instruction packages centered on a SKILL.md file. The file tells an OpenClaw agent what a tool does and when to use it; supporting files can provide scripts, examples, or configuration. On a VPS, you install OpenClaw, inspect a skill, install it into either the project workspace or the shared ~/.openclaw/skills directory, configure its requirements, and verify its trust information before allowing an agent to run it.

This guide explains the storage model, installation sources, exact CLI commands, multi-agent scope, verification steps, and the common reasons a skill does not load.

As an Amazon Associate I earn from qualifying purchases.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What an OpenClaw skill is

OpenClaw defines a skill as “a markdown instruction file that teaches your agent how and when to use tools.” In practice, a skill is a directory whose required entry point is SKILL.md. The markdown describes the capability in language an agent can follow, while the directory may also contain helper scripts, templates, examples, or other support files.

That makes a skill different from a model plug-in hosted only in a provider’s cloud. The package is present on the machine where OpenClaw runs. OpenClaw loads bundled skills shipped with the installation and local overrides, then decides at load time whether each skill is eligible. Eligibility can depend on environment variables, required command-line binaries, and other conditions declared by the skill or configuration.

#1 Best Overall
Sale
TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Headphones | IPX5 Waterproof,2 Mics for AI Calls,Immersive Premium Sound Bass Headset with Charging Case,32 EQ via App Black
  • [Ultra-Lightweight Ear Buds Designed for Small Ears] Each earbud weighs only 3.7g and features a compact, ergonomic in-ear design made especially for small ears. Secure, low-profile, and comfortable for workouts, all-day wear or overnight sleeping.The ultra-slim profile sits flush in your ear with no hard edges poking or rubbing, so you can even sleep on your side without discomfort.
  • [Immersive Stereo Sound with TOZO OrigX Technology] TOZO OrigX tuning delivers clear vocals, balanced mids, and natural stereo sound for music, podcasts, and videos.
  • [Long Battery Life for Daily Use] Get up to 7 hours of playtime on a single charge, with up to 32 hours total using the charging case—ideal for workdays, commuting, and extended listening sessions.
  • [Bluetooth 5.3 & Stable Connection] Bluetooth 5.3 provides fast pairing, stable wireless performance, and reduced dropouts as you move around home or office.
  • [Deep Bass with Clear Vocals] High-performance drivers produce punchy bass while keeping vocals clean and detailed for everyday listening.

Why the distinction matters on a VPS

A VPS gives you a persistent Linux environment, so an installed skill can remain available across SSH sessions and agent restarts. It also means you are responsible for the package’s files, permissions, secrets, and updates. A skill that calls an external command will need that command installed on the VPS; a skill that calls an API will need its environment variable or API key configured there.

  • Instruction layer: the SKILL.md file explains usage and tool-selection rules.
  • Support layer: scripts and other files extend what the instructions can do.
  • Eligibility layer: OpenClaw filters skills according to binaries, environment, and configuration.
  • Scope layer: workspace, global, bundled, and per-agent settings determine who can see a skill.

Where OpenClaw stores skills

The default destination for openclaw skills install is the active workspace’s skills/ directory. A workspace installation belongs to that project context and is the right choice when one application or agent needs a capability that should not automatically appear elsewhere.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Adding --global changes the destination to the shared ~/.openclaw/skills directory. Global skills are visible to local agents unless an allowlist narrows visibility. This is convenient on a VPS hosting several projects, but it also expands the set of code and instructions that more agents may be able to use.

Loading precedence when names collide

If the same skill name exists in more than one location, OpenClaw gives precedence in this order:

  1. Workspace-level skills.
  2. Global skills in ~/.openclaw/skills.
  3. Bundled skills shipped with OpenClaw.

A workspace copy can therefore override a global or bundled copy. Treat that as an operational feature, not as a reason to copy unknown files into a project: a higher-precedence directory can change what an agent actually runs.

Per-agent visibility

Agent-level configuration can use a shared baseline or replace it with an explicit list of allowed skills. An empty list can lock an agent out of all skills. On a multi-agent VPS, install common capabilities globally and then give each agent only the skills it needs. This follows least privilege and makes accidental cross-project use less likely.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Supported ways to obtain a skill

OpenClaw supports four source styles. Choose based on how you intend to update and audit the package.

Source Command form Best fit Maintenance and trust considerations
ClawHub owner-qualified reference openclaw skills install @owner/<slug> Registry distribution with a stable skill name Use registry metadata and verification information before enabling; update through the registry workflow.
skills.sh reference openclaw skills install skills-sh:owner/repo/slug A skill published through the skills.sh namespace Confirm the owner, repository, and slug; repeat the inspection and verification process after changes.
Git repository openclaw skills install git:owner/repo@ref Pinning to a repository reference such as a branch, tag, or commit reference You control when to reinstall or move to another reference; inspect the repository contents and required runtime dependencies.
Local directory openclaw skills install ./path/to/skill --as my-tool Private development, an audited directory, or a package already on the VPS The source root must contain SKILL.md; you are responsible for copying changes and preserving permissions.

Git and local installs expect SKILL.md at the source root. The --as <slug> option overrides the name OpenClaw derives from the source. Use it when the repository or directory name is not the local name you want agents to reference.

Rank #2
Sale
Smart Watch for Men Women Compatible with iPhone Samsung Android Phone 1.69 inch Full Touch Screen IP68 Waterproof Bluetooh Fitness Tracker Heart Rate/Sleep Monitor (Black)
  • 【IP68 Waterproof Multifunctinal Smart Watch】Torjalph fitness activity tracker smart watch is IP68 waterproof technology ,you can wear it when swimming,handwashing,it's rain-proof which means that you perform multiple exercise modes outside without worrying about sweat or rain corroding your fitness smart watch,and this watch equipped with a 230 mAh large capacity battery magnetic charging ,and this sports activity tracker watch can be used 5-7 days If fully charged.
  • 【Larger 1.83'' Full Screen Watch & Multi-dial Selection】1.83 inch full HD color touch screen smart watch for men / women provides excellent 240*284 resolution image quality ,This Bluetooth smart watch offers a better touch experience and remarkable immersion and ,more than 200 watch faces for you to choose from App"Da Fit ", you can change the dial style according to your mood to wear keeping the world on your wrist
  • 【Accurate Activity Tracker Smart Watch 】sports watch activity tracker uses sweat and dust resistant breathable silicone strap, our Fitness Tracker Smart Watch for Android iOS Phones supports 12 sports modes,walking,running,bicycle,swimming,badminton,basketball,football,rope skipping. This bluetooth calls smart watch for men women is lightweight and stylish, bringing more convenient and relaxing sports experience while also providing more protection.
  • 【Your 24 Hour Personal Daily Health Monitor】Fitness watch for women men full touch screen IP67 waterproof bluetooth smartwatch for Android iOS Phones with heart rate blood pressure monitor multifunction Andriod smart watch with steps counter sleep monitor sports fitness watch, monitoring blood oxygen saturation allows you to understand your physical condition in real time to track fitness progress ,to know your health status in time.
  • 【More Functions Bluetooth Call Smart Watch】This fitness activity smart watch full screen for iPhone and Android phones includes a bunch of new features including:The bluetooth smart watch can hang up the phone, receive and display WhatsAPP /Text /Facebook /Twitter /Messenger reminder.Support sedentary reminder, alarm clock, stopwatch, timer,weather information,music control, remote camera control compatible with Android 5.0 and above or iOS 9.0 and above smartphones.

VPS prerequisites

You need a Linux VPS that you can reach over SSH, a user permitted to install software in the chosen location, and a supported Node.js runtime for OpenClaw. The project’s official installer can provision a supported Node.js runtime when one is needed. Run it only after you have connected to the intended server and reviewed the command for your environment.

  1. Provision a Linux VPS with enough disk space for OpenClaw, the skill directories, and any binaries the skills require.
  2. Connect over SSH as your administrative or deployment user.
  3. Update the operating system and establish your normal firewall, SSH-key, and user-permission policy before exposing an agent to the internet.
  4. Decide whether the skill belongs to one workspace or should be shared globally.
  5. Record which external binaries, environment variables, and API keys the skill requires.

Install OpenClaw on the VPS

From an SSH session on the target VPS, use the official installer or the package route documented by the project. The installer command is:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
curl -fsSL https://openclaw.ai/install.sh | bash

The installer provisions a supported Node.js runtime when needed, according to the project’s official README. If your organization requires package provenance or offline installation, use the project’s documented package route instead and apply your normal review process.

Confirm the CLI before installing skills

After installation, confirm that the OpenClaw executable is available to the same user and shell that will run the agent. Then inspect the current skill state:

openclaw skills list

If the command is not found, check the installation output, the user’s PATH, and whether OpenClaw was installed for a different account. Do not proceed by repeatedly installing copies under different users; first decide which account owns the workspace and its credentials.

Search, inspect, and check a skill

OpenClaw provides separate commands for discovery, metadata, and load eligibility. Use them in that order when you are evaluating a new capability.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Search the available catalog

openclaw skills search "calendar"

Replace the search term with the capability you need. Search results help you identify a candidate; they are not a substitute for reading its instructions or checking its requirements.

List what is installed or visible

openclaw skills list

Run this after an installation and whenever a per-agent allowlist changes. A skill can exist on disk yet be absent from an agent’s effective list because configuration filters it out.

Rank #3
New Bee Guitar Cable 10ft Electric Instrument Bass AMP Cord | 6.35mm Jack, Durable Design, Stage and Home Studio Use, Low Noise Shielded Electric Cord for Bass, Keyboard, Amp, Mixer
  • [Low Noise High Fidelity] New bee guitar cord with 22AWG oxygen-free-copper center conductors provides enhanced signal transfer, the PVC insulation material and the high-density stranded copper double shield provide noise rejection for quiet operation
  • [Ideal for Choice] New bee 1/4 straight and right angle metal connectors, ensures a secure connection in any instrument, pedal, or amp jack. L shape great fro on stage guitar stands
  • [Wide Compatible] Suitable for mixer, power amplifier, microphone, effector, decoder, equalizer, electoronic organ, electric guitar, electric bass and other electronic equipments. Widely used in the installation of smart home, karaoke speaker, professional stage audio, etc
  • [Easy Disassemble] Making incidental repairs quick and easy! Very nice, flexible cable
  • [Dont Hesite to Order] 24 hours customer services and professional technology team are standing by

Read a skill’s metadata

openclaw skills info <name>

Use the exact name shown by skills list. Inspect the description, source information, and any stated binaries, environment variables, or API keys before granting access.

Check load eligibility

openclaw skills check

This check helps identify unmet requirements that prevent a skill from loading. Typical causes are a missing executable, an unset environment variable, or configuration that excludes the skill.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Install a skill into the workspace

For a project-specific installation, run the owner-qualified command from the workspace in which the agent operates:

openclaw skills install @owner/<slug>

OpenClaw writes the package to that workspace’s skills/ directory. The skill is then subject to workspace precedence and the effective agent configuration for that project.

Install a registry skill globally

To place the same kind of package in the shared directory, add --global:

openclaw skills install @owner/<slug> --global

Global installation is useful when several local agents need one maintained capability. It is a poor default when agents have different trust boundaries, because visibility must then be restricted with per-agent allowlists.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Install from skills.sh

openclaw skills install skills-sh:owner/repo/slug

Keep the complete owner, repository, and slug reference. If the source publishes multiple skills, verify that the final path identifies the specific one you intend to enable.

Install from Git

openclaw skills install git:owner/repo@ref

The source root must contain SKILL.md. The reference after @ identifies the revision or ref supplied to OpenClaw. When you later want a different revision, reinstall using the new reference and repeat inspection and verification.

Rank #4
BSIMB 15.6" Digital Family Calendar & Chore Chart, No Subscription Fees
  • Digital Family Calendar: BSIMB digital calendar wall touch screen puts an end to your chaotic life. Designed for busy families, the digital calendar keeps you organised and in step with your family. Assign different colours and tasks to each family member to make family scheduling easier and more intuitive.
  • Easy Setup and Auto-Sync: Plug in, connect to WLAN and auto-syn your electric calendar in minutes. Digital wall calendar compatible with Google calendar, iCloud calendar, Outlook calendar, Cozi calendar and Yahoo calendar. Add events directly on the device or through the ecalendar app. Electronic calendar stays current whether you're at work or traveling—no manual updates needed.
  • All-In-One Home Assistant: Smart calendar builds habits and encourage independence with personalised chores. Display daily meal plan to reduce the daily ‘What's for dinner?’ stress. To-do lists keep track of everything you want. Turning chores into valuable achievements with stars and rewards, making life easier and more enjoyable.
  • Manage Anytime Anywhere: BSIMB electronic calendar for family stay connected with the powerful ecalendar app. Access and manage your digital wall calendar anytime, anywhere with free features like stars & rewards, photo screensaver, chore charts, meals plans, to-do lists etc. Electronic planner paid features like Magic Import tailor advanced tools for users with special needs.
  • Stay in Touch with Loved Ones: Share photos or videos from your phone to electronic wall calendar with app, instantly update your life moment, and keep in touch with your family, especially those who are far away; you can also surprise your smart calendar digital wall by sending him a wish card; it's also great for keeping tech-illiterate elders in touch with the youngsters.

Install a local directory

openclaw skills install ./path/to/skill --as my-tool

Run this with a path that is readable by the OpenClaw user. Confirm that ./path/to/skill/SKILL.md exists at the source root. Use --as my-tool only when you intentionally want to override the derived local slug.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Configure binaries, environment variables, and API keys

Installation copies or registers the skill; it does not automatically satisfy the skill’s runtime requirements. Read SKILL.md and the output of openclaw skills info <name> for required command-line binaries, environment variables, and API keys. Install binaries using your normal operating-system package policy, and provide secrets through the account or service environment that runs OpenClaw.

OpenClaw’s configuration is stored at ~/.openclaw/openclaw.json. The skills section supports extra skill directories, symlink-target allowlists, file watching, bundled-skill allowlists, installer preferences, and per-skill environment or API-key settings. Keep the configuration readable only by the account that needs the secrets, and avoid placing keys directly in SKILL.md or source-control repositories.

Configuration decisions to make

  • Extra directories: use them when an audited skill tree lives outside the workspace and global directory.
  • Symlink targets: allow only directories you explicitly trust; a symlink can expose files outside the apparent skill folder.
  • File watching: enable it only when you want OpenClaw to notice local skill changes automatically.
  • Bundled-skill allowlist: restrict which bundled capabilities may load.
  • Installer preferences: align automatic installation behavior with your change-control policy.
  • Per-skill environment and API-key settings: give each skill only the credentials it needs.

Verify a registry skill before enabling it

For registry-based skills, inspect the verification information before allowing an agent to use the package:

openclaw skills verify @owner/<slug>

The verification result can return a trust envelope and expose the current security-scan state. Add --card when you want the verification card presented in a more inspectable form:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
openclaw skills verify @owner/<slug> --card

Verification is evidence to review, not permission to skip your own audit. Read the SKILL.md, inspect scripts and referenced binaries, confirm the package owner and source, and decide whether the requested permissions fit the agent’s job. A scan state can change after a package update, so repeat verification when you reinstall or move to a new revision.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Control access on a VPS with multiple agents

A practical multi-agent arrangement is to separate installation scope from execution scope:

  1. Install broadly reusable, audited skills in ~/.openclaw/skills.
  2. Install project-specific or experimental skills inside the relevant workspace.
  3. Use each agent’s explicit allowlist to expose only its required skills.
  4. Keep an agent’s environment and API-key settings limited to its own integrations.
  5. Run openclaw skills list and openclaw skills check as the agent’s runtime user to confirm the effective view.

Remember that an empty explicit list can disable every skill for that agent. If a capability disappears after a configuration change, check whether the agent is using a replacement list rather than inheriting the shared baseline.

Choosing workspace, global, Git, or local installation

Question Workspace install Global install Git or local source
Who sees it? Agents operating in that workspace, subject to allowlists Potentially all local agents, subject to allowlists Depends on the destination you choose
When is it preferable? One project, isolated credentials, or testing Several agents need the same audited capability You need a controlled revision or private source
How is it updated? Reinstall in the workspace Reinstall globally Reinstall after changing the Git ref or local files
Main risk Another workspace may not have the skill when expected Unintended agents may gain visibility Changes may be missed if you do not track the source revision

Use the narrowest scope that satisfies the project. Global installation reduces duplication, while workspace installation reduces blast radius. Source choice and scope are independent: a Git or local package can be installed either way.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Troubleshooting common installation failures

The CLI is unavailable

Check that OpenClaw was installed for the current user and that its executable directory is on PATH. Reconnect with the account that owns the workspace, then run openclaw skills list again. If the installer was run under another account, do not assume that account’s global skills or configuration are visible to yours.

The skill installs but does not appear

Run openclaw skills list from the intended workspace and account. Confirm the destination directory, the skill’s name, and the agent’s allowlist. A global package can be hidden by an explicit per-agent list, while a workspace package can be shadowed by a higher-precedence copy with the same name.

The source is rejected

For Git and local installs, verify that SKILL.md is at the source root rather than in a nested subdirectory. If you need a different name, add --as with the desired slug and then use that name with skills info.

skills check reports missing requirements

Install the required binary, set the required environment variable, or provide the required API-key setting under the skills section of ~/.openclaw/openclaw.json. Run the check again as the same user and runtime environment that will execute the agent; a variable available in your interactive shell may not be available to another service account.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A skill works in one agent but not another

Compare each agent’s allowlist and configuration. Visibility can differ even when both agents share the same global directory. Also check whether one agent is operating in a workspace containing a higher-precedence copy.

A previously working skill changes behavior

Identify whether the package was reinstalled, moved to another Git reference, or overridden by a workspace copy. Review the current SKILL.md and scripts, rerun verification for registry sources, and restore the last audited revision if your change-control process requires it.

Safe operating checklist

  • Use SSH keys and a dedicated Linux account rather than sharing root credentials with agents.
  • Read SKILL.md before installation, including every command and external service it references.
  • Confirm required binaries and permissions before supplying secrets.
  • Prefer workspace scope for experiments and global scope only for skills that multiple agents genuinely need.
  • Use per-agent allowlists to enforce least privilege.
  • Keep API keys in OpenClaw configuration or the runtime environment, not in repositories or instruction files.
  • Review symlink targets and extra directories before enabling them.
  • Run openclaw skills list, openclaw skills info, and openclaw skills check after installation.
  • Run openclaw skills verify for registry skills and inspect the trust envelope or security-scan state.
  • Repeat the review whenever a skill is updated, reinstalled, or moved to another source revision.

Recommended installation workflow

For most VPS deployments, the safest sequence is deliberately procedural:

  1. Connect to the VPS over SSH and choose the account and workspace that will run OpenClaw.
  2. Install OpenClaw with the official installer or the project’s documented package route.
  3. Run openclaw skills search to find a candidate and openclaw skills info to understand its requirements.
  4. Inspect the source and verification information before enabling a third-party package.
  5. Install it into the workspace first; use --global only when several agents need the same audited capability.
  6. Configure binaries, environment variables, API keys, and any allowlists in ~/.openclaw/openclaw.json.
  7. Run openclaw skills list and openclaw skills check as the real runtime user.
  8. Expose the skill to an agent through the narrowest allowlist that meets the job.
  9. After updates, repeat inspection, verification, and eligibility checks rather than assuming the previous state still applies.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

AI agentsAutomationDeveloper ToolsLinuxOpenClawVPS

Leave a Reply

Your email address will not be published. Required fields are marked *

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.