hansjone/oclaw
1
0
Fork 0
mirror of https://github.com/hansjone/oclaw.git synced 2026-10-09 03:13:19 +08:00
Code Issues Projects Releases Packages Wiki Activity Actions
oclaw/desktop/README.md
oliver 1490bd5f24 feat: unify runtime logging (rotating files, log root, scripts, desktop) 
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-14 10:11:51 +08:00

1.3 KiB
Raw Blame History

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:
python -m pip install -r requirements.txt

Development

From this oclaw/desktop directory:

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). 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)

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