Merge branch 'pr-57'

This commit is contained in:
James Babcock committed 2026-11-01 00:29:16 -07:00
commit 7f3e3f2305
25 files changed
+1888 -41

No files matched your search

+47 -2
View File
@@ -65,8 +65,10 @@ import it into the new version (see [config transfer](scripts/config-transfer.md
* **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), with optional Venice web search for supported
models, 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
@@ -96,6 +98,49 @@ import it into the new version (see [config transfer](scripts/config-transfer.md
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. Optional: choose **Discover models**, then pick a model from the server catalog.
The picker shows tool capability when advertised and hides offline models by
default. Refresh never changes the saved model by itself.
5. **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`. Discovery requests `{API root}/models` only when you choose it; there
is no background discovery or automatic model selection. Manual model entry
remains available for servers without a compatible model-list endpoint.
For the official Venice URL, **Settings > Assistant** also shows **Venice web
search**. It is off by default and visible only for that URL. When enabled,
supported Venice models may search the web for current information; the search
model must support the feature. Open WebUI and other compatible servers never
receive Venice-specific parameters, including after an endpoint switch.
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