Add OpenAI-compatible assistant provider

This commit is contained in:
reidellawfirm committed 2026-10-31 16:01:25 -05:00
1 parent a5eda29368
commit 77e8a86196
19 files changed
+807 -23

No files matched your search

+36 -2
View File
@@ -64,8 +64,10 @@ import it into the new version.
* **A voice assistant** that wakes up when you say "Hey Even", transcribes
text with an on-device model, OpenAI Whisper, ElevenLabs, or Soniox API,
and responds to queries and commands using an onboard model (Qwen3 4B,
slow) or with an Anthropic or OpenAI model (requires an API key), or using
your own long-running OpenClaw agent.
slow) or with an Anthropic, OpenAI, or OpenAI-compatible Chat Completions
model (including Venice and private Open WebUI servers; model ID and
usually an API key required), or using your own long-running OpenClaw
agent.
* **Multitasking**, with an app-switcher sidebar and app launcher.
* **Glanceboard**, a dashboard with widgets that you can quickly view with a
* **Mostly-compatible with EvenHub.** Install and runapps from the Even app
@@ -95,6 +97,38 @@ import it into the new version.
the glasses, and you can use the phone touchscreen as an input device..
<!-- END GENERATED: features -->
## OpenAI-compatible assistant providers (Venice / Open WebUI)
The assistant can call an OpenAI-compatible **Chat Completions** endpoint directly
from the phone. This uses the same conversation history and glasses tool loop as
the built-in cloud providers; it does not require different glasses firmware.
In **Settings > Assistant**, set:
1. **Compatible API URL** — the explicit API root.
2. **Compatible model ID** — the exact model identifier accepted by the server.
3. **Compatible API key** — optional; when set, it is sent only to the configured
compatible endpoint as a Bearer token, not to OpenAI's Whisper service.
4. **Assistant model** — choose **OpenAI-compatible**. Auto never selects it.
Provider examples:
| Provider | Compatible API URL | Notes |
| --- | --- | --- |
| Venice | `https://api.venice.ai/api/v1` | Use a current Venice model ID. Choose one with function-calling support if you want glasses tools. |
| Open WebUI | `https://your-openwebui-host/api` | This produces `/api/chat/completions`. Use the model ID exposed by your server and an Open WebUI API key if required. |
You may paste the full `/chat/completions` endpoint instead; Faceclaw removes
that suffix. It otherwise preserves the path you enter and does not guess `/v1`
or `/api`. There is no automatic model discovery in this version.
The same provider can supply Calculator's rewrite fallback and Translate.
Actual tool calling depends on the selected model and server. Use HTTPS where
possible; mobile cleartext policies may block plain HTTP. For a private server,
make it reachable from the phone (for example through your tailnet) without
exposing it publicly. Exported settings contain API keys and must be treated as
secrets.
## Watch remote (Wear OS)
The `wear/` directory holds a companion app for Wear OS 3+ watches that turns