---
name: clawhub-nextclaw
description: Use when the user wants to search external ClawHub skills or install a ClawHub skill into a NextClaw workspace's skills directory without treating ClawHub as the NextClaw marketplace.
---

# ClawHub For NextClaw

## Overview

Use this skill when the user wants to use ClawHub as an external skill source for NextClaw.

This skill has one job:

- search ClawHub skills when needed,
- install a selected ClawHub skill into the intended NextClaw workspace's `skills/` directory,
- and keep the boundary explicit.

Do not blur the ecosystems:

- NextClaw marketplace is our own marketplace.
- ClawHub is an external upstream skill registry.
- This skill is only an external importer for NextClaw users.

Do not describe a ClawHub skill as a NextClaw marketplace skill unless it has separately been published to the NextClaw marketplace.

## Default Boundary

Default to the current NextClaw workspace as the install target.

If the workspace is ambiguous, clarify it before installing.
Do not silently install into a random repo or into OpenClaw's default `~/.openclaw/workspace`.

The safe path in this skill is to always drive ClawHub with an explicit NextClaw workspace:

```bash
clawhub --workdir <nextclaw-workspace> --dir skills install <skill-slug>
```

That pins ClawHub to `<workspace>/skills/<slug>`.

## Backend Choice

Prefer this order:

1. local `clawhub` command if already installed
2. `npm exec --yes clawhub -- ...`

Do not rely on raw `clawhub install <slug>` without an explicit workspace.

Why:

- ClawHub otherwise may fall back to an OpenClaw workspace such as `~/.openclaw/workspace`
- the user explicitly wants the skill installed into NextClaw's own `skills/` directory

## Workflow

### 1. Decide the goal

Classify the request into one of these:

- readiness check,
- search for possible skills,
- install a known skill,
- troubleshoot an existing imported ClawHub skill.

If the user does not know the exact slug, search first.

### 2. Confirm the target workspace

Default to the active NextClaw workspace.

Typical target:

- `<workspace>/skills/`

Use `--workdir <workspace> --dir skills` so the target is explicit.

### 3. Run readiness check

Use:

```bash
clawhub --workdir <nextclaw-workspace> --dir skills search "code review" --limit 1
```

Success means:

- the target workspace is clear,
- and a small real `search` request succeeds.

### 4. Search ClawHub

Use:

```bash
clawhub --workdir <nextclaw-workspace> --dir skills search "<keywords>"
```

Optional limit:

```bash
clawhub --workdir <nextclaw-workspace> --dir skills search "<keywords>" --limit 5
```

If the user is unsure, present the likely matches before installing.

### 5. Install into NextClaw

Use:

```bash
clawhub --workdir <nextclaw-workspace> --dir skills install <skill-slug>
```

If the upstream skill is flagged as suspicious and the user explicitly wants to proceed, rerun with:

```bash
clawhub --workdir <nextclaw-workspace> --dir skills install <skill-slug> --force
```

Do not add `--force` by default.

If `clawhub` is not installed, use the same command shape through npm:

```bash
npm exec --yes clawhub -- --workdir <nextclaw-workspace> --dir skills install <skill-slug>
```

### 6. Verify post-install result

After install, verify:

- `<workspace>/skills/<slug>/SKILL.md` exists
- ClawHub created `<workspace>/.clawhub/lock.json`
- the installed skill is now visible to NextClaw as a workspace skill

For local verification you can also use:

```bash
nextclaw skills installed --workdir <nextclaw-workspace>
nextclaw skills info <skill-slug> --workdir <nextclaw-workspace>
```

## Safe Execution Rules

- Keep calling ClawHub an external source, not our official marketplace.
- Search before install when the exact slug is uncertain.
- Always pin `--workdir <workspace> --dir skills`.
- Never silently install into the repo root unless the repo root is the intended NextClaw workspace.
- Do not use `--force` unless the user explicitly accepts the risk or the task is a deterministic overwrite request.
- If ClawHub backend resolution fails, stop and report the missing runtime instead of pretending the install succeeded.

## Troubleshooting

### ClawHub is not installed

Use:

```bash
npm exec --yes clawhub -- ...
```

If that also fails, report that Node/npm access is missing or blocked.

### Install went into `~/.openclaw/workspace`

That means ClawHub was run without an explicit NextClaw workspace.

Fix by rerunning with:

```bash
--workdir <nextclaw-workspace> --dir skills
```

### Skill is flagged as suspicious

ClawHub may block non-interactive install unless `--force` is provided.

Keep the warning visible.
Only continue with `--force` when the user explicitly wants that risk.

### Search or install fails

Check:

- network access,
- npm registry reachability if using `npm exec`,
- ClawHub registry reachability,
- and whether the slug really exists.

## Success Criteria

This skill is working correctly when:

- the user can search ClawHub from inside a NextClaw workflow,
- installation lands in the intended NextClaw workspace's `skills/` directory,
- the boundary between external ClawHub and NextClaw marketplace stays explicit,
- and install success is verified by real filesystem results instead of assumption.

## Resources

- ClawHub npm package:
  https://www.npmjs.com/package/clawhub
- ClawHub docs:
  https://docs.openclaw.ai/zh-CN/tools/clawhub