mirror of
https://github.com/hansjone/oclaw.git
synced 2026-10-09 03:30:48 +08:00
52 lines
1.3 KiB
Markdown
52 lines
1.3 KiB
Markdown
# Desktop Shell
|
|
|
|
Electron wrapper for existing `admin/chat` frontend with an embedded local backend process.
|
|
|
|
## Prerequisites
|
|
|
|
- Node.js 20+
|
|
- Python 3.10+ (available in `PATH` as `python`)
|
|
- Python deps installed in repo root:
|
|
|
|
```powershell
|
|
python -m pip install -r requirements.txt
|
|
```
|
|
|
|
## Development
|
|
|
|
From this `oclaw/desktop` directory:
|
|
|
|
```powershell
|
|
npm install
|
|
npm run dev
|
|
```
|
|
|
|
The app will:
|
|
|
|
1. Pick an available local port (default prefers `8787`).
|
|
2. Start backend using `python -m runtime.operations gateway start --host 127.0.0.1 --port <port>`.
|
|
3. Open `http://127.0.0.1:<port>/chat` in the desktop window.
|
|
|
|
Logs (embedded backend, desktop shell, optional WeCom channel child) are written under the **runtime log root** (same as `AIA_RUNTIME_LOG_DIR` / `data/logs/` — see repo root [`docs/LOGGING.md`](../docs/LOGGING.md)). When launched via `runtime/operations/scripts/start_desktop.ps1`, `OCLAW_DESKTOP_LOG_ROOT` is set for you.
|
|
|
|
Typical files:
|
|
|
|
- `desktop.log`
|
|
- `backend.log`
|
|
|
|
## Environment knobs
|
|
|
|
- `PYTHON_EXECUTABLE`: absolute path to python executable.
|
|
- `AIA_DESKTOP_BACKEND_PORT`: preferred backend port.
|
|
|
|
## Packaging (Windows)
|
|
|
|
```powershell
|
|
npm run pack:win
|
|
```
|
|
|
|
Output goes to `oclaw/desktop/dist/`, e.g.:
|
|
|
|
- `oclaw-setup-<version>.exe`
|
|
- `oclaw-setup-<version>.exe.blockmap`
|
|
- `win-unpacked/oclaw.exe`
|