diff --git a/src/browser.js b/src/browser.js
index 2b820d9..f3210c5 100644
--- a/src/browser.js
+++ b/src/browser.js
@@ -366,7 +366,7 @@ async function findOrCreateGeminiPage(browser) {
  *
  * @param {object} [opts]
  * @param {string} [opts.executablePath] - 浏览器路径（不传则自动检测）
- * @param {number} [opts.port] - 调试端口（env: BROWSER_DEBUG_PORT，默认 9222）
+ * @param {number} [opts.port] - 调试端口（env: BROWSER_DEBUG_PORT，默认 9223）
  * @param {string} [opts.userDataDir] - 用户数据目录（env: BROWSER_USER_DATA_DIR，不传则多级兜底）
  * @param {boolean} [opts.headless] - 无头模式（env: BROWSER_HEADLESS，默认 false）
  * @param {object} [opts.debugOpts] - 调试/信号控制选项（透传给 Puppeteer launch）
diff --git a/src/config.js b/src/config.js
index c7dd473..1c6a511 100644
--- a/src/config.js
+++ b/src/config.js
@@ -104,8 +104,17 @@ const config = {
   /** 浏览器可执行文件路径，支持 Chrome / Edge / Chromium（不设则自动检测） */
   browserPath: envStr('BROWSER_PATH', undefined),
 
-  /** CDP 远程调试端口 */
-  browserDebugPort: envInt('BROWSER_DEBUG_PORT', 9222),
+  /**
+   * CDP 远程调试端口
+   *
+   * Chromium 社区通用默认值是 9222，这里用 9223（= 9222 + 1）作为 WJZ_P 的项目专属端口。
+   * 使用独立端口的原因：
+   *   1. 不信任其他浏览器实例的反爬措施，自己启动并控制的浏览器反爬最保险。
+   *   2. 避免与用户手动启动的调试浏览器或其他工具（如 OpenClaw 默认 9222）的端口冲突。
+   *
+   * 注意：9223 是 WJZ_P 所有项目统一约定的 CDP 端口，不仅限于本项目。
+   */
+  browserDebugPort: envInt('BROWSER_DEBUG_PORT', 9223),
 
   /** 浏览器用户数据目录（不设则自动解析，见 browser.js resolveUserDataDir） */
   browserUserDataDir: envStr('BROWSER_USER_DATA_DIR', undefined),
diff --git a/src/demo.js b/src/demo.js
index 566ccec..819bcf3 100644
--- a/src/demo.js
+++ b/src/demo.js
@@ -4,8 +4,8 @@
  * 两种启动方式：
  *
  * 方式 1（推荐）：先手动启动浏览器，再运行 demo
- *   chrome --remote-debugging-port=9222 --user-data-dir="~/.gemini-skill/browser-data"
- *   （也可以用 Edge：msedge --remote-debugging-port=9222 --user-data-dir=...）
+ *   chrome --remote-debugging-port=9223 --user-data-dir="~/.gemini-skill/browser-data"
+ *   （也可以用 Edge：msedge --remote-debugging-port=9223 --user-data-dir=...）
  *   node src/demo.js
  *
  * 方式 2：让 skill 自动检测并启动浏览器
diff --git a/src/index.js b/src/index.js
index 86f6b2c..286e7fb 100644
--- a/src/index.js
+++ b/src/index.js
@@ -27,7 +27,7 @@ export { disconnect, close };
  *
  * @param {object} [opts]
  * @param {string} [opts.executablePath] - 浏览器路径（env: BROWSER_PATH，不设则自动检测）
- * @param {number} [opts.port] - 调试端口（env: BROWSER_DEBUG_PORT，默认 9222）
+ * @param {number} [opts.port] - 调试端口（env: BROWSER_DEBUG_PORT，默认 9223）
  * @param {string} [opts.userDataDir] - 用户数据目录（env: BROWSER_USER_DATA_DIR）
  * @param {boolean} [opts.headless] - 无头模式（env: BROWSER_HEADLESS，默认 false）
  * @param {object} [opts.debugOpts] - 调试/信号控制选项（透传给 Puppeteer launch）