mirror of https://github.com/hansjone/oclaw.git synced 2026-10-09 01:50:44 +08:00

History

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
..
assets	初始化：独立 oclaw 仓库首提交	2026-04-24 22:31:22 +08:00
tools	feat(品牌): 支持 _local 外部优先 Logo 与图标覆盖	2026-05-07 10:17:38 +08:00
main.js	feat: unify runtime logging (rotating files, log root, scripts, desktop)	2026-05-14 10:11:51 +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	feat: unify runtime logging (rotating files, log root, scripts, desktop)	2026-05-14 10:11:51 +08:00

README.md

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:

Pick an available local port (default prefers 8787).
Start backend using python -m runtime.operations gateway start --host 127.0.0.1 --port <port>.
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