aodhan/homeai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
60eb89ea42d7713688664f6d9f5827d3637a907e
homeai/homeai-agent/custom_components/openclaw_conversation
History
Aodhan Collins 60eb89ea42 feat: character system v2 — schema upgrade, memory system, per-character TTS routing 
Character schema v2: background, dialogue_style, appearance, skills, gaze_presets
with automatic v1→v2 migration. LLM-assisted character creation via Character MCP
server. Two-tier memory system (personal per-character + general shared) with
budget-based injection into LLM system prompt. Per-character TTS voice routing via
state file — Wyoming TTS server reads active config to route between Kokoro (local)
and ElevenLabs (cloud PCM 24kHz). Dashboard: memories page, conversation history,
character profile on cards, auto-TTS engine selection from character config.
Also includes VTube Studio expression bridge and ComfyUI API guide.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-17 19:15:46 +00:00
..
__init__.py
feat: complete voice pipeline — fix wake word crash, bridge timeout, HA conversation agent
2026-03-11 00:15:55 +00:00
config_flow.py
feat(phase-04): Wyoming Satellite integration + OpenClaw HA components
2026-03-08 02:06:37 +00:00
const.py
feat: character system v2 — schema upgrade, memory system, per-character TTS routing
2026-03-17 19:15:46 +00:00
conversation.py
feat: character system v2 — schema upgrade, memory system, per-character TTS routing
2026-03-17 19:15:46 +00:00
manifest.json
feat(phase-04): Wyoming Satellite integration + OpenClaw HA components
2026-03-08 02:06:37 +00:00
README.md
feat: OpenClaw HTTP bridge, HA conversation agent fixes, voice pipeline tooling
2026-03-08 22:46:04 +00:00
strings.json
feat(phase-04): Wyoming Satellite integration + OpenClaw HA components
2026-03-08 02:06:37 +00:00

README.md

OpenClaw Conversation - Home Assistant Custom Component

A custom conversation agent for Home Assistant that routes all voice/text queries to OpenClaw for processing.

Features

  • Direct OpenClaw Integration: Routes all conversation requests to OpenClaw
  • CLI-based Communication: Uses the openclaw CLI command (fallback if HTTP API unavailable)
  • Configurable: Set host, port, agent name, and timeout via UI
  • Voice Pipeline Compatible: Works with Home Assistant's voice assistant pipeline

Installation

Method 1: Manual Copy

  1. Copy the entire openclaw_conversation folder to your Home Assistant custom_components directory:

    # On the HA host (if using HA OS or Container, use the File Editor add-on)
cp -r homeai-agent/custom_components/openclaw_conversation \
  /config/custom_components/

  2. Restart Home Assistant

  3. Go to Settings → Devices & Services → Add Integration

  4. Search for "OpenClaw Conversation"

  5. Configure the settings:

    • OpenClaw Host: localhost (or IP of Mac Mini)
    • OpenClaw Port: 8081 (HTTP Bridge)
    • Agent Name: main (or your configured agent)
    • Timeout: 30 seconds

Method 2: Using HACS (if available)

  1. Add this repository to HACS as a custom repository
  2. Install "OpenClaw Conversation"
  3. Restart Home Assistant

Configuration

Via UI (Recommended)

After installation, configure via Settings → Devices & Services → OpenClaw Conversation → Configure.

Via YAML (Alternative)

Add to your configuration.yaml:

openclaw_conversation:
  openclaw_host: localhost
  openclaw_port: 8081
  agent_name: main
  timeout: 30

Usage

Once configured, the OpenClaw agent will be available as a conversation agent in Home Assistant.

Setting as Default Agent

  1. Go to Settings → Voice Assistants
  2. Edit your voice assistant pipeline
  3. Set Conversation Agent to "OpenClaw Conversation"
  4. Save

Testing

  1. Open the Assist panel in Home Assistant
  2. Type a query like: "Turn on the reading lamp"
  3. OpenClaw will process the request and return a response

Architecture

[Voice Input] → [HA Voice Pipeline] → [OpenClaw Conversation Agent]
                                              ↓
                                    [OpenClaw CLI/API]
                                              ↓
                                    [Ollama LLM + Skills]
                                              ↓
                                    [HA Actions + TTS Response]

Troubleshooting

Agent Not Responding

  1. Check OpenClaw is running: pgrep -f openclaw
  2. Test CLI directly: openclaw agent --message "Hello" --agent main
  3. Check HA logs: Settings → System → Logs

Connection Errors

  1. Verify OpenClaw host/port settings
  2. Ensure OpenClaw is accessible from HA container/host
  3. Check network connectivity: curl http://localhost:8081/status

Files

File Purpose
manifest.json Component metadata
__init__.py Component setup and registration
config_flow.py Configuration UI flow
const.py Constants and defaults
conversation.py Conversation agent implementation
strings.json UI translations

See Also