diff --git a/AGENTS.md b/AGENTS.md index db5d68eb55..aa3b84b1b1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -7,7 +7,7 @@ - Tests: colocated `*.test.ts`. - Docs: `docs/` (images, queue, Pi config). Built output lives in `dist/`. - Plugins/extensions: live under `extensions/*` (workspace packages). Keep plugin-only deps in the extension `package.json`; do not add them to the root `package.json` unless core uses them. -- Plugins: install runs `npm install --omit=dev` in plugin dir; runtime deps must live in `dependencies`. Avoid `workspace:*` in `dependencies` (npm install breaks); put `openclaw` in `devDependencies` or `peerDependencies` instead (runtime resolves `clawdbot/plugin-sdk` via jiti alias). +- Plugins: install runs `npm install --omit=dev` in plugin dir; runtime deps must live in `dependencies`. Avoid `workspace:*` in `dependencies` (npm install breaks); put `openclaw` in `devDependencies` or `peerDependencies` instead (runtime resolves `openclaw/plugin-sdk` via jiti alias). - Installers served from `https://openclaw.ai/*`: live in the sibling repo `../openclaw.ai` (`public/install.sh`, `public/install-cli.sh`, `public/install.ps1`). - Messaging channels: always consider **all** built-in + extension channels when refactoring shared logic (routing, allowlists, pairing, command gating, onboarding, docs). - Core channel docs: `docs/channels/` @@ -97,8 +97,8 @@ - **Landing mode:** create an integration branch from `main`, bring in PR commits (**prefer rebase** for linear history; **merge allowed** when complexity/conflicts make it safer), apply fixes, add changelog (+ thanks + PR #), run full gate **locally before committing** (`pnpm lint && pnpm build && pnpm test`), commit, merge back to `main`, then `git switch main` (never stay on a topic branch after landing). Important: contributor needs to be in git graph after this! ## Security & Configuration Tips -- Web provider stores creds at `~/.clawdbot/credentials/`; rerun `openclaw login` if logged out. -- Pi sessions live under `~/.clawdbot/sessions/` by default; the base directory is not configurable. +- Web provider stores creds at `~/.openclaw/credentials/`; rerun `openclaw login` if logged out. +- Pi sessions live under `~/.openclaw/sessions/` by default; the base directory is not configurable. - Environment variables: see `~/.profile`. - Never commit or publish real phone numbers, videos, or live configuration values. Use obviously fake placeholders in docs, tests, and examples. - Release flow: always read `docs/reference/RELEASING.md` and `docs/platforms/mac/release.md` before any release work; do not ask routine questions once those docs answer them. @@ -145,7 +145,7 @@ - Code style: add brief comments for tricky logic; keep files under ~500 LOC when feasible (split/refactor as needed). - Tool schema guardrails (google-antigravity): avoid `Type.Union` in tool input schemas; no `anyOf`/`oneOf`/`allOf`. Use `stringEnum`/`optionalStringEnum` (Type.Unsafe enum) for string lists, and `Type.Optional(...)` instead of `... | null`. Keep top-level tool schema as `type: "object"` with `properties`. - Tool schema guardrails: avoid raw `format` property names in tool schemas; some validators treat `format` as a reserved keyword and reject the schema. -- When asked to open a “session” file, open the Pi session logs under `~/.clawdbot/agents//sessions/*.jsonl` (use the `agent=` value in the Runtime line of the system prompt; newest unless a specific ID is given), not the default `sessions.json`. If logs are needed from another machine, SSH via Tailscale and read the same path there. +- When asked to open a “session” file, open the Pi session logs under `~/.openclaw/agents//sessions/*.jsonl` (use the `agent=` value in the Runtime line of the system prompt; newest unless a specific ID is given), not the default `sessions.json`. If logs are needed from another machine, SSH via Tailscale and read the same path there. - Do not rebuild the macOS app over SSH; rebuilds must be run directly on the Mac. - Never send streaming/partial replies to external messaging surfaces (WhatsApp, Telegram); only final replies should be delivered there. Streaming/tool events may still go to internal UIs/control channel. - Voice wake forwarding tips: diff --git a/CHANGELOG.md b/CHANGELOG.md index 191c2172d1..2f41ca6d41 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -45,7 +45,7 @@ Status: stable. - Agents: add Kimi K2.5 to the synthetic model catalog. (#4407) Thanks @manikv12. - TUI: avoid width overflow when rendering selection lists. (#1686) Thanks @mossein. - macOS: finish OpenClaw app rename for macOS sources, bundle identifiers, and shared kit paths. (#2844) Thanks @fal3. -- Branding: update launchd labels, mobile bundle IDs, and logging subsystems to bot.molt (legacy com.clawdbot migrations). Thanks @thewilloftheshadow. +- Branding: update launchd labels, mobile bundle IDs, and logging subsystems to bot.molt (legacy bundle ID migrations). Thanks @thewilloftheshadow. - macOS: limit project-local `node_modules/.bin` PATH preference to debug builds (reduce PATH hijacking risk). - macOS: keep custom SSH usernames in remote target. (#2046) Thanks @algal. - macOS: avoid crash when rendering code blocks by bumping Textual to 0.3.1. (#2033) Thanks @garricn. @@ -417,7 +417,7 @@ Status: stable. - Security: warn when <=300B models run without sandboxing while web tools are enabled. https://docs.openclaw.ai/cli/security - Exec: add host/security/ask routing for gateway + node exec. https://docs.openclaw.ai/tools/exec - Exec: add `/exec` directive for per-session exec defaults (host/security/ask/node). https://docs.openclaw.ai/tools/exec -- Exec approvals: migrate approvals to `~/.clawdbot/exec-approvals.json` with per-agent allowlists + skill auto-allow toggle, and add approvals UI + node exec lifecycle events. https://docs.openclaw.ai/tools/exec-approvals +- Exec approvals: migrate approvals to `~/.openclaw/exec-approvals.json` with per-agent allowlists + skill auto-allow toggle, and add approvals UI + node exec lifecycle events. https://docs.openclaw.ai/tools/exec-approvals - Nodes: add headless node host (`openclaw node start`) for `system.run`/`system.which`. https://docs.openclaw.ai/cli/node - Nodes: add node daemon service install/status/start/stop/restart. https://docs.openclaw.ai/cli/node - Bridge: add `skills.bins` RPC to support node host auto-allow skill bins. @@ -441,7 +441,7 @@ Status: stable. - Android: remove legacy bridge transport code now that nodes use the gateway protocol. - Android: bump okhttp + dnsjava to satisfy lint dependency checks. - Build: update workspace + core/plugin deps. -- Build: use tsgo for dev/watch builds by default (opt out with `CLAWDBOT_TS_COMPILER=tsc`). +- Build: use tsgo for dev/watch builds by default (opt out with `OPENCLAW_TS_COMPILER=tsc`). - Repo: remove the Peekaboo git submodule now that the SPM release is used. - macOS: switch PeekabooBridge integration to the tagged Swift Package Manager release. - macOS: stop syncing Peekaboo in postinstall. @@ -569,7 +569,7 @@ Thanks @AlexMikhalev, @CoreyH, @John-Rood, @KrauseFx, @MaudeBot, @Nachx639, @Nic - **BREAKING:** Drop legacy `chatType: "room"` support; use `chatType: "channel"`. - **BREAKING:** remove legacy provider-specific target resolution fallbacks; target resolution is centralized with plugin hints + directory lookups. - **BREAKING:** `openclaw hooks` is now `openclaw webhooks`; hooks live under `openclaw hooks`. https://docs.openclaw.ai/cli/webhooks -- **BREAKING:** `openclaw plugins install ` now copies into `~/.clawdbot/extensions` (use `--link` to keep path-based loading). +- **BREAKING:** `openclaw plugins install ` now copies into `~/.openclaw/extensions` (use `--link` to keep path-based loading). ### Changes - Plugins: ship bundled plugins disabled by default and allow overrides by installed versions. (#1066) — thanks @ItzR3NO. @@ -804,7 +804,7 @@ Thanks @AlexMikhalev, @CoreyH, @John-Rood, @KrauseFx, @MaudeBot, @Nachx639, @Nic - TUI: render picker overlays via the overlay stack so /models and /settings display. (#921) — thanks @grizzdank. - TUI: add a bright spinner + elapsed time in the status line for send/stream/run states. - TUI: show LLM error messages (rate limits, auth, etc.) instead of `(no output)`. -- Gateway/Dev: ensure `pnpm gateway:dev` always uses the dev profile config + state (`~/.clawdbot-dev`). +- Gateway/Dev: ensure `pnpm gateway:dev` always uses the dev profile config + state (`~/.openclaw-dev`). #### Agents / Auth / Tools / Sandbox - Agents: make user time zone and 24-hour time explicit in the system prompt. (#859) — thanks @CashWilliams. @@ -865,7 +865,7 @@ Thanks @AlexMikhalev, @CoreyH, @John-Rood, @KrauseFx, @MaudeBot, @Nachx639, @Nic ### New & Improved - Memory: add custom OpenAI-compatible embedding endpoints; support OpenAI/local `node-llama-cpp` embeddings with per-agent overrides and provider metadata in tools/CLI. (#819) — thanks @mukhtharcm. -- Memory: new `openclaw memory` CLI plus `memory_search`/`memory_get` tools with snippets + line ranges; index stored under `~/.clawdbot/memory/{agentId}.sqlite` with watch-on-by-default. +- Memory: new `openclaw memory` CLI plus `memory_search`/`memory_get` tools with snippets + line ranges; index stored under `~/.openclaw/memory/{agentId}.sqlite` with watch-on-by-default. - Agents: strengthen memory recall guidance; make workspace bootstrap truncation configurable (default 20k) with warnings; add default sub-agent model config. - Tools/Sandbox: add tool profiles + group shorthands; support tool-policy groups in `tools.sandbox.tools`; drop legacy `memory` shorthand; allow Docker bind mounts via `docker.binds`. (#790) — thanks @akonyer. - Tools: add provider/model-specific tool policy overrides (`tools.byProvider`) to trim tool exposure per provider. @@ -1113,7 +1113,7 @@ Thanks @AlexMikhalev, @CoreyH, @John-Rood, @KrauseFx, @MaudeBot, @Nachx639, @Nic - CLI UX: logs output modes (pretty/plain/JSONL) + colorized health/daemon output; global `--no-color`; lobster palette in onboarding/config. - Dev ergonomics: gateway `--dev/--reset` + dev profile auto-config; C-3PO dev templates; dev gateway/TUI helper scripts. - Sandbox/Workspace: sandbox list/recreate commands; sync skills into sandbox workspace; sandbox browser auto-start. -- Config/Onboarding: inline env vars; OpenAI API key flow to shared `~/.clawdbot/.env`; Opus 4.5 default prompt for Anthropic auth; QuickStart auto-install gateway (Node-only) + provider picker tweaks + skip-systemd flags; TUI bootstrap prompt (`tui --message`); remove Bun runtime choice. +- Config/Onboarding: inline env vars; OpenAI API key flow to shared `~/.openclaw/.env`; Opus 4.5 default prompt for Anthropic auth; QuickStart auto-install gateway (Node-only) + provider picker tweaks + skip-systemd flags; TUI bootstrap prompt (`tui --message`); remove Bun runtime choice. - Providers: Microsoft Teams provider (polling, attachments, outbound sends, requireMention, config reload/DM policy). (#404) — thanks @onutc - Providers: WhatsApp broadcast groups for multi-agent replies (#547) — thanks @pasogott; inbound media size cap configurable (#505) — thanks @koala73; identity-based message prefixes (#578) — thanks @p6l-richard. - Providers: Telegram inline keyboard buttons + callback payload routing (#491) — thanks @azade-c; cron topic delivery targets (#474/#478) — thanks @mitschabaude-bot, @nachoiacovino; `[[audio_as_voice]]` tag support (#490) — thanks @jarvis-medmatic. @@ -1182,7 +1182,7 @@ Thanks @AlexMikhalev, @CoreyH, @John-Rood, @KrauseFx, @MaudeBot, @Nachx639, @Nic - **Control UI/Web:** logs tab, focus mode polish, config form resilience, streaming stability, tool output caps, windowed chat history, and reconnect/password URL auth. - **macOS/Android/TUI/Build:** macOS gateway races, QR bundling, JSON5 config safety, Voice Wake hardening; Android EXIF rotation + APK naming/versioning; TUI key handling; tooling/bundling fixes. - **Packaging/compat:** npm dist folder coverage, Node 25 qrcode-terminal import fixes, Bun/Playwright/WebSocket patches, and Docker Bun install. -- **Docs:** new FAQ/ClawdHub/config examples/showcase entries and clarified auth, sandbox, and systemd docs. +- **Docs:** new FAQ/ClawHub/config examples/showcase entries and clarified auth, sandbox, and systemd docs. ### Maintenance - Skills additions (Himalaya email, CodexBar, 1Password). @@ -1212,7 +1212,7 @@ Thanks @AlexMikhalev, @CoreyH, @John-Rood, @KrauseFx, @MaudeBot, @Nachx639, @Nic - WhatsApp: mark offline history sync messages as read without auto-reply. (#193) — thanks @mcinteerj - Discord: avoid duplicate replies when a provider emits late streaming `text_end` events (OpenAI/GPT). - CLI: use tailnet IP for local gateway calls when bind is tailnet/auto (fixes #176). -- Env: load global `$CLAWDBOT_STATE_DIR/.env` (`~/.clawdbot/.env`) as a fallback after CWD `.env`. +- Env: load global `$OPENCLAW_STATE_DIR/.env` (`~/.openclaw/.env`) as a fallback after CWD `.env`. - Env: optional login-shell env fallback (opt-in; imports expected keys without overriding existing env). - Agent tools: OpenAI-compatible tool JSON Schemas (fix `browser`, normalize union schemas). - Onboarding: when running from source, auto-build missing Control UI assets (`bun run ui:build`). diff --git a/README.md b/README.md index 49085c76f0..87125ebda8 100644 --- a/README.md +++ b/README.md @@ -246,11 +246,11 @@ Details: [Nodes](https://docs.openclaw.ai/nodes) · [macOS app](https://docs.ope Details: [Session tools](https://docs.openclaw.ai/concepts/session-tool) -## Skills registry (ClawdHub) +## Skills registry (ClawHub) -ClawdHub is a minimal skill registry. With ClawdHub enabled, the agent can search for skills automatically and pull in new ones as needed. +ClawHub is a minimal skill registry. With ClawHub enabled, the agent can search for skills automatically and pull in new ones as needed. -[ClawdHub](https://ClawdHub.com) +[ClawHub](https://clawhub.com) ## Chat commands diff --git a/appcast.xml b/appcast.xml index 67fa523773..6a302e5b04 100644 --- a/appcast.xml +++ b/appcast.xml @@ -51,7 +51,7 @@ Status: stable.
  • Auth: show copyable Google auth URL after ASCII prompt. (#1787) Thanks @robbyczgw-cla.
  • TUI: avoid width overflow when rendering selection lists. (#1686) Thanks @mossein.
  • macOS: finish OpenClaw app rename for macOS sources, bundle identifiers, and shared kit paths. (#2844) Thanks @fal3.
    • -
  • Branding: update launchd labels, mobile bundle IDs, and logging subsystems to bot.molt (legacy com.clawdbot migrations). Thanks @thewilloftheshadow.
    • +
  • Branding: update launchd labels, mobile bundle IDs, and logging subsystems to bot.molt (legacy bundle ID migrations). Thanks @thewilloftheshadow.
  • macOS: limit project-local node_modules/.bin PATH preference to debug builds (reduce PATH hijacking risk).
  • macOS: keep custom SSH usernames in remote target. (#2046) Thanks @algal.
  • macOS: avoid crash when rendering code blocks by bumping Textual to 0.3.1. (#2033) Thanks @garricn.
    • @@ -230,4 +230,4 @@ Status: stable. - \ No newline at end of file + diff --git a/docs/cli/index.md b/docs/cli/index.md index 7bc7b559d6..03770965f7 100644 --- a/docs/cli/index.md +++ b/docs/cli/index.md @@ -414,7 +414,7 @@ Options: - `--json`: output JSON (no styling). - `-v`, `--verbose`: include missing requirements detail. -Tip: use `npx clawdhub` to search, install, and sync skills. +Tip: use `npx clawhub` to search, install, and sync skills. ### `pairing` Approve DM pairing requests across channels. diff --git a/docs/cli/skills.md b/docs/cli/skills.md index b47cc37516..a387094554 100644 --- a/docs/cli/skills.md +++ b/docs/cli/skills.md @@ -12,7 +12,7 @@ Inspect skills (bundled + workspace + managed overrides) and see what’s eligib Related: - Skills system: [Skills](/tools/skills) - Skills config: [Skills config](/tools/skills-config) -- ClawdHub installs: [ClawdHub](/tools/clawdhub) +- ClawHub installs: [ClawHub](/tools/clawhub) ## Commands @@ -22,4 +22,3 @@ openclaw skills list --eligible openclaw skills info openclaw skills check ``` - diff --git a/docs/concepts/system-prompt.md b/docs/concepts/system-prompt.md index bf010b83c6..ce9fbc5a24 100644 --- a/docs/concepts/system-prompt.md +++ b/docs/concepts/system-prompt.md @@ -105,6 +105,6 @@ This keeps the base prompt small while still enabling targeted skill usage. When available, the system prompt includes a **Documentation** section that points to the local OpenClaw docs directory (either `docs/` in the repo workspace or the bundled npm package docs) and also notes the public mirror, source repo, community Discord, and -ClawdHub (https://clawdhub.com) for skills discovery. The prompt instructs the model to consult local docs first +ClawHub (https://clawhub.com) for skills discovery. The prompt instructs the model to consult local docs first for OpenClaw behavior, commands, configuration, or architecture, and to run `openclaw status` itself when possible (asking the user only when it lacks access). diff --git a/docs/docs.json b/docs/docs.json index a676004f68..1cd229734f 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -369,9 +369,17 @@ "source": "/start/clawd/", "destination": "/start/openclaw" }, + { + "source": "/clawhub", + "destination": "/tools/clawhub" + }, { "source": "/clawdhub", - "destination": "/tools/clawdhub" + "destination": "/tools/clawhub" + }, + { + "source": "/tools/clawdhub", + "destination": "/tools/clawhub" }, { "source": "/configuration", @@ -1073,7 +1081,7 @@ "tools/reactions", "tools/skills", "tools/skills-config", - "tools/clawdhub" + "tools/clawhub" ] }, { diff --git a/docs/help/faq.md b/docs/help/faq.md index e960d6a196..9348003a37 100644 --- a/docs/help/faq.md +++ b/docs/help/faq.md @@ -956,7 +956,7 @@ Use managed overrides instead of editing the repo copy. Put your changes in `~/. ### Can I load skills from a custom folder -Yes. Add extra directories via `skills.load.extraDirs` in `~/.openclaw/openclaw.json` (lowest precedence). Default precedence remains: `/skills` → `~/.openclaw/skills` → bundled → `skills.load.extraDirs`. `clawdhub` installs into `./skills` by default, which OpenClaw treats as `/skills`. +Yes. Add extra directories via `skills.load.extraDirs` in `~/.openclaw/openclaw.json` (lowest precedence). Default precedence remains: `/skills` → `~/.openclaw/skills` → bundled → `skills.load.extraDirs`. `clawhub` installs into `./skills` by default, which OpenClaw treats as `/skills`. ### How can I use different models for different tasks @@ -1000,17 +1000,17 @@ Docs: [Cron jobs](/automation/cron-jobs), [Cron vs Heartbeat](/automation/cron-v ### How do I install skills on Linux -Use **ClawdHub** (CLI) or drop skills into your workspace. The macOS Skills UI isn’t available on Linux. -Browse skills at https://clawdhub.com. +Use **ClawHub** (CLI) or drop skills into your workspace. The macOS Skills UI isn’t available on Linux. +Browse skills at https://clawhub.com. -Install the ClawdHub CLI (pick one package manager): +Install the ClawHub CLI (pick one package manager): ```bash -npm i -g clawdhub +npm i -g clawhub ``` ```bash -pnpm add -g clawdhub +pnpm add -g clawhub ``` ### Can OpenClaw run tasks on a schedule or continuously in the background @@ -1076,11 +1076,11 @@ targeting those APIs. Install skills: ```bash -clawdhub install -clawdhub update --all +clawhub install +clawhub update --all ``` -ClawdHub installs into `./skills` under your current directory (or falls back to your configured OpenClaw workspace); OpenClaw treats that as `/skills` on the next session. For shared skills across agents, place them in `~/.openclaw/skills//SKILL.md`. Some skills expect binaries installed via Homebrew; on Linux that means Linuxbrew (see the Homebrew Linux FAQ entry above). See [Skills](/tools/skills) and [ClawdHub](/tools/clawdhub). +ClawHub installs into `./skills` under your current directory (or falls back to your configured OpenClaw workspace); OpenClaw treats that as `/skills` on the next session. For shared skills across agents, place them in `~/.openclaw/skills//SKILL.md`. Some skills expect binaries installed via Homebrew; on Linux that means Linuxbrew (see the Homebrew Linux FAQ entry above). See [Skills](/tools/skills) and [ClawHub](/tools/clawhub). ### How do I install the Chrome extension for browser takeover diff --git a/docs/start/hubs.md b/docs/start/hubs.md index 69274af85d..8c042ad290 100644 --- a/docs/start/hubs.md +++ b/docs/start/hubs.md @@ -156,7 +156,7 @@ Use these hubs to discover every page, including deep dives and reference docs t ## Workspace + templates - [Skills](/tools/skills) -- [ClawdHub](/tools/clawdhub) +- [ClawHub](/tools/clawhub) - [Skills config](/tools/skills-config) - [Default AGENTS](/reference/AGENTS.default) - [Templates: AGENTS](/reference/templates/AGENTS) diff --git a/docs/start/lore.md b/docs/start/lore.md index 4b1e812081..d222a3e590 100644 --- a/docs/start/lore.md +++ b/docs/start/lore.md @@ -13,7 +13,7 @@ In the beginning, there was **Warelay** — a sensible name for a WhatsApp gatew But then came a space lobster. -For a while, the lobster was called **Clawd**, living in a **Clawdbot**. But in January 2026, Anthropic sent a polite email asking for a name change (trademark stuff). And so the lobster did what lobsters do best: +For a while, the lobster was called **Clawd**, living in an **OpenClaw**. But in January 2026, Anthropic sent a polite email asking for a name change (trademark stuff). And so the lobster did what lobsters do best: **It molted.** diff --git a/docs/start/showcase.md b/docs/start/showcase.md index bb5670a5f0..25c4648978 100644 --- a/docs/start/showcase.md +++ b/docs/start/showcase.md @@ -134,28 +134,28 @@ Full setup walkthrough (28m) by VelvetShark. Telegram voice note output from TTS - + **@odrobnik** • `devtools` `codex` `brew` Homebrew-installed helper to list/inspect/watch local OpenAI Codex sessions (CLI + VS Code). - CodexMonitor on ClawdHub + CodexMonitor on ClawHub - + **@tobiasbischoff** • `hardware` `3d-printing` `skill` Control and troubleshoot BambuLab printers: status, jobs, camera, AMS, calibration, and more. - Bambu CLI skill on ClawdHub + Bambu CLI skill on ClawHub - + **@hjanuschka** • `travel` `transport` `skill` Real-time departures, disruptions, elevator status, and routing for Vienna's public transport. - Wiener Linien skill on ClawdHub + Wiener Linien skill on ClawHub @@ -164,7 +164,7 @@ Full setup walkthrough (28m) by VelvetShark. Automated UK school meal booking via ParentPay. Uses mouse coordinates for reliable table cell clicking. - + **@julianengel** • `files` `r2` `presigned-urls` Upload to Cloudflare R2/S3 and generate secure presigned download links. Perfect for remote OpenClaw instances. @@ -260,7 +260,7 @@ Full setup walkthrough (28m) by VelvetShark. **@jdrhyne** • `automation` `jira` `skill` `devtools` - OpenClaw connected to Jira, then generated a new skill on the fly (before it existed on ClawdHub). + OpenClaw connected to Jira, then generated a new skill on the fly (before it existed on ClawHub). @@ -325,10 +325,10 @@ Full setup walkthrough (28m) by VelvetShark. Vapi voice assistant ↔ OpenClaw HTTP bridge. Near real-time phone calls with your agent. - + **@obviyus** • `transcription` `multilingual` `skill` - Multi-lingual audio transcription via OpenRouter (Gemini, etc). Available on ClawdHub. + Multi-lingual audio transcription via OpenRouter (Gemini, etc). Available on ClawHub. @@ -343,8 +343,8 @@ Full setup walkthrough (28m) by VelvetShark. OpenClaw gateway running on Home Assistant OS with SSH tunnel support and persistent state. - - **ClawdHub** • `homeassistant` `skill` `automation` + + **ClawHub** • `homeassistant` `skill` `automation` Control and automate Home Assistant devices via natural language. @@ -355,8 +355,8 @@ Full setup walkthrough (28m) by VelvetShark. Batteries-included nixified OpenClaw configuration for reproducible deployments. - - **ClawdHub** • `calendar` `caldav` `skill` + + **ClawHub** • `calendar` `caldav` `skill` Calendar skill using khal/vdirsyncer. Self-hosted calendar integration. diff --git a/docs/tools/clawhub.md b/docs/tools/clawhub.md new file mode 100644 index 0000000000..c7b1692fd9 --- /dev/null +++ b/docs/tools/clawhub.md @@ -0,0 +1,201 @@ +--- +summary: "ClawHub guide: public skills registry + CLI workflows" +read_when: + - Introducing ClawHub to new users + - Installing, searching, or publishing skills + - Explaining ClawHub CLI flags and sync behavior +--- + +# ClawHub + +ClawHub is the **public skill registry for OpenClaw**. It is a free service: all skills are public, open, and visible to everyone for sharing and reuse. A skill is just a folder with a `SKILL.md` file (plus supporting text files). You can browse skills in the web app or use the CLI to search, install, update, and publish skills. + +Site: [clawhub.com](https://clawhub.com) + +## Who this is for (beginner-friendly) + +If you want to add new capabilities to your OpenClaw agent, ClawHub is the easiest way to find and install skills. You do not need to know how the backend works. You can: + +- Search for skills by plain language. +- Install a skill into your workspace. +- Update skills later with one command. +- Back up your own skills by publishing them. + +## Quick start (non-technical) + +1) Install the CLI (see next section). +2) Search for something you need: + - `clawhub search "calendar"` +3) Install a skill: + - `clawhub install ` +4) Start a new OpenClaw session so it picks up the new skill. + +## Install the CLI + +Pick one: + +```bash +npm i -g clawhub +``` + +```bash +pnpm add -g clawhub +``` + +## How it fits into OpenClaw + +By default, the CLI installs skills into `./skills` under your current working directory. If a OpenClaw workspace is configured, `clawhub` falls back to that workspace unless you override `--workdir` (or `CLAWHUB_WORKDIR`). OpenClaw loads workspace skills from `/skills` and will pick them up in the **next** session. If you already use `~/.openclaw/skills` or bundled skills, workspace skills take precedence. + +For more detail on how skills are loaded, shared, and gated, see +[Skills](/tools/skills). + +## What the service provides (features) + +- **Public browsing** of skills and their `SKILL.md` content. +- **Search** powered by embeddings (vector search), not just keywords. +- **Versioning** with semver, changelogs, and tags (including `latest`). +- **Downloads** as a zip per version. +- **Stars and comments** for community feedback. +- **Moderation** hooks for approvals and audits. +- **CLI-friendly API** for automation and scripting. + +## CLI commands and parameters + +Global options (apply to all commands): + +- `--workdir `: Working directory (default: current dir; falls back to OpenClaw workspace). +- `--dir `: Skills directory, relative to workdir (default: `skills`). +- `--site `: Site base URL (browser login). +- `--registry `: Registry API base URL. +- `--no-input`: Disable prompts (non-interactive). +- `-V, --cli-version`: Print CLI version. + +Auth: + +- `clawhub login` (browser flow) or `clawhub login --token ` +- `clawhub logout` +- `clawhub whoami` + +Options: + +- `--token `: Paste an API token. +- `--label