#20785: feat: add bypass-model support for skill commands
agents
size: S
Cluster:
Skill and Session Management Fixes
## Summary
Add `bypass-model: true` and `exec-command: "..."` frontmatter support for skills, allowing slash commands to execute shell commands directly without AI model invocation.
## Why This Matters
**With bypass-model, OpenClaw becomes a true Intelligent Assistant — not just an AI Assistant.**
- 🧠 **Uses AI when AI is needed** — complex reasoning, creative tasks, conversations
- ⚡ **Uses direct commands when commands are enough** — system queries, scripts, utilities
- 💰 **Zero tokens wasted** on deterministic operations
- 🎯 **100% accuracy** for command-based tasks (no hallucination possible)
- 🚀 **Instant response** — no model latency for simple commands
This is the difference between a smart tool that knows when to think vs. one that overthinks everything.
## Usage
```yaml
# ~/.openclaw/skills/ip/SKILL.md
---
name: ip
description: Get public IP address
user-invocable: true
bypass-model: true
exec-command: "curl -s ipinfo.io/ip"
---
```
Arguments pass through automatically:
- `/git status` → executes `git status`
- `/note list` → executes `note list`
- `/docker ps` → executes `docker ps`
## Changes
| File | Change |
|------|--------|
| `src/agents/skills/workspace.ts` | Parse `bypass-model` and `exec-command` from frontmatter |
| `src/auto-reply/reply/get-reply-inline-actions.ts` | Execute bypass logic before normal dispatch |
| `src/auto-reply/reply/get-reply-directives.ts` | Fix bug: skill commands now load without model aliases |
## Testing
1. Create a bypass-model skill as shown above
2. Invoke via `/ip` in any channel
3. Verify instant response without model usage
## Backwards Compatibility
- ✅ No breaking changes
- ✅ Existing skills work exactly as before
- ✅ Opt-in via explicit `bypass-model: true`
---
**Fixes:** #7985
**Also addresses:** #10366
cc @ShenWang96 @twobotass @5hanth
Most Similar PRs
#22924: feat(model-usage): merge basic observability modes (errors/overview)
by futuremind2026 · 2026-02-21
63.4%
#11858: Exec: surface skill hints on command-not-found failures
by frankisawesome · 2026-02-08
63.3%
#8455: feat: add thinking/model config to skills.entries
by tsukhani · 2026-02-04
63.1%
#23252: feat(skills): add browser-use as bundled skill
by ShawnPana · 2026-02-22
61.1%
#22660: feat(agents): prioritize fallback-chain recovery and configurable r...
by sauerdaniel · 2026-02-21
60.7%
#11734: CLI: scope /model and /new prompt messaging to fallback-only paths
by arimendelow · 2026-02-08
60.4%
#20275: fix(cli): include primary model in allowlist when adding fallbacks
by MFS-code · 2026-02-18
60.1%
#21963: fix(cli): models fallbacks add now includes primary model in allowlist
by ashiabbott · 2026-02-20
59.9%
#6730: feat: Make OpenAI Codex CLI models usable - reasoning effort directive
by levineam · 2026-02-02
59.1%
#16033: fix: add model configuration step to onboard command
by MisterGuy420 · 2026-02-14
59.0%