oclaw/desktop
oliver 16169b3de2 fix(desktop): external gateway mode and start script alignment
- Add desktop env for non-embedded gateway (OCLAW_DESKTOP_EMBED_BACKEND, base URL, skip channel).
- Wire start_all/start_desktop to pass gateway URL when keeping existing gateway; fix root start_all flags.
- Prefer electron.cmd for background desktop launch; admin static theme presets and chat boot timeouts.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-06 11:06:16 +08:00
..
assets 初始化:独立 oclaw 仓库首提交 2026-04-24 22:31:22 +08:00
tools 初始化:独立 oclaw 仓库首提交 2026-04-24 22:31:22 +08:00
main.js fix(desktop): external gateway mode and start script alignment 2026-05-06 11:06:16 +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 重构仓库目录为统一的 runtime 分层并清理历史 openclaw 残留。 2026-04-25 01:24:23 +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 oclaw.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