oclaw/desktop
oliver 420abac9f1 refactor: root-package imports (svc/runtime/interfaces) and fix PYTHONPATH
- Rename platform/ to svc/ to avoid shadowing stdlib platform.
- Replace from oclaw.* with from svc/runtime/interfaces; update -m CLI paths.
- tests/conftest: prepend repo root to sys.path (no parent-folder package name).
- CI: paths and offline_eval script under repo root.
- Ops scripts: PYTHONPATH must be repo root for python -m runtime.* (fixes gateway/WhatsApp sidecar startup).
- Fix default oclaw.json path in tabular/file attachment limits; stabilize attachment test config.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-13 14:51:17 +08:00
..
assets 初始化:独立 oclaw 仓库首提交 2026-04-24 22:31:22 +08:00
tools feat(品牌): 支持 _local 外部优先 Logo 与图标覆盖 2026-05-07 10:17:38 +08:00
main.js refactor: root-package imports (svc/runtime/interfaces) and fix PYTHONPATH 2026-05-13 14:51:17 +08:00
package-lock.json 初始化:独立 oclaw 仓库首提交 2026-04-24 22:31:22 +08:00
package.json 初始化:独立 oclaw 仓库首提交 2026-04-24 22:31:22 +08:00
preload.js 初始化:独立 oclaw 仓库首提交 2026-04-24 22:31:22 +08:00
README.md refactor: root-package imports (svc/runtime/interfaces) and fix PYTHONPATH 2026-05-13 14:51:17 +08:00

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 are written under:

  • %APPDATA%/oclaw/logs/backend.log (Windows)

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