安装 PD

步骤 1 · 前置条件

• Node.js ≥ 18 — nodejs.org
• OpenClaw — OpenClaw 官方安装（仅 OpenClaw 宿主需要；Codex 宿主可用 --host codex 跳过）

步骤 2 · 一键安装

一次安装三个组件：

• 运行时钩子 — 在 AI 助手运行时捕捉痛苦信号、注入已批准的原则
• pd CLI — 命令行工具：健康检查、诊断、启动控制台
• 审核控制台（pd-console）— 浏览器审核界面，观察与审批原则

--yes 跳过 npx 安装确认提示；Installer 自动检测 Node 与 OpenClaw，缺失时给出官方下载链接。

步骤 3 · 注册 PD 网关（OpenClaw 宿主）

安装完成后，在 OpenClaw 中注册 PD 网关。--force 用于首次注册或覆盖旧版本。注册成功后 PD 钩子即生效。Codex 宿主跳过此步。

步骤 4 · 安装完成后 · 启动审核控制台

审核控制台随安装一并装入，无需单独安装。Installer 会首次自动启动并打开浏览器到 /welcome 页面。之后随时用命令行重新打开：

默认绑定本机 127.0.0.1:3100，仅本机可访问；端口被占用时会自动尝试下一个本地端口。想确认安装是否健康，运行：

输出 healthy 表示链路可用；degraded 表示存在非致命问题（如新装还没跑过任务、队列有阻塞、有孤儿候选等），控制面板仍可正常使用，按输出里的 summary / recommendedNextActions 处理即可。

桌面端 PD Companion（Windows）

想省去终端操作？PD Companion 把控制台变成常驻桌面应用：独立窗口 + 系统托盘 + 审批/更新实时通知，双击即用。

前提：已按上面的步骤安装 PD（Companion 是已装 PD 的增强入口，不替代安装）。

前往下载页下载 Companion →

v1 安装包未签名，如遇蓝色 SmartScreen 提示：更多信息 → 仍要运行。

Codex 宿主（CLI / 桌面端）

需要 Codex CLI ≥ 0.147 与 Node ≥ 20。安装插件后，在 Codex 会话中运行 $pd-setup 初始化工作区，并通过 /hooks 信任 PD 钩子。$pd-review 打开审核控制台，$pd-disable 一键停用。