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

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

Made-with: Cursor

docs/OCLAW_MIGRATION_GUIDE.md

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

docs/RUNBOOK.md

@@ -15,6 +15,19 @@
 
 补充：工具脚本也统一放在 `scripts/`（例如 `seed_mcp_registry.py`、`ws_probe.py`）。
 
+路径基准约定（开源必读）：
+
+- 运行目录固定为仓库根（`.../oclaw`），不要把网关/worker 常驻进程放到上一级目录。
+- 默认配置文件路径为仓库根下的 `oclaw.json`（可用 `OCLAW_CONFIG_PATH` 覆盖）。
+- 默认数据目录为仓库根下的 `data/`（主库：`data/ai_ops.sqlite`）。
+- 相对路径一律按仓库根解析；不要在代码里拼接 `oclaw/...` 二级前缀。
+
+开源前路径自检清单：
+
+- 把仓库目录临时重命名后，`scripts/start_gateway.ps1 -SkipInstall -Background` 仍能启动。
+- `http://127.0.0.1:8787/chat` 返回 200，且后台日志中不出现 `.../oclaw/oclaw/...` 路径。
+- `python -m pytest tests/test_workspace_path_guard.py tests/test_oclaw_startup_workspace_resolution.py -q` 通过。
+
 ---
 
 ## 2. 首次初始化
@@ -362,7 +375,7 @@ AIA_REPLAY_REASONING_SIGNATURE_POLICY=auto
 
 ## 13. memory-wiki 插件启用与排障
 
-### 13.1 启用配置（oclaw/oclaw.json）
+### 13.1 启用配置（oclaw.json）
 
 将 `memory-wiki` 放入启用列表，并建议把 memory slot 指向它：
 
@@ -375,7 +388,7 @@ AIA_REPLAY_REASONING_SIGNATURE_POLICY=auto
     },
     "entries": {
       "memory-wiki": {
-        "wiki_root": "oclaw/docs/memory-system/wiki",
+        "wiki_root": "docs/memory-system/wiki",
         "max_search_results": 20,
         "max_get_lines": 800,
         "auto": {