@lansenger-pm/openclaw-lansenger-channel 3.3.0 → 3.4.0

package/README.fr.md

@@ -35,45 +35,36 @@ Connecte OpenClaw à Lansenger — une plateforme de messagerie d'entreprise —
 
 ## Outils de l'agent & CLI
 
-**La CLI est la méthode PRINCIPALE** — elle fonctionne toujours via bash. Les outils agent sont un REPLI — ils peuvent ne pas s'injecter correctement dans certaines versions de la passerelle.
+Les outils agent sont **intégrés dans ce plugin** — ils sont toujours disponibles lorsque le canal est configuré et en cours d'exécution. La CLI est une alternative optionnelle via bash.
 
-Les messages peuvent être envoyés via les **commandes CLI** (principal) ou les **outils agent** (repli) :
+Les messages peuvent être envoyés via les **outils agent** (intégrés) ou les **commandes CLI** (alternative optionnelle) :
 
 | Méthode | Installation | Utilisation |
 |---------|-------------|-------------|
-| **Commandes CLI** (principal) | `pipx install lansenger-cli` (`pip install lansenger-cli` comme alternative) | `lansenger message send-file`, `lansenger message send-text`, etc. |
-| Outils agent (repli) | `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools` | `lansenger_send_file`, `lansenger_send_text`, etc. |
+| **Outils agent** (intégrés) | Inclus dans `@lansenger-pm/openclaw-lansenger-channel` | `lansenger_send_file`, `lansenger_send_text`, etc. |
+| Commandes CLI (optionnel) | `pipx install lansenger-cli` (`pip install lansenger-cli` comme alternative) | `lansenger message send-file`, `lansenger message send-text`, etc. |
 
-> ⚠️ **Les outils agent nécessitent le plugin `lansenger-tools` ET une injection réussie de la passerelle** — si les outils ne sont pas disponibles, utilisez la CLI comme repli. Les commandes CLI nécessitent `lansenger-cli` (Python). Sans aucun des deux, seules les réponses Markdown normales fonctionnent.
+> **Les outils agent sont toujours disponibles** lorsque le canal est configuré et la passerelle en cours d'exécution — aucun plugin séparé nécessaire. Les commandes CLI sont une alternative optionnelle pour les environnements où l'accès bash est préféré ; elles nécessitent `lansenger-cli` (Python).
 
 ## Installation et Configuration
 
 ### Installation recommandée
 
 ```bash
-# 1. Installer le plugin de canal
+# 1. Installer le plugin de canal (inclut les outils agent)
 openclaw plugins install @lansenger-pm/openclaw-lansenger-channel
 
-# 2. Installer le CLI OU le plugin outils (au moins un est nécessaire pour les messages)
-#    Option A : CLI Python (principal — fonctionne toujours via bash)
-pipx install lansenger-cli   # ou : pip install lansenger-cli
-#    Option B : Plugin outils agent OpenClaw (repli — nécessite injection passerelle)
-openclaw plugins install @lansenger-pm/openclaw-lansenger-tools
-
-# 3. Activer les plugins (si non auto-activés)
+# 2. Activer le plugin (si non auto-activé)
 openclaw config set plugins.entries.lansenger.enabled true
-openclaw config set plugins.entries.lansenger-tools.enabled true  # si Option B
 
-# 4. Configurer le canal (assistant interactif)
+# 3. Configurer le canal (assistant interactif)
 openclaw channels add
 
-# 5. Redémarrer la passerelle
+# 4. Redémarrer la passerelle
 openclaw gateway restart
 ```
 
-> **Note** : Les outils agent (Option B) peuvent ne pas s'injecter correctement dans certaines versions de la passerelle — vérifiez toujours que les outils `lansenger_send_*` apparaissent dans la liste des outils de l'agent. Si les outils sont absents, utilisez la CLI (Option A).
-
-Les `peerDependencies` de `package.json` avertiront lors de npm install si le plugin tools est absent. L'assistant de configuration vous rappelle également de l'installer.
+> **Optionnel** : Installer `lansenger-cli` pour une alternative CLI : `pipx install lansenger-cli`.
 
 > **Passerelle personnalisée** : pour les déploiements entreprise (ex. 奇安信), configurez `apiGatewayUrl` dans `openclaw.json` ou via les variables d'environnement après la configuration — voir [Configuration optionnelle](#configuration-optionnelle).
 
@@ -340,6 +331,7 @@ openclaw-lansenger-channel/
 │   ├── client.ts       # Client API Lansenger (WS, HTTP, médias)
 │   ├── channel.ts      # Plugin de canal OpenClaw
 │   ├── channel.test.ts # Tests du plugin de canal
+│   ├── tools.ts        # Définitions des outils agent (10 outils intégrés)
 │   └── runtime.ts      # Runtime passerelle (méthodes, handler entrant)
 ├── skills/
 │   └── lansenger-messaging/
@@ -379,6 +371,7 @@ Les mises à jour de statut d'approbation utilisent le format DynamicMsg appCard
 
 ## Journal des modifications
 
+- **v3.3.0** — Fusion du plugin tools dans le plugin canal ; outils agent désormais intégrés (pas d'installation séparée) ; suppression des peerDependencies sur `@lansenger-pm/openclaw-lansenger-tools`
 - **v3.2.10** — Alerte au démarrage si `group:plugins` absent de l'allowlist ; `configWrites` dans le schema de config canal ; plugin compagnon via `globalThis.__lansenger_channel`
 - **v3.1** — Wizard multi-compte ; alignement dmPolicy (dmSecurity→dmPolicy + paired→pairing) ; prompts bilingues ; shouldPrompt skip steps configurés ; migration config multi-compte
 - **v3.0** — Ajout `lansenger_send_format_text` (Markdown + @mention) ; réécriture SKILL.md ; correction headStatusInfo description+colour

package/README.md

@@ -33,16 +33,16 @@ Lansenger (蓝信) channel plugin for OpenClaw — WebSocket inbound, HTTP API o
 
 ## Agent Tools & CLI
 
-**CLI is the PRIMARY method** — it always works via bash. Agent tools are a FALLBACK — they may not inject properly in some Gateway versions.
+Agent tools are **built into this plugin** — they are always available when the channel is configured and running. CLI is an optional alternative that works via bash.
 
-Messages can be sent via **CLI commands** (primary) or **agent tools** (fallback):
+Messages can be sent via **agent tools** (built-in) or **CLI commands** (optional alternative):
 
 | Method | How to install | Usage |
 |--------|---------------|-------|
-| **CLI commands** (primary) | `pipx install lansenger-cli` (`pip install lansenger-cli` as alternative) | `lansenger message send-file`, `lansenger message send-text`, etc. |
-| Agent tools (fallback) | `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools` | `lansenger_send_file`, `lansenger_send_text`, etc. |
+| **Agent tools** (built-in) | Included in `@lansenger-pm/openclaw-lansenger-channel` | `lansenger_send_file`, `lansenger_send_text`, etc. |
+| CLI commands (optional) | `pipx install lansenger-cli` (`pip install lansenger-cli` as alternative) | `lansenger message send-file`, `lansenger message send-text`, etc. |
 
-> ⚠️ **Agent tools require the `lansenger-tools` plugin AND successful Gateway injection** — if tools are not available, use CLI as fallback. CLI commands require `lansenger-cli` (Python). Without either, only normal Markdown replies work.
+> **Agent tools are always available** when the channel is configured and the gateway is running — no separate plugin needed. CLI commands are an optional alternative for environments where bash access is preferred; they require `lansenger-cli` (Python).
 
 | Tool | Description |
 |------|-------------|
@@ -63,29 +63,20 @@ Tools are also available via CLI: `lansenger message send-text`, `lansenger mess
 ### Recommended setup
 
 ```bash
-# 1. Install the channel plugin
+# 1. Install the channel plugin (includes agent tools)
 openclaw plugins install @lansenger-pm/openclaw-lansenger-channel
 
-# 2. Install the CLI OR the tools plugin (at least one is needed for messaging)
-#    Option A: Python CLI (primary — always works via bash)
-pipx install lansenger-cli   # or: pip install lansenger-cli
-#    Option B: OpenClaw agent tools plugin (fallback — requires Gateway injection)
-openclaw plugins install @lansenger-pm/openclaw-lansenger-tools
-
-# 3. Enable the plugins (if not auto-enabled)
+# 2. Enable the plugin (if not auto-enabled)
 openclaw config set plugins.entries.lansenger.enabled true
-openclaw config set plugins.entries.lansenger-tools.enabled true  # if using Option B
 
-# 4. Configure the channel (interactive wizard)
+# 3. Configure the channel (interactive wizard)
 openclaw channels add
 
-# 5. Restart the gateway
+# 4. Restart the gateway
 openclaw gateway restart
 ```
 
-> **Note**: Agent tools (Option B) may not inject properly in some Gateway versions — always verify by checking if `lansenger_send_*` tools appear in the agent's tool list. If tools are missing, use CLI (Option A) instead.
-
-The `package.json` `peerDependencies` will warn during npm install if the tools plugin is missing. The setup wizard also reminds you to install it.
+> **Optional**: Install `lansenger-cli` for an alternative CLI-based messaging path: `pipx install lansenger-cli`.
 
 > **Custom gateway**: For enterprise deployments (e.g. 奇安信), set `apiGatewayUrl` in `openclaw.json` or environment after configuration — see [Optional Configuration](#optional-configuration).
 
@@ -315,7 +306,7 @@ The plugin supports approval workflow cards:
 - **reminder** — optional in formatText; recommended in group chat. Include "@姓名" in text when mentioning.
 - **Media** — `<media>` tags work for workspace files; for external paths use `lansenger_send_file`.
 - **openclaw skill/message lansenger** — these CLI commands do NOT exist; use agent tools instead.
-- **Agent tools** — agent tools (`lansenger_send_*`) require the tools plugin AND successful Gateway injection — if tools are not available, use CLI as fallback. CLI commands (`lansenger message send-*`) require `pipx install lansenger-cli`.
+- **Agent tools** — agent tools (`lansenger_send_*`) are built into the channel plugin — always available when the channel is configured and running. CLI commands (`lansenger message send-*`) require `pipx install lansenger-cli` and are an optional alternative.
 
 ## Development
 
@@ -346,6 +337,7 @@ openclaw-lansenger-channel/
 │   ├── client.ts       # Lansenger API client (WS, HTTP, media)
 │   ├── channel.ts      # OpenClaw channel plugin
 │   ├── channel.test.ts # Channel plugin tests
+│   ├── tools.ts        # Agent tool definitions (10 built-in tools)
 │   └── runtime.ts      # Gateway runtime (methods, inbound handler)
 ├── skills/
 │   └── lansenger-messaging/
@@ -385,6 +377,7 @@ Approval status updates use the DynamicMsg appCard format. The `updateCardStatus
 
 ## Changelog
 
+- **v3.3.0** — Merge tools plugin into channel plugin; agent tools now built-in (no separate install); remove peerDependencies on `@lansenger-pm/openclaw-lansenger-tools`
 - **v3.2.10** — Startup warning for missing `group:plugins` in tool allowlist; `configWrites` in channel config schema; companion plugin cross-runtime state via `globalThis.__lansenger_channel`
 - **v3.1** — Multi-account setup wizard; dmPolicy/dmSecurity→dmPolicy+pairing (OpenClaw standard); bilingual prompts; credential shouldPrompt skips configured steps; clean multi-account config migration
 - **v3.0** — Add `lansenger_send_format_text` tool (Markdown + @mention); rewrite SKILL.md; fix headStatusInfo description+colour semantics

package/README.zhHans.md

@@ -35,16 +35,16 @@
 
 ## 代理工具 & CLI
 
-**CLI 是主要方式** — 始终通过 bash 调用即可使用。代理工具为备选方式 — 在某些网关版本中可能无法正确注入。
+代理工具**已内置于此插件** — 频道配置并运行时始终可用。CLI 为可选替代方案，通过 bash 调用。
 
-消息可以通过**CLI 命令**（主要）或**代理工具**（备选）发送：
+消息可以通过**代理工具**（内置）或**CLI 命令**（可选替代）发送：
 
 | 方式 | 安装方法 | 使用 |
 |------|----------|------|
-| **CLI 命令**（主要） | `pipx install lansenger-cli`（`pip install lansenger-cli` 为替代） | `lansenger message send-file`、`lansenger message send-text` 等 |
-| 代理工具（备选） | `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools` | `lansenger_send_file`、`lansenger_send_text` 等 |
+| **代理工具**（内置） | 已包含在 `@lansenger-pm/openclaw-lansenger-channel` | `lansenger_send_file`、`lansenger_send_text` 等 |
+| CLI 命令（可选） | `pipx install lansenger-cli`（`pip install lansenger-cli` 为替代） | `lansenger message send-file`、`lansenger message send-text` 等 |
 
-> ⚠️ **代理工具需要 `lansenger-tools` 插件且网关注入成功** — 若工具不可用，请使用 CLI 作为备选。CLI 命令需要 `lansenger-cli`（Python）。两者均未安装时，代理只能通过普通 Markdown 文本回复。
+> **代理工具始终可用** — 频道配置且网关运行时即可使用，无需单独安装插件。CLI 命令为可选替代方案，适合偏好 bash 调用的场景；需安装 `lansenger-cli`（Python）。
 
 | 工具 | 说明 |
 |------|------|
@@ -65,29 +65,20 @@
 ### 推荐安装流程
 
 ```bash
-# 1. 安装频道插件
+# 1. 安装频道插件（包含代理工具）
 openclaw plugins install @lansenger-pm/openclaw-lansenger-channel
 
-# 2. 安装 CLI 或工具插件（至少需要一个来发送消息）
-#    方案 A：Python CLI（主要 — 始终可通过 bash 调用）
-pipx install lansenger-cli   # 或：pip install lansenger-cli
-#    方案 B：OpenClaw 代理工具插件（备选 — 需网关注入）
-openclaw plugins install @lansenger-pm/openclaw-lansenger-tools
-
-# 3. 启用插件（如未自动启用）
+# 2. 启用插件（如未自动启用）
 openclaw config set plugins.entries.lansenger.enabled true
-openclaw config set plugins.entries.lansenger-tools.enabled true  # 使用方案 B 时
 
-# 4. 配置频道（交互式向导）
+# 3. 配置频道（交互式向导）
 openclaw channels add
 
-# 5. 重启网关
+# 4. 重启网关
 openclaw gateway restart
 ```
 
-> **注意**：代理工具（方案 B）在某些网关版本中可能无法正确注入 — 请务必检查代理工具列表中是否出现 `lansenger_send_*` 工具。若工具缺失，请使用 CLI（方案 A）。
-
-`package.json` 的 `peerDependencies` 在 npm install 时会警告缺失 tools 插件。设置向导也会提醒安装。
+> **可选**：安装 `lansenger-cli` 作为 CLI 替代方案：`pipx install lansenger-cli`。
 
 > **自定义网关**：企业私有化部署（如奇安信）需在配置后通过 `openclaw.json` 或环境变量设置 `apiGatewayUrl` — 见[可选配置](#可选配置)。
 
@@ -354,6 +345,7 @@ openclaw-lansenger-channel/
 │   ├── client.ts       # 蓝信 API 客户端（WS、HTTP、媒体）
 │   ├── channel.ts      # OpenClaw 频道插件
 │   ├── channel.test.ts # 频道插件测试
+│   ├── tools.ts        # 代理工具定义（10 个内置工具）
 │   └── runtime.ts      # 网关运行时（方法、入站处理器）
 ├── skills/
 │   └── lansenger-messaging/
@@ -393,7 +385,7 @@ Agent 路由由 OpenClaw 的 `bindings[]` 配置管理——见[多 Agent 路由
 
 ## 更新日志
 
-- **v3.2.10** — 启动时检测 `group:plugins` 缺失警告；`configWrites` 加入频道配置 schema；伴生插件通过 `globalThis.__lansenger_channel` 共享运行时状态
+- **v3.3.0** — 合并 tools 插件至频道插件；代理工具现已内置（无需单独安装）；移除 `@lansenger-pm/openclaw-lansenger-tools` 的 peerDependencies
 - **v3.1** — 多账号设置向导；dmPolicy 对齐 OpenClaw 标准（dmSecurity→dmPolicy + paired→pairing）；中英双语提示文案；凭证 shouldPrompt 跳过已配置步骤；多账号配置迁移清理
 - **v3.0** — 新增 `lansenger_send_format_text` 工具（Markdown + @提及）；重写 SKILL.md；修正 headStatusInfo description+colour 语义
 - **v2.10** — appCard font-size px→pt 自动转换；sendImageUrl 错误分类；工具注册日志

package/README.zhHant.md

@@ -35,45 +35,36 @@
 
 ## 代理工具 & CLI
 
-**CLI 是主要方式** — 始終透過 bash 呼叫即可使用。代理工具為備選方式 — 在某些閘道版本中可能無法正確注入。
+代理工具**已內建於此插件** — 頻道設定並執行時始終可用。CLI 為可選替代方案，透過 bash 呼叫。
 
-訊息可以透過**CLI 命令**（主要）或**代理工具**（備選）傳送：
+訊息可以透過**代理工具**（內建）或**CLI 命令**（可選替代）傳送：
 
 | 方式 | 安裝方法 | 使用 |
 |------|----------|------|
-| **CLI 命令**（主要） | `pipx install lansenger-cli`（`pip install lansenger-cli` 為替代） | `lansenger message send-file`、`lansenger message send-text` 等 |
-| 代理工具（備選） | `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools` | `lansenger_send_file`、`lansenger_send_text` 等 |
+| **代理工具**（內建） | 已包含在 `@lansenger-pm/openclaw-lansenger-channel` | `lansenger_send_file`、`lansenger_send_text` 等 |
+| CLI 命令（可選） | `pipx install lansenger-cli`（`pip install lansenger-cli` 為替代） | `lansenger message send-file`、`lansenger message send-text` 等 |
 
-> ⚠️ **代理工具需要 `lansenger-tools` 插件且閘道注入成功** — 若工具不可用，請使用 CLI 作為備選。CLI 命令需要 `lansenger-cli`（Python）。兩者均未安裝時，代理只能透過普通 Markdown 文字回覆。
+> **代理工具始終可用** — 頻道設定且閘道執行時即可使用，無需單獨安裝插件。CLI 命令為可選替代方案，適合偏好 bash 呼叫的場景；需安裝 `lansenger-cli`（Python）。
 
 ## 安裝與設定
 
 ### 建議安裝流程
 
 ```bash
-# 1. 安裝頻道插件
+# 1. 安裝頻道插件（包含代理工具）
 openclaw plugins install @lansenger-pm/openclaw-lansenger-channel
 
-# 2. 安裝 CLI 或工具插件（至少需要一個來傳送訊息）
-#    方案 A：Python CLI（主要 — 始終可透過 bash 呼叫）
-pipx install lansenger-cli   # 或：pip install lansenger-cli
-#    方案 B：OpenClaw 代理工具插件（備選 — 需閘道注入）
-openclaw plugins install @lansenger-pm/openclaw-lansenger-tools
-
-# 3. 啟用插件（如未自動啟用）
+# 2. 啟用插件（如未自動啟用）
 openclaw config set plugins.entries.lansenger.enabled true
-openclaw config set plugins.entries.lansenger-tools.enabled true  # 使用方案 B 時
 
-# 4. 配置頻道（互動式精靈）
+# 3. 配置頻道（互動式精靈）
 openclaw channels add
 
-# 5. 重啟閘道
+# 4. 重啟閘道
 openclaw gateway restart
 ```
 
-> **注意**：代理工具（方案 B）在某些閘道版本中可能無法正確注入 — 請務必檢查代理工具列表中是否出現 `lansenger_send_*` 工具。若工具缺失，請使用 CLI（方案 A）。
-
-`package.json` 的 `peerDependencies` 在 npm install 時會警告缺少 tools 插件。設定精靈也會提醒安裝。
+> **可選**：安裝 `lansenger-cli` 作為 CLI 替代方案：`pipx install lansenger-cli`。
 
 > **自訂閘道**：企業私有化部署（如奇安信）需在設定後透過 `openclaw.json` 或環境變數設定 `apiGatewayUrl` — 見[可選設定](#可選設定)。
 
@@ -338,8 +329,9 @@ npx tsc --noEmit
 openclaw-lansenger-channel/
 ├── src/
 │   ├── client.ts       # 藍信 API 客戶端（WS、HTTP、媒體）
-│   ├── channel.ts      # OpenClaw 頻道插件
-│   ├── channel.test.ts # 頻道插件測試
+│   ├── channel.ts      # OpenClaw 频道插件
+│   ├── channel.test.ts # 频道插件測試
+│   ├── tools.ts        # 代理工具定義（10 個內建工具）
 │   └── runtime.ts      # 閘道運行時（方法、入站處理器）
 ├── skills/
 │   └── lansenger-messaging/
@@ -379,7 +371,7 @@ Agent 路由由 OpenClaw 的 `bindings[]` 設定管理——見[多 Agent 路由
 
 ## 更新日誌
 
-- **v3.2.10** — 啟動時檢測 `group:plugins` 缺失警告；`configWrites` 加入頻道配置 schema；伴生插件透過 `globalThis.__lansenger_channel` 共享運行時狀態
+- **v3.3.0** — 合併 tools 插件至頻道插件；代理工具現已內建（無需單獨安裝）；移除 `@lansenger-pm/openclaw-lansenger-tools` 的 peerDependencies
 - **v3.1** — 多帳號設定精靈；dmPolicy 對齊 OpenClaw 標準（dmSecurity→dmPolicy + paired→pairing）；中英雙語提示文案；憑證 shouldPrompt 跳過已設定步驟；多帳號設定遷移清理
 - **v3.0** — 新增 `lansenger_send_format_text` 工具（Markdown + @提及）；重寫 SKILL.md；修正 headStatusInfo description+colour 語義
 - **v2.10** — appCard font-size px→pt 自動轉換；sendImageUrl 錯誤分類；工具註冊日誌

package/README.zhHantHK.md

@@ -35,45 +35,36 @@
 
 ## 代理工具 & CLI
 
-**CLI 是主要方式** — 始終透過 bash 呼叫即可使用。代理工具為備選方式 — 在某些網關版本中可能無法正確注入。
+代理工具**已內建於此插件** — 頻道設定並執行時始終可用。CLI 為可選替代方案，透過 bash 呼叫。
 
-訊息可以透過**CLI 命令**（主要）或**代理工具**（備選）發送：
+訊息可以透過**代理工具**（內建）或**CLI 命令**（可選替代）發送：
 
 | 方式 | 安裝方法 | 使用 |
 |------|----------|------|
-| **CLI 命令**（主要） | `pipx install lansenger-cli`（`pip install lansenger-cli` 為替代） | `lansenger message send-file`、`lansenger message send-text` 等 |
-| 代理工具（備選） | `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools` | `lansenger_send_file`、`lansenger_send_text` 等 |
+| **代理工具**（內建） | 已包含在 `@lansenger-pm/openclaw-lansenger-channel` | `lansenger_send_file`、`lansenger_send_text` 等 |
+| CLI 命令（可選） | `pipx install lansenger-cli`（`pip install lansenger-cli` 為替代） | `lansenger message send-file`、`lansenger message send-text` 等 |
 
-> ⚠️ **代理工具需要 `lansenger-tools` 插件且網關注入成功** — 若工具不可用，請使用 CLI 作為備選。CLI 命令需要 `lansenger-cli`（Python）。兩者均未安裝時，代理只能透過普通 Markdown 文字回覆。
+> **代理工具始終可用** — 頻道設定且網關執行時即可使用，無需單獨安裝插件。CLI 命令為可選替代方案，適合偏好 bash 呼叫的場景；需安裝 `lansenger-cli`（Python）。
 
 ## 安裝與設定
 
 ### 建議安裝流程
 
 ```bash
-# 1. 安裝頻道插件
+# 1. 安裝頻道插件（包含代理工具）
 openclaw plugins install @lansenger-pm/openclaw-lansenger-channel
 
-# 2. 安裝 CLI 或工具插件（至少需要一個來發送訊息）
-#    方案 A：Python CLI（主要 — 始終可透過 bash 呼叫）
-pipx install lansenger-cli   # 或：pip install lansenger-cli
-#    方案 B：OpenClaw 代理工具插件（備選 — 需網關注入）
-openclaw plugins install @lansenger-pm/openclaw-lansenger-tools
-
-# 3. 啟用插件（如未自動啟用）
+# 2. 啟用插件（如未自動啟用）
 openclaw config set plugins.entries.lansenger.enabled true
-openclaw config set plugins.entries.lansenger-tools.enabled true  # 使用方案 B 時
 
-# 4. 配置頻道（互動式精靈）
+# 3. 配置頻道（互動式精靈）
 openclaw channels add
 
-# 5. 重啟網關
+# 4. 重啟網關
 openclaw gateway restart
 ```
 
-> **注意**：代理工具（方案 B）在某些網關版本中可能無法正確注入 — 請務必檢查代理工具列表中是否出現 `lansenger_send_*` 工具。若工具缺失，請使用 CLI（方案 A）。
-
-`package.json` 的 `peerDependencies` 在 npm install 時會警告缺少 tools 插件。設定精靈也會提醒安裝。
+> **可選**：安裝 `lansenger-cli` 作為 CLI 替代方案：`pipx install lansenger-cli`。
 
 > **自訂閘道**：企業私有化部署（如奇安信）需在設定後透過 `openclaw.json` 或環境變數設定 `apiGatewayUrl` — 見[可選設定](#可選設定)。
 
@@ -340,8 +331,9 @@ npx tsc --noEmit
 openclaw-lansenger-channel/
 ├── src/
 │   ├── client.ts       # 藍信 API 客戶端（WS、HTTP、媒體）
-│   ├── channel.ts      # OpenClaw 頻道插件
-│   ├── channel.test.ts # 頻道插件測試
+│   ├── channel.ts      # OpenClaw 频道插件
+│   ├── channel.test.ts # 频道插件測試
+│   ├── tools.ts        # 代理工具定義（10 個內建工具）
 │   └── runtime.ts      # 網關運行時（方法、入站處理器）
 ├── skills/
 │   └── lansenger-messaging/
@@ -381,7 +373,7 @@ Agent 路由由 OpenClaw 的 `bindings[]` 設定管理——見[多 Agent 路由
 
 ## 更新日誌
 
-- **v3.2.10** — 啟動時檢測 `group:plugins` 缺失警告；`configWrites` 加入頻道配置 schema；伴生插件透過 `globalThis.__lansenger_channel` 共享運行時狀態
+- **v3.3.0** — 合併 tools 插件至頻道插件；代理工具現已內建（無需單獨安裝）；移除 `@lansenger-pm/openclaw-lansenger-tools` 的 peerDependencies
 - **v3.1** — 多帳號設定精靈；dmPolicy 對齊 OpenClaw 標準（dmSecurity→dmPolicy + paired→pairing）；中英雙語提示文案；憑證 shouldPrompt 跳過已設定步驟；多帳號設定遷移清理
 - **v3.0** — 新增 `lansenger_send_format_text` 工具（Markdown + @提及）；重寫 SKILL.md；修正 headStatusInfo description+colour 語義
 - **v2.10** — appCard font-size px→pt 自動轉換；sendImageUrl 錯誤分類；工具註冊日誌