完成运行时与启动链路的全面相对路径整改,统一以仓库根为路径基准并移除 oclaw 双层硬编码。

同时补齐路径回归测试与开源自检文档,确保从非仓库 cwd 启动时 workspace 根、配置和 wiki 路径仍稳定可用。

Made-with: Cursor
This commit is contained in:
oliver 2026-04-26 09:22:42 +08:00
parent dbbe3add6a
commit 9d2900db02
40 changed files with 223 additions and 82 deletions

View file

@ -1,12 +1,21 @@
# Oclaw Migration Guide
This repository is migrating from legacy `oclaw/` runtime wiring to the new `oclaw/` architecture root.
This repository now uses **repo-root relative** runtime wiring.
## Current status
- `oclaw/` is the target root for new code.
- The repository root is the only runtime base path.
- `oclaw/app_server/*` compatibility modules have been removed.
- Gateway dispatch now routes through shared `server_methods` handlers for both WS and HTTP method endpoints.
## Path baseline (important for open-source portability)
- Do not hardcode `PROJECT_ROOT / "oclaw" / ...`.
- Use repo-root relative paths such as:
- config: `oclaw.json`
- data: `data/ai_ops.sqlite`
- workspaces: `runtime/workspaces/*`
- wiki root default: `docs/memory-system/wiki`
- Startup scripts should run from repo root and explicitly set workspace env vars; avoid relying on parent-directory cwd.
## Developer rules
- Add new business logic under `oclaw/` (interfaces/application/domain/infrastructure/shared).
- Avoid adding new core logic into legacy `oclaw/` modules.