openclaw/src
artale 4df970d711 fix: improve error for unconfigured local providers (ollama/vllm) (#17328)
When a user sets `agents.defaults.model.primary: "ollama/gemma3:4b"`
but forgets to set OLLAMA_API_KEY, the error is a confusing
"unknown model: ollama/gemma3:4b". The Ollama provider requires any
dummy API key to register (the local server doesn't actually check it),
but this isn't obvious from the error.

Add `buildUnknownModelError()` that detects known local providers
(ollama, vllm) and appends an actionable hint with the env var name
and a link to the relevant docs page.

Before: Unknown model: ollama/gemma3:4b
After:  Unknown model: ollama/gemma3:4b. Ollama requires authentication
        to be registered as a provider. Set OLLAMA_API_KEY="ollama-local"
        (any value works) or run "openclaw configure".
        See: https://docs.openclaw.ai/providers/ollama

Closes #17328
2026-02-16 23:54:31 +01:00
..
acp
agents fix: improve error for unconfigured local providers (ollama/vllm) (#17328) 2026-02-16 23:54:31 +01:00
auto-reply feat(commands): add /subagents spawn command 2026-02-16 23:54:14 +01:00
browser test: add tests for extraArgs filtering logic 2026-02-16 23:52:42 +01:00
canvas-host
channels channels: add createAccountListHelpers factory 2026-02-16 23:53:19 +01:00
cli CLI: preserve message send components payload 2026-02-16 23:54:08 +01:00
commands fix(doctor,configure): skip gateway auth for loopback-only setups 2026-02-16 23:53:11 +01:00
compat
config gateway: wire channel health monitor into startup with configurable interval 2026-02-16 23:53:35 +01:00
cron fix(cron): preserve model fallbacks when agent overrides primary 2026-02-16 23:54:17 +01:00
daemon fix(daemon): prefer current node and add macOS version manager paths to service PATH 2026-02-16 23:53:41 +01:00
discord channels: migrate core channel account listing to factory 2026-02-16 23:53:19 +01:00
docs
gateway fix: clear stale device-auth token on token mismatch 2026-02-16 23:54:23 +01:00
hooks fix(session-memory): fallback to rotated transcript after /new 2026-02-16 23:49:41 +01:00
imessage channels: migrate core channel account listing to factory 2026-02-16 23:53:19 +01:00
infra CLI: preserve message send components payload 2026-02-16 23:54:08 +01:00
line refactor(channels): dedupe transport and gateway test scaffolds 2026-02-16 14:59:31 +00:00
link-understanding
linq feat(linq): add read receipts, typing indicators, and User-Agent header 2026-02-16 23:52:56 +01:00
logging feat: add stuck loop detection and exponential backoff infrastructure for agent polling (#17118) 2026-02-16 15:16:35 -05:00
macos
markdown test: remove duplicate hr spacing assertion 2026-02-16 06:16:33 +00:00
media fix(media): clean expired files in subdirectories 2026-02-16 23:50:56 +01:00
media-understanding fix: support OAuth for Gemini media understanding 2026-02-16 23:53:21 +01:00
memory feat: LLM-based query expansion for FTS mode 2026-02-16 23:53:21 +01:00
node-host
pairing refactor(core): dedupe tool policy and IPv4 matcher logic 2026-02-16 16:14:54 +00:00
plugin-sdk channels: add createAccountListHelpers factory 2026-02-16 23:53:19 +01:00
plugins feat: add Linq channel — real iMessage via API, no Mac required 2026-02-16 23:52:56 +01:00
process fix: add windowsHide: true to spawn in runCommandWithTimeout 2026-02-16 23:49:47 +01:00
providers refactor(agent): dedupe harness and command workflows 2026-02-16 14:59:30 +00:00
routing refactor(core): dedupe shared config and runtime helpers 2026-02-16 14:59:30 +00:00
scripts
security refactor(core): dedupe tool policy and IPv4 matcher logic 2026-02-16 16:14:54 +00:00
sessions
shared refactor(core): dedupe shared config and runtime helpers 2026-02-16 14:59:30 +00:00
signal channels: migrate core channel account listing to factory 2026-02-16 23:53:19 +01:00
slack channels: migrate core channel account listing to factory 2026-02-16 23:53:19 +01:00
telegram test: update tests and comments to reflect new autoSelectFamily default 2026-02-16 23:53:44 +01:00
terminal
test-helpers
test-utils refactor(core): dedupe shared config and runtime helpers 2026-02-16 14:59:30 +00:00
tts refactor(channels): dedupe transport and gateway test scaffolds 2026-02-16 14:59:31 +00:00
tui refactor(tests): share harnesses for cli and monitor fixtures 2026-02-16 17:06:40 +00:00
types
utils
web channels: migrate core channel account listing to factory 2026-02-16 23:53:19 +01:00
whatsapp
wizard Onboarding: fix webchat URL loopback and canonical session 2026-02-16 23:52:00 +01:00
channel-web.ts
docker-setup.test.ts
entry.ts
extensionAPI.ts
globals.ts
index.ts
logger.test.ts
logger.ts
logging.ts
polls.test.ts
polls.ts
runtime.ts refactor(core): extract shared runtime and wizard schemas 2026-02-16 17:06:40 +00:00
utils.test.ts
utils.ts
version.test.ts
version.ts