Files
openclaw/docs/plugins/reference/llama-cpp.md
T
Peter Steinberger 0135046830 refactor(llama-cpp): use one provider for managed and existing servers (#126434)
* refactor(llama-cpp): unify server ownership modes

* test(llama-cpp): preserve shared discovery limits

* fix(plugin-sdk): retain provider auth removal export
2026-08-19 13:57:33 -07:00

1.1 KiB

summary, read_when, title
summary read_when title
Managed and external llama.cpp servers for GGUF chat and embeddings.
You are installing, configuring, or auditing the llama-cpp plugin
Llama Cpp plugin

Llama Cpp plugin

Managed and external llama.cpp servers for GGUF chat and embeddings.

Distribution

  • Package: @openclaw/llama-cpp-provider
  • Install route: npm; ClawHub

Surface

providers: llama-cpp; contracts: embeddingProviders

Default text model

During interactive setup, OpenClaw installs a pinned, verified llama-server and offers Gemma 4 E4B IT Q4_K_M as an approximately 5.0 GB download. The model offer requires at least 16 GiB of total RAM. Existing cached models are still detected on smaller machines.

To use another model, set params.modelPath to any custom GGUF. Custom models are not subject to the bundled-download RAM requirement. On machines below the requirement, you can also run a smaller model through Ollama or LM Studio, or choose a cloud provider.