homeai/PHASE4_COMPLETION.md

Phase 4 — OpenClaw Tool Calling Resolution

Problem Statement

OpenClaw needed Ollama to return structured tool_calls in API responses. The issue was a template mismatch:

• llama3.3:70b outputs <|python_tag|>exec {...} (Llama's trained format)
• qwen3:32b had template issues causing 400 errors
• Ollama's template parser couldn't match the model output to the expected tool call format

Solution Implemented

Option A: Pull qwen2.5:7b — Ollama ships with a working tool-call template for this model.

What Was Done

1. Model Deployment

• Pulled qwen2.5:7b (~4.7GB) from Ollama registry
• Model includes native tool-calling support with proper template
• Fast inference (~2-3s per response)

2. OpenClaw Configuration

Updated ~/.openclaw/openclaw.json:

{
  "models": {
    "providers": {
      "ollama": {
        "models": [
          {
            "id": "qwen2.5:7b",
            "name": "qwen2.5:7b",
            "contextWindow": 32768,
            "maxTokens": 4096
          },
          {
            "id": "llama3.3:70b",
            "name": "llama3.3:70b",
            "contextWindow": 32768,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "ollama/qwen2.5:7b"
      }
    }
  }
}

3. HASS_TOKEN Setup

• Fixed ~/.homeai/hass_token (removed trailing comment from file)
• Token is properly configured in launchd plist: com.homeai.openclaw.plist
• HA API connectivity verified: https://10.0.0.199:8123/api/ ✓

4. Tool Calling Verification

Direct Ollama API Test:

curl -s http://localhost:11434/api/chat \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen2.5:7b",
    "messages": [{"role": "user", "content": "Turn on the reading lamp"}],
    "tools": [{"type": "function", "function": {"name": "call_service", ...}}],
    "stream": false
  }'

Result: ✓ Returns proper tool_calls array with structured function calls

OpenClaw Agent Test:

openclaw agent --message "Turn on the study shelves light" --agent main

Result: ✓ Agent successfully executed the command via home-assistant skill

5. Home Assistant Skill Testing

• Tested turn_on command: ✓ Light turned on
• Tested turn_off command: ✓ Light turned off
• State updates verified via HA API: ✓ Confirmed

Current Status

✓ Completed Tasks (Phase 4)

• Pull qwen2.5:7b model
• Configure OpenClaw to use qwen2.5:7b as primary model
• Wire HASS_TOKEN (~/.homeai/hass_token)
• Test home-assistant skill with real HA entities
• Verify tool calling works end-to-end

Available Models

• qwen2.5:7b — Primary (tool calling enabled) ✓
• llama3.3:70b — Fallback (available but not primary)

Next Steps (Phase 4 Remaining)

• Set up mem0 with Chroma backend, test semantic recall
• Write memory backup launchd job
• Build morning briefing n8n workflow
• Build notification router n8n workflow
• Verify full voice → agent → HA action flow
• Add OpenClaw to Uptime Kuma monitors

Technical Notes

Why qwen2.5:7b Works

1. Native Template Support: Ollama's registry includes a proper chat template for qwen2.5
2. Tool Calling Format: Model outputs match Ollama's expected tool call structure
3. No Template Tuning Needed: Unlike llama3.3:70b, no custom TEMPLATE block required
4. Performance: 7B model is fast enough for real-time HA control

Token File Issue

The ~/.homeai/hass_token file had trailing content from the .env comment. Fixed by:

1. Extracting clean token from .env using awk '{print $1}'
2. Writing with printf (not echo -n which was being interpreted literally)
3. Verified token length: 183 bytes (correct JWT format)

HA API Connectivity

• HA runs on https://10.0.0.199:8123 (HTTPS, not HTTP)
• Requires -k flag in curl to skip SSL verification (self-signed cert)
• Token authentication working: Authorization: Bearer <token>

Files Modified

• ~/.openclaw/openclaw.json — Updated model configuration
• ~/.homeai/hass_token — Fixed token file
• TODO.md — Marked completed tasks

Verification Commands

# Check model availability
ollama list | grep qwen2.5

# Test tool calling directly
curl -s http://localhost:11434/api/chat \
  -H "Content-Type: application/json" \
  -d '{"model": "qwen2.5:7b", "messages": [...], "tools": [...], "stream": false}'

# Test OpenClaw agent
openclaw agent --message "Turn on the study shelves light" --agent main

# Verify HA connectivity
curl -sk -H "Authorization: Bearer $(cat ~/.homeai/hass_token)" \
  https://10.0.0.199:8123/api/

# Test home-assistant skill
HASS_TOKEN=$(cat ~/.homeai/hass_token) \
  ~/gitea/homeai/homeai-agent/skills/home-assistant/ha-ctl \
  on light.study_shelves

Summary

Phase 4 tool calling issue is RESOLVED. OpenClaw can now:

• ✓ Receive structured tool calls from qwen2.5:7b
• ✓ Execute home-assistant skill commands
• ✓ Control HA entities (lights, switches, etc.)
• ✓ Provide natural language responses

The system is ready for the next phase: memory integration and workflow automation.