@lansenger-pm/openclaw-lansenger-channel 3.4.6 → 3.5.1

package/README.fr.md

@@ -46,6 +46,21 @@ Les messages peuvent être envoyés via les **outils agent** (intégrés) ou les
 
 > **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).
 
+| Outil | Description |
+|-------|-------------|
+| `lansenger_send_text` | Envoyer un message texte brut, pas de Markdown |
+| `lansenger_send_format_text` | Envoyer du texte formaté Markdown avec @mentions optionnelles |
+| `lansenger_send_file` | Envoyer fichier/image/video/voix (workspace ou chemin externe) |
+| `lansenger_send_image_url` | Envoyer une image par URL |
+| `lansenger_send_link_card` | Envoyer une carte de prévisualisation de lien enrichi |
+| `lansenger_send_app_card` | Envoyer une carte interactive/approbation |
+| `lansenger_send_app_articles` | Envoyer une carte multi-articles |
+| `lansenger_update_dynamic_card` | Mettre à jour le statut d'une carte dynamique en place |
+| `lansenger_revoke_message` | Révoquer un message précédemment envoyé |
+| `lansenger_query_groups` | Rechercher les groupes disponibles |
+
+Les outils sont aussi disponibles via CLI : `lansenger message send-text`, `lansenger message send-file`, etc.
+
 ## Installation et Configuration
 
 ### Installation recommandée
@@ -103,7 +118,7 @@ Ajoutez ces variables à `~/.openclaw/.env` ou à votre environnement :
 | `LANSENGER_APP_SECRET` | App Secret du bot personnel | `57E718CA1CAC20F2...` |
 | `LANSENGER_API_GATEWAY_URL` | URL de la passerelle API Lansenger (remplacement) | `https://open.e.lanxin.cn/open/apigw` |
 
-Les identifiants peuvent aussi être fournis via la configuration `openclaw.json` (voir Configuration optionnelle ci-dessous). Les variables d'environnement sont prioritaires si les deux sont définis.
+Les identifiants peuvent aussi être fournis via la configuration `openclaw.json` (voir Configuration optionnelle ci-dessous). Les valeurs de configuration sont prioritaires ; les variables d'environnement sont utilisées comme repli lorsque la configuration n'est pas définie.
 
 ### Obtenir les identifiants
 
@@ -120,7 +135,7 @@ Les identifiants peuvent aussi être fournis via la configuration `openclaw.json
       "appId": "your-appid",
       "appSecret": "your-secret",
       "apiGatewayUrl": "https://open.e.lanxin.cn/open/apigw",
-      "homeChannel": "lansenger",
+      "homeChannel": "2285568-xxx",
       "enabled": true,
       "allowFrom": ["your-appid"],
       "dmPolicy": "pairing",
@@ -141,10 +156,12 @@ Les identifiants peuvent aussi être fournis via la configuration `openclaw.json
 | `appId` | App ID du bot personnel | — |
 | `appSecret` | App Secret du bot personnel | — |
 | `apiGatewayUrl` | URL de la passerelle API | `https://open.e.lanxin.cn/open/apigw` |
-| `homeChannel` | Canal par défaut pour le routage de l'agent | `lansenger` |
-| `enabled` | Activer/désactiver le canal | `true` |
+| `homeChannel` | Chat ID par défaut pour la livraison cron/notification | — |
+| `enabled` | Activer/désactiver le canal (défaut runtime : false sans identifiants) | `true` |
 | `allowFrom` | IDs d'utilisateurs autorisés en DM | `[]` |
 | `dmPolicy` | Politique DM : `pairing`, `allowlist`, `open`, `disabled` | `pairing` |
+| `configWrites` | Autoriser Lansenger à écrire la config en réponse aux événements du canal | `true` |
+| `name` | Nom d'affichage pour ce compte | — |
 | `accounts` | Configuration multi-bot | — |
 | `groupPolicy` | Politique de groupe : `open` (tous les groupes), `allowlist` (groupes autorisés uniquement), `disabled` (messages de groupe désactivés) | `allowlist` |
 | `groupAllowFrom` | IDs de groupes autorisés à déclencher le bot | `[]` |
@@ -252,7 +269,7 @@ Champs de routage :
 
 En mode mono-agent, tous les messages routent vers l'agent par défaut (`main`) automatiquement — pas de bindings nécessaires.
 
-### Politique de groupe
+### Types de messages supportés
 
 | Type | Description | Méthode API | Direction |
 |------|-------------|-------------|-----------|
@@ -301,6 +318,7 @@ Le plugin supporte les cartes d'approbation :
 - **Média** — les balises `<media>` fonctionnent pour les fichiers du workspace ; pour les chemins externes, utilisez `lansenger_send_file`.
 - **openclaw skill/message lansenger** — ces commandes CLI n'existent PAS ; utilisez les outils de l'agent.
 - **Outils agent** — les outils agent (`lansenger_send_*`) nécessitent le plugin outils ET une injection réussie de la passerelle — si les outils ne sont pas disponibles, utilisez la CLI comme repli. Les commandes CLI (`lansenger message send-*`) nécessitent `pipx install lansenger-cli`.
+- **alsoAllow** — les outils agent sont enregistrés par ce plugin de canal mais peuvent être **invisibles** sous un profil d'outils restrictif. Ajoutez `"tools": { "alsoAllow": ["group:plugins"] }` dans `openclaw.json` pour que l'agent puisse voir et utiliser les outils `lansenger_send_*`. Sans cela, les outils peuvent ne pas apparaître silencieusement dans la liste d'outils de l'agent.
 
 ## Développement
 
@@ -330,9 +348,14 @@ openclaw-lansenger-channel/
 ├── src/
 │   ├── client.ts       # Client API Lansenger (WS, HTTP, médias)
 │   ├── channel.ts      # Plugin de canal OpenClaw
-│   ├── channel.test.ts # Tests du plugin de canal
+│   ├── runtime.ts      # Runtime passerelle (méthodes, handler entrant)
 │   ├── tools.ts        # Définitions des outils agent (10 outils intégrés)
-│   └── runtime.ts      # Runtime passerelle (méthodes, handler entrant)
+│   ├── setup-wizard.ts # Assistant de configuration (migration config multi-compte)
+│   ├── channel.test.ts # Tests du plugin de canal
+│   ├── client.test.ts  # Tests du client API
+│   ├── runtime.test.ts # Tests du runtime
+│   ├── tools.test.ts   # Tests des outils
+│   └── setup-wizard.test.ts # Tests de l'assistant de configuration
 ├── skills/
 │   └── lansenger-messaging/
 │       └── SKILL.md    # Stratégie de messagerie (outils + CLI)
@@ -371,20 +394,21 @@ Les mises à jour de statut d'approbation utilisent le format DynamicMsg appCard
 
 ## Journal des modifications
 
+- **v3.5.0** — Correction de la livraison en double des messages (déduplication par tour) ; suppression du suffixe UUID OpenClaw des noms de fichiers ; documentation whitelist MEDIA ; conseil alsoAllow ; corrections d'exactitude README
 - **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
-- **v2.10** — Conversion px→pt appCard ; classification erreurs sendImageUrl ; journalisation outils
-- **v2.9** — Adaptateur statut ; repli env vars ; uiHints chinois ; README nettoyage (5 langues)
-- **v2.8** — Routage multi-agent OpenClaw `bindings[]` ; groupPolicy/groupAllowFrom/groups ; SKILL.md AgentSkills
-- **v2.7** — Enregistrement outils objets simples ; état runtime client/target
-- **v2.6** — Enregistrement inconditionnel ; suppression ghost delete_message
-- **v2.5** — formatText reminder ; AppArticles `summary` ; revoke bot/group uniquement
-- **v2.4** — Correction assemblage message ; corrections appArticles/linkCard
-- **v2.3** — Suppression envoi groupe/privé legacy ; routage via msgTarget
-- **v2.2** — Ajout 9 outils agent
-- **v2.0** — Version initiale
+- **v3.1.0** — Wizard multi-compte ; alignement dmPolicy (dmSecurity→dmPolicy + paired→pairing) ; prompts bilingues ; shouldPrompt skip steps configurés ; migration config multi-compte
+- **v3.0.0** — Ajout `lansenger_send_format_text` (Markdown + @mention) ; réécriture SKILL.md ; correction headStatusInfo description+colour
+- **v2.10.0** — Conversion px→pt appCard ; classification erreurs sendImageUrl ; journalisation outils
+- **v2.9.0** — Adaptateur statut ; repli env vars ; uiHints chinois ; README nettoyage (5 langues)
+- **v2.8.0** — Routage multi-agent OpenClaw `bindings[]` ; groupPolicy/groupAllowFrom/groups ; SKILL.md AgentSkills
+- **v2.7.0** — Enregistrement outils objets simples ; état runtime client/target
+- **v2.6.0** — Enregistrement inconditionnel ; suppression ghost delete_message
+- **v2.5.0** — formatText reminder ; AppArticles `summary` ; revoke bot/group uniquement
+- **v2.4.0** — Correction assemblage message ; corrections appArticles/linkCard
+- **v2.3.0** — Suppression envoi groupe/privé legacy ; routage via msgTarget
+- **v2.2.0** — Ajout 9 outils agent
+- **v2.0.0** — Version initiale
 
 ## Licence
 

package/README.md

@@ -46,7 +46,8 @@ Messages can be sent via **agent tools** (built-in) or **CLI commands** (optiona
 
 | Tool | Description |
 |------|-------------|
-| `lansenger_send_text` | Send text or formatText message (Markdown by default) |
+| `lansenger_send_text` | Send plain text message with optional file attachment and @mentions (NO Markdown) |
+| `lansenger_send_format_text` | Send Markdown-formatted text with optional @mentions |
 | `lansenger_send_file` | Send file/image/video/voice from workspace or external path |
 | `lansenger_send_image_url` | Send image by URL |
 | `lansenger_send_link_card` | Send rich link preview card |
@@ -109,7 +110,7 @@ Add these to `~/.openclaw/.env` or your environment:
 | `LANSENGER_APP_SECRET` | Personal bot App Secret | `57E718CA1CAC20F2...` |
 | `LANSENGER_API_GATEWAY_URL` | Lansenger API Gateway URL override | `https://open.e.lanxin.cn/open/apigw` |
 
-Credentials can also be provided via `openclaw.json` config (see Optional Configuration below). Env vars take precedence when both are set.
+Credentials can also be provided via `openclaw.json` config (see Optional Configuration below). Config values take precedence; env vars are used as fallback when config is unset.
 
 ### Get Credentials
 
@@ -126,7 +127,7 @@ Credentials can also be provided via `openclaw.json` config (see Optional Config
       "appId": "your-appid",
       "appSecret": "your-secret",
       "apiGatewayUrl": "https://open.e.lanxin.cn/open/apigw",
-      "homeChannel": "lansenger",
+      "homeChannel": "2285568-xxx",
       "enabled": true,
       "allowFrom": ["your-appid"],
       "dmPolicy": "pairing",
@@ -147,10 +148,12 @@ Credentials can also be provided via `openclaw.json` config (see Optional Config
 | `appId` | Personal bot App ID | — |
 | `appSecret` | Personal bot App Secret | — |
 | `apiGatewayUrl` | API Gateway URL | `https://open.e.lanxin.cn/open/apigw` |
-| `homeChannel` | Default channel for agent routing | `lansenger` |
-| `enabled` | Enable/disable the channel | `true` |
+| `homeChannel` | Default chat ID for cron/notification delivery | — |
+| `enabled` | Enable/disable the channel (runtime default: false without credentials) | `true` |
 | `allowFrom` | User IDs allowed to DM the bot | `[]` |
 | `dmPolicy` | DM policy: `pairing`, `allowlist`, `open`, `disabled` | `pairing` |
+| `configWrites` | Allow Lansenger to write config in response to channel events | `true` |
+| `name` | Display name for this account | — |
 | `accounts` | Multi-bot configuration | — |
 | `groupPolicy` | Group policy: `open`, `allowlist`, `disabled` | `allowlist` |
 | `groupAllowFrom` | Group IDs allowed to trigger the bot | `[]` |
@@ -258,7 +261,7 @@ Routing fields:
 
 In single-agent mode, all messages route to the default agent (`main`) automatically — no bindings needed.
 
-### Group policy
+### Supported Message Types
 
 | Type | Description | API Method | Direction |
 |------|-------------|------------|-----------|
@@ -307,6 +310,7 @@ The plugin supports approval workflow cards:
 - **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_*`) 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.
+- **alsoAllow** — agent tools are registered by this channel plugin but may be **invisible** under restrictive tool profiles. Add `"tools": { "alsoAllow": ["group:plugins"] }` to `openclaw.json` to ensure the agent can see and use `lansenger_send_*` tools. Without this, tools may silently not appear in the agent's tool list.
 
 ## Development
 
@@ -336,9 +340,14 @@ openclaw-lansenger-channel/
 ├── src/
 │   ├── client.ts       # Lansenger API client (WS, HTTP, media)
 │   ├── channel.ts      # OpenClaw channel plugin
-│   ├── channel.test.ts # Channel plugin tests
+│   ├── runtime.ts      # Gateway runtime (methods, inbound handler)
 │   ├── tools.ts        # Agent tool definitions (10 built-in tools)
-│   └── runtime.ts      # Gateway runtime (methods, inbound handler)
+│   ├── setup-wizard.ts # Setup wizard (multi-account config migration)
+│   ├── channel.test.ts # Channel plugin tests
+│   ├── client.test.ts  # API client tests
+│   ├── runtime.test.ts # Runtime tests
+│   ├── tools.test.ts   # Tool tests
+│   └── setup-wizard.test.ts # Setup wizard tests
 ├── skills/
 │   └── lansenger-messaging/
 │       └── SKILL.md    # Agent messaging strategy (tools + CLI)
@@ -377,20 +386,21 @@ Approval status updates use the DynamicMsg appCard format. The `updateCardStatus
 
 ## Changelog
 
+- **v3.5.0** — Fix duplicate message delivery (per-turn dedup); strip OpenClaw UUID suffix from filenames; MEDIA whitelist docs; alsoAllow tip; README accuracy fixes
 - **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
-- **v2.10** — font-size px→pt auto-conversion; sendImageUrl error classification; tool registration logging
-- **v2.9** — Status adapter; env var fallback; uiHints; README cleanup (5 locales)
-- **v2.8** — OpenClaw `bindings[]` multi-agent routing; groupPolicy/groupAllowFrom/groups access control; SKILL.md AgentSkills spec
-- **v2.7** — Plain-object tool registration; runtime state for client/target
-- **v2.6** — Register tools unconditionally; removed phantom delete_message
-- **v2.5** — formatText reminder; appArticles `summary`; revoke chatType bot/group only
-- **v2.4** — Fix message body assembly; appArticles/linkCard field fixes
-- **v2.3** — Remove legacy group/private send; all routing via msgTarget
-- **v2.2** — Add 9 agent tools
-- **v2.0** — Initial release
+- **v3.1.0** — Multi-account setup wizard; dmPolicy/dmSecurity→dmPolicy+pairing (OpenClaw standard); bilingual prompts; credential shouldPrompt skips configured steps; clean multi-account config migration
+- **v3.0.0** — Add `lansenger_send_format_text` tool (Markdown + @mention); rewrite SKILL.md; fix headStatusInfo description+colour semantics
+- **v2.10.0** — font-size px→pt auto-conversion; sendImageUrl error classification; tool registration logging
+- **v2.9.0** — Status adapter; env var fallback; uiHints; README cleanup (5 locales)
+- **v2.8.0** — OpenClaw `bindings[]` multi-agent routing; groupPolicy/groupAllowFrom/groups access control; SKILL.md AgentSkills spec
+- **v2.7.0** — Plain-object tool registration; runtime state for client/target
+- **v2.6.0** — Register tools unconditionally; removed phantom delete_message
+- **v2.5.0** — formatText reminder; appArticles `summary`; revoke chatType bot/group only
+- **v2.4.0** — Fix message body assembly; appArticles/linkCard field fixes
+- **v2.3.0** — Remove legacy group/private send; all routing via msgTarget
+- **v2.2.0** — Add 9 agent tools
+- **v2.0.0** — Initial release
 
 ## License
 

package/README.zhHans.md

@@ -48,7 +48,8 @@
 
 | 工具 | 说明 |
 |------|------|
-| `lansenger_send_text` | 发送文本或 formatText 消息（默认 Markdown） |
+| `lansenger_send_text` | 发送纯文本消息，不支持 Markdown |
+| `lansenger_send_format_text` | 发送 Markdown 格式文字，支持 @提及 |
 | `lansenger_send_file` | 发送文件/图片/视频/语音（工作区或外部路径） |
 | `lansenger_send_image_url` | 通过 URL 发送图片 |
 | `lansenger_send_link_card` | 发送富链接预览卡片 |
@@ -117,7 +118,7 @@ openclaw pairing approve lansenger <配对码>
 | `LANSENGER_APP_SECRET` | 个人机器人 App Secret | `57E718CA1CAC20F2...` |
 | `LANSENGER_API_GATEWAY_URL` | 蓝信 API 网关 URL 覆盖 | `https://open.e.lanxin.cn/open/apigw` |
 
-凭证也可通过 `openclaw.json` 配置提供（见下方可选配置）。当两者同时设置时，环境变量优先。
+凭证也可通过 `openclaw.json` 配置提供（见下方可选配置）。配置值优先；环境变量仅在配置未设置时作为回退。
 
 ### 获取凭证
 
@@ -134,7 +135,7 @@ openclaw pairing approve lansenger <配对码>
       "appId": "your-appid",
       "appSecret": "your-secret",
       "apiGatewayUrl": "https://open.e.lanxin.cn/open/apigw",
-      "homeChannel": "lansenger",
+      "homeChannel": "2285568-xxx",
       "enabled": true,
       "allowFrom": ["your-appid"],
       "dmPolicy": "pairing",
@@ -155,10 +156,12 @@ openclaw pairing approve lansenger <配对码>
 | `appId` | 个人机器人 App ID | — |
 | `appSecret` | 个人机器人 App Secret | — |
 | `apiGatewayUrl` | API 网关 URL | `https://open.e.lanxin.cn/open/apigw` |
-| `homeChannel` | 代理路由的默认频道 | `lansenger` |
-| `enabled` | 启用/禁用频道 | `true` |
+| `homeChannel` | 定时任务/通知送达的默认聊天 ID | — |
+| `enabled` | 启用/禁用频道（运行时默认：无凭证时为 false） | `true` |
 | `allowFrom` | 允许私聊的用户 ID | `[]` |
 | `dmPolicy` | 私聊策略：`pairing`、`allowlist`、`open`、`disabled` | `pairing` |
+| `configWrites` | 允许蓝信响应频道事件写入配置 | `true` |
+| `name` | 此账户的显示名称 | — |
 | `accounts` | 多机器人配置 | — |
 | `groupPolicy` | 群聊策略：`open`（所有群）、`allowlist`（仅允许列表群）、`disabled`（禁止群消息） | `allowlist` |
 | `groupAllowFrom` | 允许触发机器人的群 ID | `[]` |
@@ -266,7 +269,7 @@ openclaw channels status --probe
 
 单 Agent 模式下，所有消息自动路由到默认 Agent（`main`），无需 bindings 配置。
 
-### 群聊策略
+### 支持的消息类型
 
 | 类型 | 说明 | API 方法 | 方向 |
 |------|------|----------|------|
@@ -315,6 +318,7 @@ openclaw channels status --probe
 - **媒体标签** — `<media>` 标签适用于工作区文件；外部路径请使用 `lansenger_send_file`。
 - **openclaw skill/message lansenger** — 这些 CLI 命令不存在；请使用代理工具。
 - **代理工具** — 代理工具（`lansenger_send_*`）需要工具插件且网关注入成功 — 若工具不可用，请使用 CLI 作为备选。CLI 命令（`lansenger message send-*`）需要 `pipx install lansenger-cli`。
+- **alsoAllow** — 本插件注册了 agent 工具（`lansenger_send_*`），但在严格工具策略下可能**不可见**。需在 `openclaw.json` 中添加 `"tools": { "alsoAllow": ["group:plugins"] }` 以确保 agent 能看到并使用这些工具。否则工具可能静默不出现在 agent 工具列表中。
 
 ## 开发
 
@@ -344,9 +348,14 @@ openclaw-lansenger-channel/
 ├── src/
 │   ├── client.ts       # 蓝信 API 客户端（WS、HTTP、媒体）
 │   ├── channel.ts      # OpenClaw 频道插件
-│   ├── channel.test.ts # 频道插件测试
+│   ├── runtime.ts      # 网关运行时（方法、入站处理器）
 │   ├── tools.ts        # 代理工具定义（10 个内置工具）
-│   └── runtime.ts      # 网关运行时（方法、入站处理器）
+│   ├── setup-wizard.ts # 设置向导（多账号配置迁移）
+│   ├── channel.test.ts # 频道插件测试
+│   ├── client.test.ts  # API 客户端测试
+│   ├── runtime.test.ts # 运行时测试
+│   ├── tools.test.ts   # 工具测试
+│   └── setup-wizard.test.ts # 设置向导测试
 ├── skills/
 │   └── lansenger-messaging/
 │       └── SKILL.md    # 代理消息策略（工具 + CLI）
@@ -385,19 +394,20 @@ Agent 路由由 OpenClaw 的 `bindings[]` 配置管理——见[多 Agent 路由
 
 ## 更新日志
 
+- **v3.5.0** — 修复重复消息送达（每回合去重）；剥离文件名中的 OpenClaw UUID 后缀；MEDIA 白名单文档；alsoAllow 提示；README 准确性修复
 - **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 错误分类；工具注册日志
-- **v2.9** — 状态适配器；环境变量回退；uiHints 中文标签；README 精简（5 语言）
-- **v2.8** — OpenClaw `bindings[]` 多 Agent 路由；groupPolicy/groupAllowFrom/groups 群聊准入；SKILL.md AgentSkills 规范
-- **v2.7** — 纯对象工具注册；运行时状态获取 client/target
-- **v2.6** — 无条件注册工具；移除幽灵 delete_message
-- **v2.5** — formatText reminder；AppArticles `summary`；撤回仅 bot/group
-- **v2.4** — 修复消息体组装；appArticles/linkCard 字段修复
-- **v2.3** — 移除遗留群聊/私聊发送；全部通过 msgTarget 路由
-- **v2.2** — 添加 9 个 agent 工具
-- **v2.0** — 初始发布
+- **v3.1.0** — 多账号设置向导；dmPolicy 对齐 OpenClaw 标准（dmSecurity→dmPolicy + paired→pairing）；中英双语提示文案；凭证 shouldPrompt 跳过已配置步骤；多账号配置迁移清理
+- **v3.0.0** — 新增 `lansenger_send_format_text` 工具（Markdown + @提及）；重写 SKILL.md；修正 headStatusInfo description+colour 语义
+- **v2.10.0** — appCard font-size px→pt 自动转换；sendImageUrl 错误分类；工具注册日志
+- **v2.9.0** — 状态适配器；环境变量回退；uiHints 中文标签；README 精简（5 语言）
+- **v2.8.0** — OpenClaw `bindings[]` 多 Agent 路由；groupPolicy/groupAllowFrom/groups 群聊准入；SKILL.md AgentSkills 规范
+- **v2.7.0** — 纯对象工具注册；运行时状态获取 client/target
+- **v2.6.0** — 无条件注册工具；移除幽灵 delete_message
+- **v2.5.0** — formatText reminder；AppArticles `summary`；撤回仅 bot/group
+- **v2.4.0** — 修复消息体组装；appArticles/linkCard 字段修复
+- **v2.3.0** — 移除遗留群聊/私聊发送；全部通过 msgTarget 路由
+- **v2.2.0** — 添加 9 个 agent 工具
+- **v2.0.0** — 初始发布
 
 ## 许可证
 

package/README.zhHant.md

@@ -46,6 +46,21 @@
 
 > **代理工具始終可用** — 頻道設定且閘道執行時即可使用，無需單獨安裝插件。CLI 命令為可選替代方案，適合偏好 bash 呼叫的場景；需安裝 `lansenger-cli`（Python）。
 
+| 工具 | 說明 |
+|------|------|
+| `lansenger_send_text` | 發送純文字訊息，不支援 Markdown |
+| `lansenger_send_format_text` | 發送 Markdown 格式文字，支援 @提及 |
+| `lansenger_send_file` | 發送檔案/圖片/影片/語音（工作區或外部路徑） |
+| `lansenger_send_image_url` | 透過 URL 發送圖片 |
+| `lansenger_send_link_card` | 發送富連結預覽卡片 |
+| `lansenger_send_app_card` | 發送互動/審批卡片 |
+| `lansenger_send_app_articles` | 發送多文章卡片 |
+| `lansenger_update_dynamic_card` | 原地更新動態卡片狀態 |
+| `lansenger_revoke_message` | 撤回已傳送的訊息 |
+| `lansenger_query_groups` | 查詢可用群組 |
+
+工具也可透過 CLI 使用：`lansenger message send-text`、`lansenger message send-file` 等。
+
 ## 安裝與設定
 
 ### 建議安裝流程
@@ -103,7 +118,7 @@ openclaw pairing approve lansenger <配對碼>
 | `LANSENGER_APP_SECRET` | 個人機器人 App Secret | `57E718CA1CAC20F2...` |
 | `LANSENGER_API_GATEWAY_URL` | 藍信 API 閘道 URL 覆蓋 | `https://open.e.lanxin.cn/open/apigw` |
 
-憑證也可透過 `openclaw.json` 配置提供（見下方可選設定）。當兩者同時設定時，環境變數優先。
+憑證也可透過 `openclaw.json` 配置提供（見下方可選設定）。配置值優先；環境變數僅在配置未設定時作為回退。
 
 ### 取得憑證
 
@@ -120,7 +135,7 @@ openclaw pairing approve lansenger <配對碼>
       "appId": "your-appid",
       "appSecret": "your-secret",
       "apiGatewayUrl": "https://open.e.lanxin.cn/open/apigw",
-      "homeChannel": "lansenger",
+      "homeChannel": "2285568-xxx",
       "enabled": true,
       "allowFrom": ["your-appid"],
       "dmPolicy": "pairing",
@@ -141,10 +156,12 @@ openclaw pairing approve lansenger <配對碼>
 | `appId` | 個人機器人 App ID | — |
 | `appSecret` | 個人機器人 App Secret | — |
 | `apiGatewayUrl` | API 閘道 URL | `https://open.e.lanxin.cn/open/apigw` |
-| `homeChannel` | 代理路由的預設頻道 | `lansenger` |
-| `enabled` | 啟用/禁用頻道 | `true` |
+| `homeChannel` | 定時任務/通知遞送的預設聊天 ID | — |
+| `enabled` | 啟用/禁用頻道（運行時預設：無憑證時為 false） | `true` |
 | `allowFrom` | 允許私聊的使用者 ID | `[]` |
 | `dmPolicy` | 私聊策略：`pairing`、`allowlist`、`open`、`disabled` | `pairing` |
+| `configWrites` | 允許藍信回應頻道事件寫入配置 | `true` |
+| `name` | 此帳戶的顯示名稱 | — |
 | `accounts` | 多機器人設定 | — |
 | `groupPolicy` | 群聊策略：`open`（所有群）、`allowlist`（僅允許列表群）、`disabled`（禁止群訊息） | `allowlist` |
 | `groupAllowFrom` | 允許觸發機器人的群 ID | `[]` |
@@ -252,7 +269,7 @@ openclaw channels status --probe
 
 單 Agent 模式下，所有訊息自動路由至預設 Agent（`main`），無需 bindings 設定。
 
-### 羣聊策略
+### 支持的訊息類型
 
 | 類型 | 說明 | API 方法 | 方向 |
 |------|------|----------|------|
@@ -301,6 +318,7 @@ openclaw channels status --probe
 - **媒體標籤**——`<media>` 標籤適用於工作區檔案；外部路徑請使用 `lansenger_send_file`。
 - **openclaw skill/message lansenger**——這些 CLI 命令不存在；請使用代理工具。
 - **代理工具**——代理工具（`lansenger_send_*`）需要工具插件且閘道注入成功——若工具不可用，請使用 CLI 作為備選。CLI 命令（`lansenger message send-*`）需要 `pipx install lansenger-cli`。
+- **alsoAllow**——本插件註冊了 agent 工具（`lansenger_send_*`），但在嚴格工具策略下可能**不可見**。需在 `openclaw.json` 中新增 `"tools": { "alsoAllow": ["group:plugins"] }` 以確保 agent 能看到並使用這些工具。否則工具可能靜默不出現在 agent 工具列表中。
 
 ## 開發
 
@@ -330,9 +348,14 @@ openclaw-lansenger-channel/
 ├── src/
 │   ├── client.ts       # 藍信 API 客戶端（WS、HTTP、媒體）
 │   ├── channel.ts      # OpenClaw 频道插件
-│   ├── channel.test.ts # 频道插件測試
+│   ├── runtime.ts      # 閘道運行時（方法、入站處理器）
 │   ├── tools.ts        # 代理工具定義（10 個內建工具）
-│   └── runtime.ts      # 閘道運行時（方法、入站處理器）
+│   ├── setup-wizard.ts # 設定精靈（多帳號配置遷移）
+│   ├── channel.test.ts # 频道插件測試
+│   ├── client.test.ts  # API 客戶端測試
+│   ├── runtime.test.ts # 運行時測試
+│   ├── tools.test.ts   # 工具測試
+│   └── setup-wizard.test.ts # 設定精靈測試
 ├── skills/
 │   └── lansenger-messaging/
 │       └── SKILL.md    # 代理訊息策略（工具 + CLI）
@@ -371,19 +394,20 @@ Agent 路由由 OpenClaw 的 `bindings[]` 設定管理——見[多 Agent 路由
 
 ## 更新日誌
 
+- **v3.5.0** — 修正重複訊息遞送（每回合去重）；從檔案名稱中移除 OpenClaw UUID 後綴；MEDIA 白名單文件；alsoAllow 提示；README 准確性修正
 - **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 錯誤分類；工具註冊日誌
-- **v2.9** — 狀態適配器；環境變數回退；uiHints 中文標籤；README 精簡（5 語言）
-- **v2.8** — OpenClaw `bindings[]` 多 Agent 路由；groupPolicy/groupAllowFrom/groups 羣聊准入；SKILL.md AgentSkills 規範
-- **v2.7** — 純物件工具註冊；運行時狀態取得 client/target
-- **v2.6** — 無條件註冊工具；移除幽靈 delete_message
-- **v2.5** — formatText reminder；AppArticles `summary`；撤回僅 bot/group
-- **v2.4** — 修復訊息體組裝；appArticles/linkCard 欄位修復
-- **v2.3** — 移除遺留群組/私聊傳送；全部透過 msgTarget 路由
-- **v2.2** — 新增 9 個 agent 工具
-- **v2.0** — 初始發佈
+- **v3.1.0** — 多帳號設定精靈；dmPolicy 對齊 OpenClaw 標準（dmSecurity→dmPolicy + paired→pairing）；中英雙語提示文案；憑證 shouldPrompt 跳過已設定步驟；多帳號設定遷移清理
+- **v3.0.0** — 新增 `lansenger_send_format_text` 工具（Markdown + @提及）；重寫 SKILL.md；修正 headStatusInfo description+colour 語義
+- **v2.10.0** — appCard font-size px→pt 自動轉換；sendImageUrl 錯誤分類；工具註冊日誌
+- **v2.9.0** — 狀態適配器；環境變數回退；uiHints 中文標籤；README 精簡（5 語言）
+- **v2.8.0** — OpenClaw `bindings[]` 多 Agent 路由；groupPolicy/groupAllowFrom/groups 羣聊准入；SKILL.md AgentSkills 規範
+- **v2.7.0** — 純物件工具註冊；運行時狀態取得 client/target
+- **v2.6.0** — 無條件註冊工具；移除幽靈 delete_message
+- **v2.5.0** — formatText reminder；AppArticles `summary`；撤回僅 bot/group
+- **v2.4.0** — 修復訊息體組裝；appArticles/linkCard 欄位修復
+- **v2.3.0** — 移除遺留群組/私聊傳送；全部透過 msgTarget 路由
+- **v2.2.0** — 新增 9 個 agent 工具
+- **v2.0.0** — 初始發佈
 
 ## 授權條款
 

package/README.zhHantHK.md

@@ -46,6 +46,21 @@
 
 > **代理工具始終可用** — 頻道設定且網關執行時即可使用，無需單獨安裝插件。CLI 命令為可選替代方案，適合偏好 bash 呼叫的場景；需安裝 `lansenger-cli`（Python）。
 
+| 工具 | 說明 |
+|------|------|
+| `lansenger_send_text` | 發送純文字訊息，不支援 Markdown |
+| `lansenger_send_format_text` | 發送 Markdown 格式文字，支援 @提及 |
+| `lansenger_send_file` | 發送檔案/圖片/影片/語音（工作區或外部路徑） |
+| `lansenger_send_image_url` | 透過 URL 發送圖片 |
+| `lansenger_send_link_card` | 發送富連結預覽卡片 |
+| `lansenger_send_app_card` | 發送互動/審批卡片 |
+| `lansenger_send_app_articles` | 發送多文章卡片 |
+| `lansenger_update_dynamic_card` | 原地更新動態卡片狀態 |
+| `lansenger_revoke_message` | 撤回已發送的訊息 |
+| `lansenger_query_groups` | 查詢可用羣組 |
+
+工具也可透過 CLI 使用：`lansenger message send-text`、`lansenger message send-file` 等。
+
 ## 安裝與設定
 
 ### 建議安裝流程
@@ -103,7 +118,7 @@ openclaw pairing approve lansenger <配對碼>
 | `LANSENGER_APP_SECRET` | 個人機械人 App Secret | `57E718CA1CAC20F2...` |
 | `LANSENGER_API_GATEWAY_URL` | 藍信 API 網關 URL 覆蓋 | `https://open.e.lanxin.cn/open/apigw` |
 
-憑證也可透過 `openclaw.json` 配置提供（見下方可選設定）。當兩者同時設定時，環境變數優先。
+憑證也可透過 `openclaw.json` 配置提供（見下方可選設定）。配置值優先；環境變數僅在配置未設定時作為回退。
 
 ### 取得憑證
 
@@ -120,7 +135,7 @@ openclaw pairing approve lansenger <配對碼>
       "appId": "your-appid",
       "appSecret": "your-secret",
       "apiGatewayUrl": "https://open.e.lanxin.cn/open/apigw",
-      "homeChannel": "lansenger",
+      "homeChannel": "2285568-xxx",
       "enabled": true,
       "allowFrom": ["your-appid"],
       "dmPolicy": "pairing",
@@ -141,10 +156,12 @@ openclaw pairing approve lansenger <配對碼>
 | `appId` | 個人機械人 App ID | — |
 | `appSecret` | 個人機械人 App Secret | — |
 | `apiGatewayUrl` | API 網關 URL | `https://open.e.lanxin.cn/open/apigw` |
-| `homeChannel` | 代理路由的預設頻道 | `lansenger` |
-| `enabled` | 啟用/禁用頻道 | `true` |
+| `homeChannel` | 定時任務/通知遞送的預設聊天 ID | — |
+| `enabled` | 啟用/禁用頻道（運行時預設：無憑證時為 false） | `true` |
 | `allowFrom` | 允許私聊的使用者 ID | `[]` |
 | `dmPolicy` | 私聊策略：`pairing`、`allowlist`、`open`、`disabled` | `pairing` |
+| `configWrites` | 允許藍信回應頻道事件寫入配置 | `true` |
+| `name` | 此帳戶的顯示名稱 | — |
 | `accounts` | 多機械人設定 | — |
 | `groupPolicy` | 羣聊策略：`open`（所有羣）、`allowlist`（僅允許列表羣）、`disabled`（禁止羣訊息） | `allowlist` |
 | `groupAllowFrom` | 允許觸發機械人的羣 ID | `[]` |
@@ -254,7 +271,7 @@ openclaw channels status --probe
 
 單 Agent 模式下，所有訊息自動路由至預設 Agent（`main`），無需 bindings 設定。
 
-### 羣聊策略
+### 支持的訊息類型
 
 | 類型 | 說明 | API 方法 | 方向 |
 |------|------|----------|------|
@@ -303,6 +320,7 @@ openclaw channels status --probe
 - **媒體標籤** — `<media>` 標籤適用於工作區檔案；外部路徑請使用 `lansenger_send_file`。
 - **openclaw skill/message lansenger** — 這些 CLI 命令不存在；請使用代理工具。
 - **代理工具** — 代理工具（`lansenger_send_*`）需要工具插件且網關注入成功 — 若工具不可用，請使用 CLI 作為備選。CLI 命令（`lansenger message send-*`）需要 `pipx install lansenger-cli`。
+- **alsoAllow** — 本插件註冊了 agent 工具（`lansenger_send_*`），但在嚴格工具策略下可能**不可見**。需在 `openclaw.json` 中新增 `"tools": { "alsoAllow": ["group:plugins"] }` 以確保 agent 能看到並使用這些工具。否則工具可能靜默不出現在 agent 工具列表中。
 
 ## 開發
 
@@ -332,9 +350,14 @@ openclaw-lansenger-channel/
 ├── src/
 │   ├── client.ts       # 藍信 API 客戶端（WS、HTTP、媒體）
 │   ├── channel.ts      # OpenClaw 频道插件
-│   ├── channel.test.ts # 频道插件測試
+│   ├── runtime.ts      # 網關運行時（方法、入站處理器）
 │   ├── tools.ts        # 代理工具定義（10 個內建工具）
-│   └── runtime.ts      # 網關運行時（方法、入站處理器）
+│   ├── setup-wizard.ts # 設定精靈（多帳號配置遷移）
+│   ├── channel.test.ts # 频道插件測試
+│   ├── client.test.ts  # API 客戶端測試
+│   ├── runtime.test.ts # 運行時測試
+│   ├── tools.test.ts   # 工具測試
+│   └── setup-wizard.test.ts # 設定精靈測試
 ├── skills/
 │   └── lansenger-messaging/
 │       └── SKILL.md    # 代理訊息策略（工具 + CLI）
@@ -373,19 +396,20 @@ Agent 路由由 OpenClaw 的 `bindings[]` 設定管理——見[多 Agent 路由
 
 ## 更新日誌
 
+- **v3.5.0** — 修正重複訊息發送（每回合去重）；從檔案名稱中移除 OpenClaw UUID 後綴；MEDIA 白名單文件；alsoAllow 提示；README 准確性修正
 - **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 錯誤分類；工具註冊日誌
-- **v2.9** — 狀態適配器；環境變數回退；uiHints 中文標籤；README 精簡（5 語言）
-- **v2.8** — OpenClaw `bindings[]` 多 Agent 路由；groupPolicy/groupAllowFrom/groups 羣聊准入；SKILL.md AgentSkills 規範
-- **v2.7** — 純物件工具註冊；運行時狀態取得 client/target
-- **v2.6** — 無條件註冊工具；移除幽靈 delete_message
-- **v2.5** — formatText reminder；AppArticles `summary`；撤回僅 bot/group
-- **v2.4** — 修復訊息體組裝；appArticles/linkCard 欄位修復
-- **v2.3** — 移除遺留羣組/私聊發送；全部透過 msgTarget 路由
-- **v2.2** — 新增 9 個 agent 工具
-- **v2.0** — 初始發佈
+- **v3.1.0** — 多帳號設定精靈；dmPolicy 對齊 OpenClaw 標準（dmSecurity→dmPolicy + paired→pairing）；中英雙語提示文案；憑證 shouldPrompt 跳過已設定步驟；多帳號設定遷移清理
+- **v3.0.0** — 新增 `lansenger_send_format_text` 工具（Markdown + @提及）；重寫 SKILL.md；修正 headStatusInfo description+colour 語義
+- **v2.10.0** — appCard font-size px→pt 自動轉換；sendImageUrl 錯誤分類；工具註冊日誌
+- **v2.9.0** — 狀態適配器；環境變數回退；uiHints 中文標籤；README 精簡（5 語言）
+- **v2.8.0** — OpenClaw `bindings[]` 多 Agent 路由；groupPolicy/groupAllowFrom/groups 羣聊准入；SKILL.md AgentSkills 規範
+- **v2.7.0** — 純物件工具註冊；運行時狀態取得 client/target
+- **v2.6.0** — 無條件註冊工具；移除幽靈 delete_message
+- **v2.5.0** — formatText reminder；AppArticles `summary`；撤回僅 bot/group
+- **v2.4.0** — 修復訊息體組裝；appArticles/linkCard 欄位修復
+- **v2.3.0** — 移除遺留羣組/私聊發送；全部透過 msgTarget 路由
+- **v2.2.0** — 新增 9 個 agent 工具
+- **v2.0.0** — 初始發佈
 
 ## 授權條款
 

package/dist/src/channel.js

@@ -446,8 +446,13 @@ export const lansengerPlugin = {
         buildChannelSummary: ({ snapshot, cfg }) => {
             const hasCfg = (() => {
                 const section = cfg.channels?.["lansenger"];
-                const configured = Boolean(section?.appId && section?.appSecret) || Boolean(process.env.LANSENGER_APP_ID && process.env.LANSENGER_APP_SECRET);
-                return configured;
+                const accounts = section?.accounts;
+                const topLevel = Boolean(section?.appId && section?.appSecret);
+                const fromAccounts = accounts && Object.keys(accounts).length > 0
+                    ? Object.values(accounts).some((a) => Boolean(a?.appId && a?.appSecret))
+                    : false;
+                const fromEnv = Boolean(process.env.LANSENGER_APP_ID && process.env.LANSENGER_APP_SECRET);
+                return topLevel || fromAccounts || fromEnv;
             })();
             const patched = { ...snapshot, configured: snapshot.configured || hasCfg };
             return buildProbeChannelStatusSummary(patched);