fox1.2 / README.md
teolm30's picture
Upload folder using huggingface_hub
38eace5 verified
# Fox1.2 OpenClaw - 100% OpenClaw Tool Supported
A fine-tuned Qwen2.5-0.5B model optimized for OpenClaw agent tool execution.
## Model Details
- **Base:** Qwen2.5-0.5B-Instruct
- **Parameters:** ~494M (compressed, efficient)
- **Context Length:** 32,768 tokens
- **Size:** ~994MB (F16)
## Capabilities - All OpenClaw Tools Supported ✅
### Core Tools
- **exec**: Shell command execution (ls, cd, git, docker, npm, pip, python, node, etc.)
- **read**: Read file contents (path required)
- **write**: Write content to file (path, content required)
- **edit**: Edit file by replacing exact text (path, oldText, newText required)
### Process Management
- **process**: Background session management (list, poll, write, send-keys, submit, paste, kill)
### Web Operations
- **web_search**: DuckDuckGo search (query, count, region, safeSearch)
- **web_fetch**: Fetch and extract web content (url, extractMode, maxChars)
### OpenClaw Management
- **session_status**: Get session information
- **sessions_list**: List active sessions (activeMinutes, kinds, limit, messageLimit)
- **sessions_history**: Get conversation history (sessionKey, includeTools, limit)
- **sessions_send**: Send messages between sessions (sessionKey/label, message)
- **sessions_spawn**: Spawn sub-agents or ACP sessions (task, runtime, mode, etc.)
- **sessions_yield**: End current turn
- **subagents**: Manage spawned sub-agents (list, kill, steer)
### Cron Jobs
- **cron**: Job management (status, list, add, update, remove, run, runs, wake)
### Memory
- **memory_search**: Search memory files (query, maxResults, minScore)
- **memory_get**: Retrieve memory content (path, from, lines)
### Additional
- **image**: Image analysis (image/images, prompt)
- **weather**: Weather information (location)
## Tool Call Format
When you need to execute a tool, respond with JSON in this format:
```json
{"action": "tool_name", "param1": "value1", "param2": "value2"}
```
### Examples
```json
{"action": "exec", "command": "ls -la"}
{"action": "read", "path": "/home/user/README.md"}
{"action": "write", "path": "/home/user/test.txt", "content": "Hello World"}
{"action": "web_search", "query": "python tutorials"}
{"action": "weather", "location": "Athens"}
{"action": "cron", "action": "list"}
{"action": "session_status"}
```
## Usage
### Ollama
```bash
# Create the model
ollama create fox1.2-openclaw -f Modelfile
# Run it
ollama run fox1.2-openclaw "list files in current directory"
```
### Python/Transformers
```python
from transformers import AutoModelForCausalLM, AutoTokenizer
model = AutoModelForCausalLM.from_pretrained("teolm30/fox1.2-openclaw")
tokenizer = AutoTokenizer.from_pretrained("teolm30/fox1.2-openclaw")
# Generate tool call
inputs = tokenizer("List all files", return_tensors="pt")
outputs = model.generate(**inputs, max_new_tokens=256)
print(tokenizer.decode(outputs[0]))
```
### HuggingFace CLI
```bash
# Download
huggingface-cli download teolm30/fox1.2-openclaw
# Or use curl
curl -L -o fox1.2-openclaw.gguf https://huggingface.co/teolm30/fox1.2-opencloak/resolve/main/fox1.2-openclaw.gguf
```
## Why This Model?
- **Compact**: 494M params - runs on consumer hardware (6GB VRAM)
- **Fast**: Optimized for local inference
- **100% Tool Support**: All OpenClaw agent tools supported
- **Smart Tool Selection**: Knows when to use each tool appropriately
- **OpenClaw Native**: Built specifically for OpenClaw integration
## Training
Trained on 200+ examples covering all OpenClaw tool patterns:
- File operations (read, write, edit)
- Shell commands (exec)
- Web operations (search, fetch)
- Session management
- Cron jobs
- Memory operations
- And more...
Optimized for tool call generation and execution in agent workflows.
## OpenClaw Configuration
Add to your `models.json`:
```json
{
"id": "fox1.2-openclaw:latest",
"name": "Fox1.2 OpenClaw",
"reasoning": false,
"input": ["text"],
"contextWindow": 32768,
"maxTokens": 4096,
"api": "ollama"
}
```
Then restart OpenClaw: `openclaw gateway restart`
## License
Apache 2.0
## Author
teolm30 (OpenClaw Community)
## Version History
- v1.0 (2026-04-01): Initial release with 100% OpenClaw tool support