### SKILL.md Usage Example

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/api/skills/examples.mdx

This markdown snippet illustrates how to use the setup script's status output within a SKILL.md file. It outlines conditional logic based on parsed status variables.

```markdown
Run `bash setup.sh` and parse the status block.

- If NODE_OK=false → install Node.js
- If DEPS_OK=false → delete node_modules and retry
- Record PLATFORM and IS_WSL for later steps
```

--------------------------------

### Install claw CLI

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/cli.mdx

Run the `/claw` skill to install the claw CLI script and symlink it to your bin directory. Verify the installation by listing available groups.

```bash
/claw
```

```bash
claw --list-groups
```

--------------------------------

### X Integration Usage Examples

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/x-twitter.mdx

Examples of how to interact with the X integration from any channel where the agent is active.

```bash
@Andy post a tweet about our latest release
```

```bash
@Andy check my recent mentions on X
```

```bash
@Andy reply to that tweet thread
```

--------------------------------

### Install Docker on macOS

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/installation.mdx

Installs Docker Desktop using Homebrew and launches the application.

```bash
brew install --cask docker
open -a Docker
```

--------------------------------

### Run Nanoclaw Quick Start

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/installation.mdx

Executes the main Nanoclaw script to start the application.

```bash
bash nanoclaw.sh
```

--------------------------------

### Writing SKILL.md for Feature Skills

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/advanced/contributing.mdx

This example illustrates the content of a SKILL.md file for feature skills, intended for the marketplace. It includes sections for setup steps and design decisions, such as technology choices and configuration management.

```markdown
## Design decisions

- Use polling instead of webhooks for simplicity
- Store Telegram credentials in the .env file
- Reuse the existing message queue system
```

--------------------------------

### Clone and Run NanoClaw Installer

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/installation.mdx

Clone the NanoClaw repository and execute the installation script. The installer handles bootstrap, container build, credential registration, channel pairing, and service installation.

```bash
git clone https://github.com/qwibitai/nanoclaw.git
cd nanoclaw
bash nanoclaw.sh
```

--------------------------------

### View Nanoclaw Setup Log

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/installation.mdx

Displays the content of the Nanoclaw setup progression log file.

```bash
cat logs/setup.log
```

--------------------------------

### Install Marketplace Plugin

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/skills-system.mdx

Install the NanoClaw skills marketplace plugin for your project. This command is typically run during the `/setup` process.

```bash
claude plugin install nanoclaw-skills@nanoclaw-skills --scope project
```

--------------------------------

### Install Apple Container on macOS

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/installation.mdx

Installs the 'container' command-line tool using Homebrew and verifies the installation.

```bash
brew install container
container --version
```

--------------------------------

### Install Ollama and Pull a Model

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/ollama.mdx

Installs Ollama on macOS/Linux and downloads a specified model. Ensure Ollama is running before starting NanoClaw.

```bash
curl -fsSL https://ollama.com/install.sh | sh

ollama pull llama3.2        # Good general purpose (2GB)
ollama pull gemma3:1b       # Small and fast (1GB)
ollama pull qwen3-coder:30b # Best for code tasks (18GB)
```

--------------------------------

### Example .env File Configuration

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/api/configuration.mdx

Provides an example of how to configure NanoClaw using a .env file. This includes settings for assistant name, container timeouts, concurrent containers, timezone, and OneCLI URL.

```bash
ASSISTANT_NAME=Andy
ASSISTANT_HAS_OWN_NUMBER=false
CONTAINER_TIMEOUT=1800000
MAX_CONCURRENT_CONTAINERS=5
TZ=America/Los_Angeles
ONECLI_URL=http://127.0.0.1:10254
```

--------------------------------

### Agent Send Email Example

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/gmail.mdx

Example of how to instruct an agent to send an email.

```text
@Andy send an email to team@company.com with subject "Weekly update" and body "Here's the update..."
```

--------------------------------

### Install Local Whisper Skill

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/voice-transcription.mdx

Installs the local whisper.cpp transcription skill onto your nanoclaw-whatsapp fork. This requires the voice-transcription skill to be installed first.

```bash
git fetch whatsapp skill/use-local-whisper
git merge whatsapp/skill/use-local-whisper
```

--------------------------------

### Usage Examples

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/parallel-ai.mdx

Examples of how to prompt the agent to perform web searches using the Parallel AI skill.

```text
@Andy search the web for NanoClaw reviews
@Andy do a deep research on Claude Agent SDK best practices
```

--------------------------------

### Clear Sub-task Delegation Prompt Example

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/agent-swarms.mdx

Example of a prompt that breaks down a request into clear, numbered sub-tasks to guide agent delegation.

```text
@Andy:
1. Fetch data from sources A, B, and C (parallel)
2. Analyze each dataset
3. Create comparison report
```

--------------------------------

### Install PDF Reader Skill (CLI)

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/pdf-reader.mdx

Install the PDF reader skill by fetching and merging it on your nanoclaw-whatsapp fork. After merging, rebuild the container.

```bash
# On your nanoclaw-whatsapp fork
git fetch whatsapp skill/pdf-reader
git merge whatsapp/skill/pdf-reader
```

```bash
./container/build.sh
```

--------------------------------

### Install X Integration Manually

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/x-twitter.mdx

Manually install the X integration by fetching and merging the skill from the upstream branch.

```bash
git fetch upstream skill/x-integration
git merge upstream/skill/x-integration
```

--------------------------------

### Install Image Vision Skill (Bash)

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/image-vision.mdx

Install the image vision skill on your nanoclaw-whatsapp fork using git commands.

```bash
git fetch whatsapp skill/image-vision
git merge whatsapp/skill/image-vision
```

--------------------------------

### Parse Setup Script Status

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/api/skills/examples.mdx

This snippet shows how to parse the status output of the setup script. It's useful for determining the state of dependencies and platform configuration.

```bash
--- STATUS ---
NODE_OK=true
DEPS_OK=true
NATIVE_OK=true
PLATFORM=macos
IS_WSL=false
--- END STATUS ---
```

--------------------------------

### Usage Examples for Image Vision

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/image-vision.mdx

Examples of prompts to ask the agent about an image sent as an attachment in WhatsApp.

```bash
@Andy what's in this image?
```

```bash
@Andy extract the text from this screenshot
```

```bash
@Andy describe this chart
```

--------------------------------

### Agent Create Draft Reply Example

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/gmail.mdx

Example of how to ask an agent to create a draft reply to an email.

```text
@Andy create a draft reply to the email from John about the meeting
```

--------------------------------

### Slack App Setup Reference

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/api/skills/examples.mdx

Reference for setting up a Slack app, including enabling Socket Mode, subscribing to bot events, and obtaining necessary OAuth scopes and tokens.

```markdown
### Create Slack App (if needed)

If the user doesn't have a Slack app, share [SLACK_SETUP.md](SLACK_SETUP.md) 
which has step-by-step instructions with screenshots guidance, troubleshooting, 
and a token reference table.

Quick summary of what's needed:
1. Create a Slack app at api.slack.com/apps
2. Enable Socket Mode and generate an App-Level Token
3. Subscribe to bot events: `message.channels`, `message.groups`, `message.im`
4. Add OAuth scopes: `chat:write`, `channels:history`, etc.
5. Install to workspace and copy the Bot Token
```

--------------------------------

### Install Docker on Linux

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/installation.mdx

Installs Docker Engine using the official convenience script and enables the Docker service. Users must log out and back in for group membership changes to take effect.

```bash
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
sudo systemctl enable --now docker
# Log out and back in for group membership to take effect
```

--------------------------------

### Resource Usage Query Prompt Example

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/agent-swarms.mdx

Example of a prompt to ask an agent about the number of sub-agents it utilized for a specific task.

```text
@Andy how many sub-agents did that task require?
```

--------------------------------

### User Skill Integration Example

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/advanced/contributing.mdx

This example contrasts two user scenarios: one integrating only WhatsApp using skills, and another integrating Telegram via a specific skill command. It highlights the clean codebase achieved with the skill-based approach.

```bash
# User A wants WhatsApp only
git clone nanoclaw
claude /setup
# Clean codebase, no Telegram code

# User B wants Telegram
git clone nanoclaw
claude /setup
claude /add-telegram
# Merges skill/telegram branch — clean code with Telegram support
```

--------------------------------

### Install Linux Build Tools

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/installation.mdx

Installs essential build tools and Python 3 on Debian-based Linux systems.

```bash
sudo apt-get update
sudo apt-get install -y build-essential python3
```

--------------------------------

### Start NanoClaw Service

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/advanced/troubleshooting.mdx

Start the NanoClaw service using `launchctl bootstrap`. This command is used to initiate the service, typically after it has been stopped or during system startup.

```bash
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.nanoclaw.plist
```

--------------------------------

### Install macOS Build Tools

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/installation.mdx

Installs the necessary build tools on macOS using Xcode Command Line Tools.

```bash
xcode-select --install
```

--------------------------------

### Install whisper.cpp Prerequisites

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/voice-transcription.mdx

Installs necessary packages for local whisper.cpp transcription using Homebrew on macOS. Includes whisper-cpp and ffmpeg.

```bash
brew install whisper-cpp ffmpeg
```

--------------------------------

### Traditional Feature Integration Example

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/advanced/contributing.mdx

This example illustrates the traditional approach to integrating features, where all features (e.g., WhatsApp, Telegram, Discord) are included in the main codebase by default, leading to potential bloat and configuration complexity.

```bash
# Everyone gets both
git clone nanoclaw
npm install
# Codebase includes WhatsApp, Telegram, Discord, Slack...
# Configuration sprawl to enable/disable features
# Unused dependencies and code
```

--------------------------------

### Install Emoji Reactions Skill

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/whatsapp.mdx

Installs the emoji reactions skill on a nanoclaw-whatsapp fork by fetching and merging the 'add-reactions' branch.

```bash
# Install on your nanoclaw-whatsapp fork
git fetch whatsapp skill/add-reactions
git merge whatsapp/skill/add-reactions
```

--------------------------------

### Install Parallel AI Skill Manually

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/parallel-ai.mdx

Manually install the Parallel AI skill by fetching and merging from the upstream repository.

```bash
git fetch upstream skill/add-parallel
git merge upstream/skill/add-parallel
```

--------------------------------

### Install Python for Linux/macOS

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/installation.mdx

Installs Python 3 on Linux/WSL or macOS if required for certain operations or error resolution.

```bash
sudo apt-get install python3
```

```bash
xcode-select --install
```

--------------------------------

### Rebuild and Restart Application

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/discord.mdx

Install dependencies, build the project, and restart the nanoclaw service. Platform-specific commands are provided for macOS and Linux.

```bash
npm install
npm run build
launchctl kickstart -k gui/$(id -u)/com.nanoclaw  # macOS
# or: systemctl --user restart nanoclaw (Linux)
```

--------------------------------

### Browser Automation Workflow: Step-by-Step

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/web-access.mdx

A step-by-step guide to automating browser tasks. This includes opening URLs, taking snapshots to identify elements, interacting with those elements, and waiting for specific conditions to be met.

```bash
agent-browser open https://example.com
```

```bash
agent-browser snapshot -i
```

```bash
agent-browser fill @e1 "user@example.com"
agent-browser fill @e2 "password123"
agent-browser click @e3
```

```bash
agent-browser wait --url "**/dashboard"
agent-browser snapshot -i  # Verify we're logged in
```

--------------------------------

### Install Voice Transcription Skill

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/voice-transcription.mdx

Installs the voice transcription skill onto your nanoclaw-whatsapp fork using git. Ensure you have fetched the correct branch first.

```bash
git fetch whatsapp skill/voice-transcription
git merge whatsapp/skill/voice-transcription
```

--------------------------------

### Install Image Vision Skill (Claude Code)

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/image-vision.mdx

Install the image vision skill using a Claude Code command.

```bash
/add-image-vision
```

--------------------------------

### Install Channels and Providers

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/customization.mdx

Add channels or AI providers as skills by using commands like `/add-telegram` for a channel or `/add-codex` for an alternate provider. To remove, use `git revert` on the skill's commit.

```bash
/add-telegram       # channel
/add-codex          # alternate provider (OpenAI)
/add-ollama-provider  # alternate provider (local models)
```

--------------------------------

### Scheduled Task Examples

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/quickstart.mdx

Set up recurring reminders and monitoring tasks using natural language commands.

```text
@Andy send me a daily standup reminder at 9am on weekdays
@Andy every Friday at 5pm, review this week's git commits and summarize changes
@Andy monitor Hacker News and message me when there's a trending AI article
```

--------------------------------

### Install Telegram Swarm Skill

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/telegram.mdx

Install the Telegram swarm skill by fetching and merging the branch on your Nanoclaw-Telegram fork.

```bash
git fetch telegram skill/telegram-swarm
git merge telegram/skill/telegram-swarm
```

--------------------------------

### Agent Search Emails Example

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/gmail.mdx

Example of how to ask an agent to search for emails using natural language.

```text
@Andy search my emails for "project alpha" from last week
```

--------------------------------

### Browser Automation Workflow

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/web-access.mdx

Step-by-step guide for common browser automation tasks.

```APIDOC
## Browser automation workflow

The typical workflow for browser tasks:

<Steps>
  <Step title="Navigate to page">
    ```bash
    agent-browser open https://example.com
    ```
  </Step>
  
  <Step title="Take snapshot">
    Get interactive elements with references:
    ```bash
    agent-browser snapshot -i
    ```
    
    Output:
    ```
    textbox "Email" [ref=e1]
    textbox "Password" [ref=e2]  
    button "Sign In" [ref=e3]
    ```
  </Step>
  
  <Step title="Interact with elements">
    Use the refs from the snapshot:
    ```bash
    agent-browser fill @e1 "user@example.com"
    agent-browser fill @e2 "password123"
    agent-browser click @e3
    ```
  </Step>
  
  <Step title="Wait and verify">
    ```bash
    agent-browser wait --url "**/dashboard"
    agent-browser snapshot -i  # Verify we're logged in
    ```
  </Step>
</Steps>
```

--------------------------------

### Explicit Delegation Prompt Example

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/agent-swarms.mdx

Example of a prompt instructing an agent to use multiple sub-agents for parallel research and synthesis.

```text
@Andy research X using multiple agents in parallel, then synthesize results
```

--------------------------------

### Install and Test Telegram Integration

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/api/skills/examples.mdx

After merging the Telegram skill branch, install dependencies, run tests to ensure the integration works correctly, and build the project.

```bash
npm install
npm test
npm run build
```

--------------------------------

### Admin Command Examples

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/quickstart.mdx

Manage scheduled tasks, channels, and user groups through administrative commands.

```text
@Andy list all scheduled tasks
@Andy pause the standup reminder
@Andy manage-channels
@Andy show me what groups I'm in
```

--------------------------------

### Install PDF Reader Skill (Claude Code)

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/pdf-reader.mdx

Alternatively, install the PDF reader skill using a Claude Code command.

```bash
/add-pdf-reader
```

--------------------------------

### Cron Expression Examples

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/concepts/tasks.mdx

Illustrates common cron expressions for scheduling tasks at specific times or intervals.

```text
0 9 * * *
```

```text
0 */2 * * *
```

```text
0 0 * * 1
```

--------------------------------

### MDX Frontmatter Example

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/CLAUDE.md

All .mdx files require frontmatter with a title and description for SEO and navigation.

```yaml
---
title: "Clear, descriptive title"
description: "Concise summary for SEO and navigation."
keywords: ["relevant", "search", "terms"]
---

```

--------------------------------

### Check Docker service status

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/advanced/troubleshooting.mdx

Ensure Docker is running. If not, start it using Docker Desktop (macOS) or `sudo systemctl start docker` (Linux).

```bash
docker info
```

--------------------------------

### Send First Message via Local CLI

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/quickstart.mdx

After installation, use this command to interact with your NanoClaw agent through the local command-line interface.

```bash
pnpm run chat hi
```

--------------------------------

### Scheduled Tasks Example

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/introduction.mdx

Demonstrates how to schedule recurring tasks for an agent. Scheduled tasks are treated as messages with a `process_after` timestamp.

```text
@Andy send an overview of the sales pipeline every weekday morning at 9am
@Andy review the git history for the past week each Friday and update the README if there's drift
@Andy every Monday at 8am, compile AI news from Hacker News and TechCrunch and message me a briefing
```

--------------------------------

### Configure PARALLEL_API_KEY in .env

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/api/skills/examples.mdx

Example of adding the PARALLEL_API_KEY to the .env file for environment variable resolution in MCP.

```bash
# .env
PARALLEL_API_KEY=your-api-key-here
```

--------------------------------

### Verify Ollama Installation

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/ollama.mdx

Checks if the Ollama service is running and accessible.

```bash
ollama list
```

--------------------------------

### Natural Language Task Creation Examples

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/scheduled-tasks.mdx

Create scheduled tasks by making natural language requests to the agent, specifying the desired action and schedule.

```text
@Andy send me a summary of my calendar every weekday at 9am
@Andy check for new GitHub issues every hour and notify me
@Andy remind me to review the budget tomorrow at 2pm
@Andy compile AI news from Hacker News every Monday at 8am
```

--------------------------------

### WSL Service Management without systemd

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/installation.mdx

Commands for starting, stopping, and viewing logs for NanoClaw on WSL environments that do not have systemd enabled. Also includes instructions to enable systemd.

```bash
bash start-nanoclaw.sh     # start
pkill -f "bun.*src/index.ts"     # stop
tail -f logs/nanoclaw.log        # logs
```

```bash
echo -e "[boot]\nsystemd=true" | sudo tee /etc/wsl.conf
# Restart WSL from PowerShell: wsl --shutdown
```

--------------------------------

### Add Slack Integration

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/slack.mdx

Initiates the Slack integration process by running the /add-slack skill. This command guides through deployment mode selection and applies necessary code changes.

```bash
claude
/add-slack
```

--------------------------------

### Basic Conversation Examples

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/quickstart.mdx

Interact with the AI assistant for general queries, code generation, and document summarization.

```text
@Andy what's the weather like today?
@Andy write a Python script to parse CSV files
@Andy summarize this document [attach file]
```

--------------------------------

### PDF Reader Usage Examples

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/pdf-reader.mdx

Interact with the PDF reader skill in a WhatsApp group by sending commands to summarize, ask questions about, or extract specific content from a PDF.

```bash
@Andy summarize this document
```

```bash
@Andy what are the key findings in this PDF?
```

```bash
@Andy extract the table from page 3
```

--------------------------------

### Perform Web Automation Tasks

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/web-access.mdx

Examples of common browser automation patterns including form submission, data extraction, monitoring, and screenshot capture.

```bash
agent-browser open https://example.com/contact
agent-browser fill @e1 "John Doe"
agent-browser fill @e2 "john@example.com"
agent-browser fill @e3 "Interested in a demo"
agent-browser click @e4
agent-browser wait --text "Thank you"
```

--------------------------------

### Telegram Bot Token Example

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/telegram.mdx

Example format of a Telegram bot token obtained from BotFather.

```text
123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
```

--------------------------------

### Building and Restarting Service on macOS

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/api/skills/creating-skills.mdx

Commands to build the project and restart the NanoClaw service on macOS using `launchctl`. Includes a commented-out alternative for Linux.

```bash
npm run build
launchctl kickstart -k gui/$(id -u)/com.nanoclaw  # macOS
# Linux: systemctl --user restart nanoclaw
```

--------------------------------

### Configure X API Credentials

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/x-twitter.mdx

Add your X API credentials to the .env file for authentication.

```bash
X_API_KEY=your-api-key
X_API_SECRET=your-api-secret
X_ACCESS_TOKEN=your-access-token
X_ACCESS_TOKEN_SECRET=your-access-token-secret
```

--------------------------------

### Configure Legacy Credential Proxy Environment Variables

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/customization.mdx

Opt-in .env configuration for the legacy credential proxy, including assistant name, number ownership, and Anthropic API key. This setup requires a specific skill to function.

```bash
# .env
ASSISTANT_NAME=Andy
ASSISTANT_HAS_OWN_NUMBER=false
ANTHROPIC_API_KEY=sk-ant-...
```

--------------------------------

### Sender ID Format Example

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/api/message-routing.mdx

Illustrates the expected format for user IDs, which are namespaced by channel type and handle. Examples include phone numbers and platform-specific IDs.

```typescript
// User ID format: channelType:handle
// Examples: phone:+15551234567, tg:123456, discord:789012
```

--------------------------------

### Migrate from v1 to v2

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/quickstart.mdx

Perform a clean-base replay of customizations for v2 migration or a selective cherry-pick update.

```bash
/migrate-nanoclaw
```

--------------------------------

### Build and Test Skill Integration

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/api/skills/skill-structure.mdx

After applying a skill and its tests, run the full test suite and build the project to ensure successful integration. All tests must pass before proceeding.

```bash
npm test
npm run build
```

--------------------------------

### Add Ollama Provider (Cloud)

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/overview.mdx

Use this skill to integrate with Ollama for running local open-weight models without cloud calls.

```bash
/add-ollama-provider
```

--------------------------------

### Add OpenCode Provider

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/overview.mdx

Use this skill to integrate with OpenCode, which supports multiple providers like OpenRouter, Google, and DeepSeek.

```bash
/add-opencode
```

--------------------------------

### Core Commands: Get Information

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/web-access.mdx

Commands to retrieve information from elements or the page.

```APIDOC
### Get information

```bash
agent-browser get text @e1        # Get element text
agent-browser get html @e1        # Get innerHTML
agent-browser get value @e1       # Get input value
agent-browser get attr @e1 href   # Get attribute
agent-browser get title           # Get page title
agent-browser get url             # Get current URL
agent-browser get count ".item"   # Count matching elements
```
```

--------------------------------

### Verify WhatsApp Auth Files

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/advanced/troubleshooting.mdx

Check if the necessary authentication files for WhatsApp exist in the store/auth/ directory. This command lists the files and their permissions.

```bash
ls -la store/auth/
```

--------------------------------

### Reset and Start Apple Container

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/installation.mdx

Stops, removes, and restarts the container environment on Apple systems.

```bash
container builder stop && container builder rm && container builder start
```

--------------------------------

### Clean Project Dependencies

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/installation.mdx

Removes node_modules and pnpm-lock.yaml to resolve dependency conflicts and forces a fresh installation.

```bash
rm -rf node_modules pnpm-lock.yaml && pnpm install
```

--------------------------------

### Restart Nanoclaw on Linux

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/snippets/restart-service.mdx

Builds the Nanoclaw project and restarts the user service using `systemctl`.

```bash
pnpm run build
systemctl --user list-units 'nanoclaw*'
systemctl --user restart <unit>
```

--------------------------------

### Add Telegram Channel

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/whatsapp.mdx

Execute this command to add the Telegram messaging channel to your NanoClaw installation, running it alongside WhatsApp.

```bash
/add-telegram  # Adds Telegram alongside WhatsApp
```

--------------------------------

### Quick Start: Natural Language Web Interaction

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/web-access.mdx

Initiate web-based tasks using natural language commands. The agent automatically utilizes the agent-browser tool for actions like searching, summarizing articles, and extracting data.

```natural language
@Andy what are the top stories on Hacker News today?
@Andy search for recent Claude API updates
@Andy read this article and summarize it: https://example.com/article
@Andy extract all product prices from https://store.example.com
```

--------------------------------

### Set Maximum Concurrent Containers

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/agent-swarms.mdx

Example of how to increase the global limit for concurrently running containers using an environment variable.

```bash
export MAX_CONCURRENT_CONTAINERS=10
```

--------------------------------

### Rebuild and Restart NanoClaw Service

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/advanced/troubleshooting.mdx

Rebuild the project using `npm run build` and then restart the NanoClaw service using `launchctl kickstart`. This is typically done after making code changes to ensure the latest version is running.

```bash
npm run build && launchctl kickstart -k gui/$(id -u)/com.nanoclaw
```

--------------------------------

### Revert Integration Commit

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/overview.mdx

To remove a channel integration, revert the specific Git commit that installed it. This command helps undo the integration.

```git
git revert <skill-commit-sha>
```

--------------------------------

### Install Parallel AI Skill

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/parallel-ai.mdx

Use this command to add the Parallel AI skill to your NanoClaw instance via Claude Code.

```bash
/add-parallel
```

--------------------------------

### Slack Channel JID Formats

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/slack.mdx

Examples of JID formats for different types of Slack channels: public, private, and direct messages.

```text
slack:C0123456789
slack:G0123456789
slack:D0123456789
```

--------------------------------

### Testing Skills on a Fresh Clone

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/advanced/contributing.mdx

This snippet details the process of testing a newly developed skill on a clean clone of the NanoClaw repository. It includes cloning, merging the skill branch, and running installation, testing, and build commands.

```bash
git clone https://github.com/qwibitai/NanoClaw.git test-nanoclaw
cd test-nanoclaw
git merge origin/skill/my-integration
npm install && npm test && npm run build
```

--------------------------------

### Check if agent image exists

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/concepts/containers.mdx

Confirm that the nanoclaw-agent Docker image is available locally. This is a prerequisite for starting containers based on this image.

```bash
docker images | grep nanoclaw-agent
```

--------------------------------

### Revert WhatsApp Skill

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/whatsapp.mdx

Use this git command to remove the WhatsApp skill from your installation. This reverts the changes introduced by the WhatsApp merge commit.

```bash
git revert -m 1 <whatsapp-merge-commit>
```

--------------------------------

### Restart Nanoclaw on macOS

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/snippets/restart-service.mdx

Builds the Nanoclaw project and restarts the service using `launchctl`.

```bash
pnpm run build
launchctl list | grep nanoclaw
launchctl kickstart -k gui/$(id -u)/<label>
```

--------------------------------

### Cron expression example

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/api/task-scheduling.mdx

Cron expressions define the recurrence pattern for tasks. The system uses the configured TIMEZONE environment variable for parsing.

```typescript
recurrence: '0 */6 * * *'  // Cron expression
```

--------------------------------

### Configure Slack Environment Variables

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/slack.mdx

Sets up the necessary environment variables for Slack integration, including the Bot User OAuth Token and App-Level Token. Optionally, SLACK_ONLY can be set to true if Slack should be the sole messaging channel.

```bash
SLACK_BOT_TOKEN=xoxb-your-bot-token-here
SLACK_APP_TOKEN=xapp-your-app-token-here
```

```bash
SLACK_ONLY=true
```

--------------------------------

### Query registered group triggers

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/advanced/troubleshooting.mdx

Verify the trigger word in your message matches the configured trigger. The trigger is case-insensitive and must appear at the start of the message.

```bash
sqlite3 store/messages.db "SELECT name, trigger_pattern FROM registered_groups;"
```

--------------------------------

### Configure Parallel AI API Key

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/integrations/parallel-ai.mdx

Set your Parallel AI API key in the .env file for authentication.

```bash
PARALLEL_API_KEY=your-api-key
```

--------------------------------

### Add Local Whisper Skill via Claude Code

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/voice-transcription.mdx

Adds the local whisper skill directly using the Claude Code command. This is a shortcut for installation.

```bash
/use-local-whisper
```

--------------------------------

### Troubleshooting Bot Not Responding

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/api/skills/creating-skills.mdx

Provides a checklist for diagnosing why the bot might not be responding. Ensure environment variables are set, the chat is registered, and the service is running.

```markdown
## Troubleshooting

### Bot not responding

Check:
1. `TELEGRAM_BOT_TOKEN` is set in `.env` AND synced to `data/env/env`
2. Chat is registered in SQLite
3. For non-main chats: message includes trigger pattern
4. Service is running: `launchctl list | grep nanoclaw`
```

--------------------------------

### Add Voice Transcription Skill via Claude Code

Source: https://github.com/glifocat/nanoclaw-docs/blob/main/features/voice-transcription.mdx

Adds the voice transcription skill directly using the Claude Code command. This is a shortcut for installation.

```bash
/add-voice-transcription
```