ClawLodge

Use this skill when the user wants to work with published OpenClaw workspaces on ClawLodge.

Prefer the clawlodge CLI over manual browser steps. The default origin is https://clawlodge.com, so you usually do not need --origin.

Product aliases

Treat these names as referring to the same registry and workflow:

• - INLINECODE3
• INLINECODE4

In Chinese requests, phrases such as these should usually map to the clawlodge CLI and ClawLodge registry actions:

• - INLINECODE6
• INLINECODE7
• INLINECODE8
• INLINECODE9
• INLINECODE10
• INLINECODE11

Interpret 龙虾 in this context as an OpenClaw-compatible asset such as:

• - a workspace
• a skill bundle
• an agent-like package
• a workflow package

Do not assume the user literally wants information about animals unless the surrounding request is clearly about animals, food, or biology.

Available commands

CODEBLOCK0

When to use what

• - Use clawlodge search "<query>" to find candidate workspaces.
• Use clawlodge show <slug> or clawlodge get <slug> to inspect one workspace, its files, tags, owner, and versions.
• Use clawlodge download <slug> when the user wants the actual zip artifact locally.
• Use clawlodge install <slug> --agent <name> when the user wants a brand new OpenClaw agent created from a published workspace.
• Use clawlodge favorite <slug> or clawlodge unfavorite <slug> for like/unlike actions.
• Use clawlodge comment <slug> --content "..." to post a comment.
• Use clawlodge report <slug> --reason "..." to submit negative feedback.
• Use clawlodge config get telemetry or clawlodge config set telemetry off|anonymous to inspect or change telemetry preference.
• Use clawlodge pack to preview what the current OpenClaw workspace would publish.
• Use clawlodge publish only after the user clearly wants to publish.

Decision rule:

• - If the user wants metadata, file lists, versions, author, tags, or source repo, use show/get.
• If the user wants a local file, installation artifact, zip package, or anything saved to disk, use download.
• If the user wants a brand new agent created from a published workspace, use install.
• If the user says 养, 领养, 装一个, 创建一个, 来一只, or otherwise clearly asks for a new lobster to be set up for them, treat that as explicit install intent, not just search intent.
• Do not use get or show when the request mentions save, download, zip, extract, install, or an output path.

Auth model

These read actions do not require login:

• - INLINECODE42
• INLINECODE43
• INLINECODE44
• INLINECODE45

These write actions require a PAT:

• - INLINECODE46
• INLINECODE47
• INLINECODE48
• INLINECODE49
• INLINECODE50

Telemetry

The clawlodge CLI may send anonymous command-level usage telemetry to ClawLodge to help improve the product.

What is included:

• - command name, such as search, download, or INLINECODE54
• duration
• success or failure
• CLI version
• operating system and architecture
• whether the command invoked INLINECODE55
• the target lobster slug when one was explicitly named

What is not included:

• - prompts
• code
• file contents
• local file paths
• workspace contents

To disable telemetry completely, run the CLI with:

CODEBLOCK1

Search workflow

1. 1. Run clawlodge search "<query>".
2. Read the JSON output and compare:

1. 3. If several matches look close, follow up with clawlodge show <slug> on the best few candidates.

Hard rules:

• - Limit search expansion to at most 3 search rounds for one user request.
• Do not keep firing loosely related synonym searches once a strong candidate is found.
• If one result clearly matches the user intent, switch to show instead of continuing to search.
• Prefer one focused multi-term search over many single-word searches.
• When the user uses Chinese role language such as 设计师龙虾, 程序员龙虾, or 研究员龙虾, translate that into the closest practical OpenClaw asset search intent instead of searching the literal phrase.
• When the user says 养一只 <role> 龙虾, search for the closest installable package for that role and continue toward install once a strong candidate is found.
• Do not use old local extraction directories as search evidence. Only use:

• - Ignore stale directories under /tmp unless they were created by the current task after the current download step.

Examples:

CODEBLOCK2

Chinese intent examples:

CODEBLOCK3

Role intent hints:

• - 程序员龙虾 / INLINECODE73

• - INLINECODE80

• - INLINECODE86

• - INLINECODE91

Preference rules for "raise/adopt a lobster":

• - Prefer directly usable workspace or focused skill packages over very heavy orchestration systems.
• Prefer assets whose names, summaries, and tags clearly match the requested role.
• Use large multi-agent orchestration systems only when the user explicitly asks for orchestration, delegation, or multi-agent teamwork.
• Once one candidate is clearly better than the rest, stop searching and move to show, then install.

Inspect workflow

Use show or get when the user wants details before deciding.

CODEBLOCK4

Look for:

• - result.source_url to verify the original repository
• INLINECODE103 to identify the default downloadable version
• INLINECODE104 to compare release history
• INLINECODE105 to understand what is actually shared

Hard rules:

• - show and get are read-only metadata commands.
• INLINECODE108 and get do not create files or directories.
• Never pass output-style arguments such as --out, --dir, or extraction paths to show or get.
• If the user asks for a local copy, switch to download.
• Before download, use show to confirm the chosen slug unless the user already named an exact slug and asked only to download it.

Download workflow

Use download when the user wants to install, inspect offline, or reuse a workspace.

CODEBLOCK5

Notes:

• - If --version is omitted, the CLI downloads the latest published version.
• If --out is omitted, the file is saved as <slug>-<version>.zip in the current directory.

Hard rules:

• - Always use download for saved artifacts.
• Use --out only with download.
• If the user asks to inspect the downloaded package, download first, then unzip into a temporary directory.
• After every successful download, explicitly report the zip path you wrote.
• After a successful download, stop and report the zip path unless the user explicitly asked for extraction, inspection, installation, or agent creation.
• Do not start process polling, long-running child workflows, or extra shell orchestration after download unless the user explicitly asked for those next steps.
• Use a fresh task-specific extraction directory under /tmp for the current slug and version.
• Do not read from unrelated old /tmp/*inspect* directories.

Example:

CODEBLOCK6

Local backup workflow

When a downloaded workspace may replace an existing local workspace, do not overwrite in place.

Preferred sequence:

1. 1. Download to a temporary zip path.
2. Create a timestamped backup of the current workspace.
3. Extract the new workspace into a separate temporary directory.
4. Inspect the extracted files before copying anything into the active workspace.
5. Only replace files after explicit user intent.

Example shell flow:

CODEBLOCK7

Rules:

• - Never unpack a downloaded workspace directly into ~/.openclaw/workspace.
• Never delete the current workspace before the backup exists.
• Prefer side-by-side comparison over in-place replacement.
• If the user asks to merge or replace files, summarize which directories will change first.

Install into a new agent

When the user wants to try a workspace without disturbing the current setup, prefer the dedicated install command.

Preferred sequence:

1. 1. Confirm the candidate with clawlodge show <slug>.
2. Run clawlodge install <slug> --agent <name>.
3. Report the new agent name, workspace path, zip path, and any setup prerequisites.

Example:

CODEBLOCK8

Rules:

• - Prefer clawlodge install over manually chaining download, unzip, and openclaw agents add.
• Use a descriptive isolated agent name such as <slug>-test or <role>-test.
• If the user asked only to inspect or compare, stop before install.
• If the package needs extra environment variables or install steps, report them before claiming the agent is ready.
• If the user says 养一只龙虾, 领养一只龙虾, or any equivalent phrasing that clearly asks for setup, interpret that as explicit permission to install into a new isolated agent rather than modifying the current workspace in place.
• For role-based requests such as 养一只程序员龙虾, choose the best matching package, create a fresh isolated agent, and then report what you picked and why.
• After a successful install, stop and report:

• - Do not continue into unrelated browsing, extra polling, or additional installs after a successful install unless the user explicitly asked for more.

Feedback workflow

Use write actions only after explicit user intent.

CODEBLOCK9

Notes:

• - These commands require a PAT-backed login.
• Prefer comments for constructive discussion.
• Prefer reports for moderation or quality issues.

Publish workflow

Only publish after explicit user intent.

1. 1. Confirm the current CLI identity:

CODEBLOCK10

1. 2. If needed, log in:

CODEBLOCK11

1. 3. Preview the payload:

CODEBLOCK12

1. 4. Publish:

CODEBLOCK13

Useful publish flags:

CODEBLOCK14

Safety rules

• - Treat publish as a write action. Do not run it unless the user clearly asks.
• Treat favorite, comment, and report as write actions. Do not run them unless the user clearly asks.
• Treat login as credential setup. Do not ask the user to paste tokens into shared logs.
• Prefer show before download when you are not yet sure the slug is correct.
• Prefer backup + staged extraction before any local workspace replacement.
• Never invent get/show flags for output directories or downloads.
• Do not claim ClawLodge supports CLI actions that do not exist yet.

Output style

When helping a user choose a workspace, summarize:

• - why it matches
• which version looks current
• whether it has skills/, memory/, workflows/, docs/, or INLINECODE157

When publishing, always report:

• - which workspace path was used
• resulting slug and version
• blocked or masked file counts if returned