Skip to main content

Documentation Index

Fetch the complete documentation index at: https://claworc.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Skills are knowledge packages that extend what your OpenClaw instances can do. A skill bundles instructions and optional reference files into a .zip archive that you upload once and deploy to any running instance.

​
The skills page

The Skills page in the dashboard has two tabs:
  • Library — private skills you have uploaded. You can deploy or delete them from here.
  • Discover — search Clawhub for community-published skills and deploy them directly to your instances.
Community skills from Clawhub contain agent instructions that run with full access to the instance. Always review a skill’s instructions before deploying it.

​
Uploading a skill

  1. Open the Skills page and click Upload Skill.
  2. Select a .zip file containing a SKILL.md at the root.
  3. The skill appears in your Library after upload.

​
Skill format

Every skill archive must follow the specification and include a SKILL.md file at the top level. This file uses YAML frontmatter to describe the skill, followed by Markdown instructions that the agent will follow. A skill can also declare environment variables it needs at runtime by listing them under required_env_vars. 
---
name: "Web researcher"
description: "Searches the web and summarizes findings"
required_env_vars:
  - API_KEY
  - PROVIDER_NAME
---

When asked to research a topic, search the web for recent sources
and compile a concise summary with citations.
The dashboard surfaces required_env_vars so you can supply the values when deploying the skill to an OpenClaw instance. You can include extra files alongside SKILL.md (for example, templates or reference documents). These files are deployed to the instance together with the skill instructions.

​
Editing a skill

From the Library tab, open a skill to launch the in-dashboard editor. The editor is split into two panes:
  • Left pane — alphabetical list of files in the skill.
  • Right pane — Monaco-based editor with syntax highlighting based on the file extension (Markdown, Python, TypeScript, JSON, YAML, shell, and others).
Editing SKILL.md and saving updates the skill’s name, description, and required_env_vars. The dashboard validates the frontmatter on save and rejects invalid YAML. Unsaved files are marked with an asterisk next to their name. Press Cmd/Ctrl+S to save the current file. Press Esc to close the editor — if you have unsaved changes, you are asked to confirm before discarding them. Binary files are shown read-only. The editor edits files in place; it does not add or remove files. To change the file set, re-upload the skill archive.

​
Deploying a skill

  1. Find the skill in your Library or search for it in the Discover tab.
  2. Click Deploy on the skill card.
  3. Select one or more running instances to deploy to.
  4. The skill files are copied to each selected instance and become available to the agent immediately.