Add OpenClaw to local apps

[osolmaz]

Summary

• Add OpenClaw as a local app for tool-calling GGUF/MLX conversational models
• Reuse the existing local OpenAI-compatible server step shared by Pi and Hermes
• Configure OpenClaw via models.providers and set the selected local model as the default

Test plan

• pnpm --filter @huggingface/tasks test -- local-apps
• pnpm --filter @huggingface/tasks format:check
• pnpm --filter @huggingface/tasks check

Note: assumes the OpenClaw local-app logo asset is already available for the openclaw app key.

---

Note

Low Risk
Documentation-style snippet and registry changes in @huggingface/tasks with no runtime auth or data-path changes.

Overview
Adds OpenClaw to the model-page local apps list so eligible tool-calling GGUF/MLX models get copy-paste setup snippets.

The new flow mirrors Pi/Hermes: start a local OpenAI-compatible server (llama-server or mlx_lm.server), then run openclaw onboard against http://127.0.0.1:8080/v1 with provider llama-cpp or mlx-lm, and finally a sample openclaw agent command. Visibility uses the same isToolCallingLocalAgentModel gate as other local agents.

Tests cover both GGUF and MLX snippet shapes, including that onboard omits a literal --custom-api-key flag while still using --auth-choice custom-api-key.

^{Reviewed by Cursor Bugbot for commit 219865e. Bugbot is set up for automated code reviews on this repo. Configure here.}

[pcuenca]

Haven't tested the commands, but conceptually looks good.

[osolmaz]

I am now going through this extensively and asking Peter about the long-term stability of CLI args, thank you for bearing with me. I will ping again once I am 100% confident the snippets fit the long term shape

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ccd307c317

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[osolmaz]

Current output of the snippets:

GGUF / llama.cpp:

# Install llama.cpp:
brew install llama.cpp

# Start a local OpenAI-compatible server:
llama-server -hf ggml-org/gemma-4-E4B-it-GGUF:Q4_K_M

# Install OpenClaw:
npm install -g openclaw@latest

# Register the local server and set it as the default model:
openclaw onboard --non-interactive --mode local \
  --auth-choice custom-api-key \
  --custom-base-url http://127.0.0.1:8080/v1 \
  --custom-model-id "ggml-org/gemma-4-E4B-it-GGUF:Q4_K_M" \
  --custom-provider-id llama-cpp \
  --custom-compatibility openai \
  --custom-text-input \
  --accept-risk \
  --skip-health

openclaw agent --local --agent main --message "Hello from Hugging Face"

MLX:

# Install MLX LM:
uv tool install mlx-lm

# Start a local OpenAI-compatible server:
mlx_lm.server --model "mlx-community/Qwen3-0.6B-4bit"

# Install OpenClaw:
npm install -g openclaw@latest

# Register the local server and set it as the default model:
openclaw onboard --non-interactive --mode local \
  --auth-choice custom-api-key \
  --custom-base-url http://127.0.0.1:8080/v1 \
  --custom-model-id "mlx-community/Qwen3-0.6B-4bit" \
  --custom-provider-id mlx-lm \
  --custom-compatibility openai \
  --custom-text-input \
  --accept-risk \
  --skip-health

openclaw agent --local --agent main --message "Hello from Hugging Face"

[osolmaz]

AFAIU test failures are unrelated to the changes proposed in this PR