/docs/skills/

Skills Reference

All skills are pre-installed on your bot. Just talk to it naturally and it will use the right tool for the job.

How Skills Work

Skills are built-in capabilities that your OpenClaw bot can use. You do not need to install anything — all skills come pre-loaded. Some skills work out of the box, while others require an integration token to be configured in the dashboard before they become active.

To use a skill, simply ask your bot to do something. For example, say "search the web for recent news about AI" and it will use the web-search skill. Say "create a new GitHub issue" and it will use the github skill.

Active — works out of the box
Needs token — requires integration setup
Disabled — macOS only, not available

Productivity

Skills for managing tasks, projects, and knowledge bases.

Skill Status Token Required Description
notion Needs token NOTION_API_KEY Read, create, and update Notion pages and databases
trello Needs token TRELLO_API_KEY, TRELLO_TOKEN Manage Trello boards, lists, and cards
github Needs token GH_TOKEN Interact with repos, issues, PRs, and code on GitHub
bear-notes Disabled macOS only. Not available on ClawBlitz.

Communication

Skills for interacting with messaging platforms and social media.

Skill Status Token Required Description
slack Needs token SLACK_BOT_TOKEN, SLACK_APP_TOKEN Send and receive messages in Slack via channel connection
discord Needs token DISCORD_TOKEN Send and receive messages in Discord via channel connection
telegram Needs token TELEGRAM_TOKEN Send and receive messages on Telegram via channel connection
whatsapp Needs token WHATSAPP_ACCESS_TOKEN Send and receive messages on WhatsApp via channel connection
x-twitter Needs token X_API_KEY + 3 more Post tweets, read timelines, interact on X/Twitter
imsg Disabled macOS only (iMessage). Not available on ClawBlitz.

Email

Email-related skills and their limitations on the managed platform.

Skill Status Token Required Description
gmail Requires Setup OAuth (via Google Cloud Console) Gmail access through gogcli. Requires a one-time OAuth setup: create credentials in Google Cloud Console, complete the auth flow in your browser, then provide the credentials to your bot via chat. Works in both interactive sessions and cron jobs once authenticated.

Setup: The Gmail skill uses gogcli and requires a one-time OAuth setup. Create OAuth credentials in the Google Cloud Console, complete the authorization flow in your browser on your local machine, then provide the resulting credentials to your bot via chat. Once authenticated, Gmail works in both interactive sessions and cron jobs.

Web

Skills for searching and retrieving information from the internet.

Skill Status Token Required Description
web-search Active Search the web and return relevant results
web-fetch Active Fetch and extract content from a specific URL
web-browse Active Browse web pages interactively, follow links, extract data

File Management

Skills for reading, writing, and searching files on the bot's persistent storage.

Skill Status Token Required Description
file-read Active Read contents of files on the bot's storage
file-write Active Create and write files to the bot's storage
file-search Active Search for files by name or content on the bot's storage

Storage: Your bot starts with 5 GB of persistent storage that auto-expands as needed. You can trigger a storage cleanup from the dashboard to free up space used by conversation history and temporary files.

Development

Skills for working with code and version control.

Skill Status Token Required Description
git Active Run git commands on the bot's local storage (clone, commit, diff, etc.)
code-exec Active Execute code snippets in a sandboxed environment

Limitations: There is no root access, no SSH, and no pip install on the managed platform. The bot runs in a managed environment with pre-installed dependencies. You cannot install additional system packages or Python libraries.

System

Built-in system skills for scheduling and persistent memory.

Skill Status Token Required Description
cron Active Schedule recurring tasks. Ask the bot to "remind me every Monday" or "check GitHub issues daily."
memory Active Persistent memory across conversations. The bot remembers facts, preferences, and context you share with it.

Disabled Skills (macOS Only)

The following skills require macOS system APIs and are not available on ClawBlitz's managed environment. They are part of OpenClaw's full skill set but cannot function on a Linux server.

Skill Reason
apple-notes Requires macOS Apple Notes API
apple-reminders Requires macOS Reminders API
bear-notes Requires macOS Bear app
imsg Requires macOS iMessage

Customizing Behavior with SOUL.md

Your bot's system prompt is defined in a file called SOUL.md. This is where you set the bot's personality, instructions, rules, and context. You can edit SOUL.md directly from the ClawBlitz dashboard.

# Example SOUL.md
You are a helpful project manager assistant.

## Rules
- Always respond in a professional tone
- When asked about tasks, check Trello first
- Summarize GitHub PRs when asked for status updates
- Never share API keys or credentials in responses

Changes to SOUL.md take effect on the next message. Skills available to the bot are determined by which integration tokens are configured, not by SOUL.md.