Governance wrapper for OpenClaw runtime

openclaw-governance

openclaw-governance 是 governance layer（治理層）repo（儲存庫），用來保存可分享的 policy（政策）、decision records（決策紀錄）、templates（樣板）與 export boundary（匯出邊界）。它不取代 OpenClaw runtime（OpenClaw 執行環境），也不把 private runtime state（私密執行狀態）搬進 repo。

治理水管 系統架構 Architecture（架構文件） Private boundary（私密邊界）
Governance Consolestatic preview
PolicyApproval and memory rules（核准與記憶規則）
ExportShareable governance（可分享治理）
BoundaryPrivate vs shareable（私密與可分享）
TemplatesAgent handoff（代理交接樣板）
Runtime
source
Export
filtered
Review
manual
Project intent（專案定位）

治理文件 repo（儲存庫），不是 runtime dump（執行環境傾印）

這份 showcase（展示頁）只呈現 repo 內可分享架構與文件流。它不讀取 `local/`、不掃描 session archive（對話封存）、不解析 memory store（記憶儲存），也不輸出 OpenClaw runtime（OpenClaw 執行環境）的即時狀態。

Owner（擁有者）

明確定義 governance（治理）邊界

哪些 rules（規則）可以公開、哪些 runtime artifacts（執行產物）只能留在本機，一眼分開。

Agent（代理）

提供可操作的 templates（樣板）

`templates/` 讓不同 agent（代理）可用一致格式交接 identity（身份）、memory（記憶）與 tools（工具）。

Reviewer（審查者）

決策與匯出可追溯

`docs/DECISIONS.md`、`docs/SYNC_STRATEGY.md` 與 export scripts（匯出腳本）支撐人類審查。

Dynamic Pipeline（水管線路圖）

從 OpenClaw runtime 到 shareable governance（可分享治理）的六段水管

這條水管標示每段的 filter（過濾）、review（審查）與 output（輸出）責任。頁面本身不會執行 export（匯出）或讀取本機 private data（私密資料）。

Input（輸入）
Runtime governance source（執行環境治理來源）與 workspace rules（工作區規則）。
Owner（責任）
Human owner（人類擁有者）決定哪些內容可分享。
Output（輸出）
只留下可公開審查的 governance docs（治理文件）與 templates（樣板）。
System Architecture（系統架構）

Repo（儲存庫）保管治理層，runtime（執行環境）仍留在本機

這張 architecture map（架構地圖）刻意把 live runtime（即時執行環境）、export layer（匯出層）與 review layer（審查層）拆開，避免 showcase（展示頁）誤導成 runtime UI（執行介面）。

Governance Docs（治理文件）`docs/GOVERNANCE_OVERVIEW.md`、`docs/APPROVAL_POLICY.md`、`docs/MEMORY_POLICY.md`。
Decision Trail（決策軌跡）`docs/DECISIONS.md`、`docs/adr/`、`docs/routing/` 保留設計演進。
Publishing（發布）`docs/PUBLISHING_TEMPLATE.md` 與 `docs/SYNC_STRATEGY.md` 定義同步節奏。
Shareable Governance Boundary（可分享治理邊界） `scripts/export_governance.sh` 與 `exports/governance/` 代表「可被版本化的治理輸出」。它不應包含 local runtime dump（本機執行傾印）、session archive（對話封存）或 private overlay（私密覆蓋）。
Templates（樣板）`templates/*.example.md` 提供 identity（身份）、tools（工具）、memory（記憶）與 session summary（對話摘要）格式。
Private Boundary（私密邊界）`local/README.md` 與 `docs/PRIVATE_VS_SHAREABLE.md` 說明本機資料不可公開。
Verification（驗證）`scripts/verify.ps1`、`tests/README.md` 與 HTML showcase（HTML 展示）共同守住文件品質。
User Architecture（使用者架構）

人類 owner（擁有者）決策，agent（代理）只能依邊界執行

User architecture（使用者架構）說明誰能決定 governance（治理）更新、誰能產出 export（匯出）、誰負責審查 private boundary（私密邊界）。

Owner（擁有者）

決定 policy（政策）

批准 approval policy（核准政策）、memory policy（記憶政策）與可分享 baseline（基線）。

Agent（代理）

執行 export（匯出）與整理 docs（文件）

只能根據 repo（儲存庫）內規則與 scripts（腳本）產出，不可自行帶入 private runtime state（私密執行狀態）。

Reviewer（審查者）

檢查邊界與可讀性

確認 PR（合併請求）裡的 governance（治理）內容可理解、可追溯、沒有敏感資料。

Verification Panel（驗證面板）

以靜態檢查確保 showcase（展示頁）沒有越界

openclaw-governance 的驗證重點不是跑 runtime（執行環境），而是確保 repo documents（文件）、exports（匯出）與 showcase（展示頁）都沒有把 private data（私密資料）版本化。

.\scripts\verify.ps1
bash scripts/export_governance.sh
python -m http.server 8768 --bind 127.0.0.1
確認 `docs/showcase/index.html` 具備 system architecture（系統架構）、user architecture（使用者架構）與 dynamic pipeline（水管線路圖）。
確認 showcase（展示頁）沒有讀取 `local/`、session archive（對話封存）或 memory store（記憶儲存）。
確認 export（匯出）只包含 `exports/governance/` 內可審查 baseline（基線）。
Private Data Boundary（私密資料邊界）

OpenClaw runtime（OpenClaw 執行環境）不是本 repo 的公開資料源

高風險內容包含 live runtime settings（即時執行設定）、user-specific identity（使用者特定身份）、session archives（對話封存）、private overlays（私密覆蓋）、tool credentials（工具憑證）與 local notes（本機筆記）。

Never commit（禁止提交）

`local/` 實際內容、session archive（對話封存）、runtime logs（執行紀錄）、credentials（憑證）與未審查 memory（記憶）。

Allowed examples（允許範例）

`templates/*.example.md`、governance docs（治理文件）、public rationale（公開理由）與 scrubbed exports（清理後匯出）。

Review rule（審查規則）

每次 PR（合併請求）都要能回答：這是 policy（政策）還是 private runtime state（私密執行狀態）？