@lansenger-pm/openclaw-lansenger-channel 3.16.2 → 3.16.3

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [3.16.3] - 2026-06-22
+
+### Fixed
+
+- **`queryGroups` returns empty `groupIds`**: Default `pageOffset` was `1` but the API `page_offset` starts from `0`. With few groups, the first page was skipped entirely, returning `totalGroupIds > 0` but `groupIds: []`.
+
 ## [3.16.2] - 2026-06-22
 
 ### Added

package/README.fr.md

@@ -359,6 +359,7 @@ Le plugin supporte les cartes d'approbation :
 - **reminder** — champ optionnel dans formatText ; recommandé dans les chats de groupe. Inclure « @姓名 » dans le texte pour les mentions.
 - **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.
+- **Copie automatique de la compétence lansenger-setup** — le plugin copie la compétence `lansenger-setup` dans `~/.openclaw/skills/` au démarrage pour que l'agent puisse aider à configurer Lansenger avant l'activation complète du canal. Ce comportement est intentionnel — ne le supprimez pas manuellement.
 - **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.
 
@@ -388,23 +389,26 @@ npx tsc --noEmit
 ```
 openclaw-lansenger-channel/
 ├── src/
-│   ├── client.ts       # Client API Lansenger (WS, HTTP, médias)
-│   ├── channel.ts      # Plugin de canal OpenClaw
-│   ├── runtime.ts      # Runtime passerelle (méthodes, handler entrant)
-│   ├── tools.ts        # Définitions des outils agent (10 outils intégrés)
-│   ├── 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
+│   ├── client.ts          # Client API Lansenger (WS, HTTP, médias)
+│   ├── channel.ts         # Plugin de canal OpenClaw
+│   ├── runtime.ts         # Runtime passerelle (handler entrant, livraison)
+│   ├── tools.ts           # Définitions des outils agent (lansenger_send_*)
+│   ├── persistent-store.ts # Persistance d'état sur disque
+│   ├── setup-wizard.ts    # Assistant de configuration (migration config multi-compte)
+│   ├── setup-i18n.ts      # i18n de l'assistant de configuration
+│   ├── *.test.ts          # Tests unitaires
 ├── skills/
-│   └── lansenger-messaging/
-│       └── SKILL.md    # Stratégie de messagerie (outils + CLI)
-├── dist/               # JavaScript compilé
-├── index.ts            # Point d'entrée du plugin
-├── setup-entry.ts      # Point d'entrée de l'assistant de configuration
-├── openclaw.plugin.json # Métadonnées du plugin & configuration GUI
+│   ├── lansenger-messaging/
+│   │   └── SKILL.md       # Stratégie de messagerie (outils + CLI)
+│   └── lansenger-setup/
+│       └── SKILL.md       # Assistant d'installation (copié auto vers ~/.openclaw/skills)
+├── dist/                  # JavaScript compilé
+├── index.ts               # Point d'entrée du plugin (registerFull, ensureSetupSkill)
+├── setup-entry.ts         # Point d'entrée de l'assistant de configuration
+├── openclaw.plugin.json   # Métadonnées du plugin & configuration GUI
+├── CHANGELOG.md
+├── VERSION
+├── vitest.config.ts
 ├── package.json
 └── tsconfig.json
 ```

package/README.md

@@ -351,6 +351,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.
+- **lansenger-setup skill auto-copy** — the plugin copies `lansenger-setup` skill to `~/.openclaw/skills/` on startup so the agent can help configure Lansenger even before the channel is fully activated. This is intentional — do not remove it manually.
 - **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.
 
@@ -380,23 +381,26 @@ npx tsc --noEmit
 ```
 openclaw-lansenger-channel/
 ├── src/
-│   ├── client.ts       # Lansenger API client (WS, HTTP, media)
-│   ├── channel.ts      # OpenClaw channel plugin
-│   ├── runtime.ts      # Gateway runtime (methods, inbound handler)
-│   ├── tools.ts        # Agent tool definitions (10 built-in tools)
-│   ├── 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
+│   ├── client.ts          # Lansenger API client (WS, HTTP, media)
+│   ├── channel.ts         # OpenClaw channel plugin
+│   ├── runtime.ts         # Gateway runtime (inbound handler, delivery)
+│   ├── tools.ts           # Agent tool definitions (lansenger_send_*)
+│   ├── persistent-store.ts # Disk-backed state persistence
+│   ├── setup-wizard.ts    # Setup wizard (multi-account config migration)
+│   ├── setup-i18n.ts      # Setup wizard i18n strings
+│   ├── *.test.ts          # Unit tests
 ├── skills/
-│   └── lansenger-messaging/
-│       └── SKILL.md    # Agent messaging strategy (tools + CLI)
-├── dist/               # Compiled JavaScript
-├── index.ts            # Plugin entry point
-├── setup-entry.ts      # Setup wizard entry
-├── openclaw.plugin.json # Plugin metadata & GUI config
+│   ├── lansenger-messaging/
+│   │   └── SKILL.md       # Agent messaging strategy (tools + CLI)
+│   └── lansenger-setup/
+│       └── SKILL.md       # Setup assistant (auto-copied to ~/.openclaw/skills)
+├── dist/                  # Compiled JavaScript
+├── index.ts               # Plugin entry point (registerFull, ensureSetupSkill)
+├── setup-entry.ts         # Setup wizard entry
+├── openclaw.plugin.json   # Plugin metadata & GUI config
+├── CHANGELOG.md
+├── VERSION
+├── vitest.config.ts
 ├── package.json
 └── tsconfig.json
 ```

package/README.zhHans.md

@@ -359,6 +359,7 @@ openclaw channels status --probe
 - **reminder** — formatText 中可选字段；群聊中建议使用。提及用户时在文本中包含"@姓名"。
 - **媒体标签** — `<media>` 标签适用于工作区文件；外部路径请使用 `lansenger_send_file`。
 - **openclaw skill/message lansenger** — 这些 CLI 命令不存在；请使用代理工具。
+- **lansenger-setup 技能自动复制** — 插件在启动时将 `lansenger-setup` 技能复制到 `~/.openclaw/skills/`，以便在频道完全激活之前就能帮助配置蓝信。这是有意设计，请勿手动删除。
 - **代理工具** — 代理工具（`lansenger_send_*`）需要工具插件且网关注入成功 — 若工具不可用，请使用 CLI 作为备选。CLI 命令（`lansenger message send-*`）需要 `pipx install lansenger-cli`。
 - **alsoAllow** — 本插件注册了 agent 工具（`lansenger_send_*`），但在严格工具策略下可能**不可见**。需在 `openclaw.json` 中添加 `"tools": { "alsoAllow": ["group:plugins"] }` 以确保 agent 能看到并使用这些工具。否则工具可能静默不出现在 agent 工具列表中。
 
@@ -388,23 +389,26 @@ npx tsc --noEmit
 ```
 openclaw-lansenger-channel/
 ├── src/
-│   ├── client.ts       # 蓝信 API 客户端（WS、HTTP、媒体）
-│   ├── channel.ts      # OpenClaw 频道插件
-│   ├── runtime.ts      # 网关运行时（方法、入站处理器）
-│   ├── tools.ts        # 代理工具定义（10 个内置工具）
-│   ├── setup-wizard.ts # 设置向导（多账号配置迁移）
-│   ├── channel.test.ts # 频道插件测试
-│   ├── client.test.ts  # API 客户端测试
-│   ├── runtime.test.ts # 运行时测试
-│   ├── tools.test.ts   # 工具测试
-│   └── setup-wizard.test.ts # 设置向导测试
+│   ├── client.ts          # 蓝信 API 客户端（WS、HTTP、媒体）
+│   ├── channel.ts         # OpenClaw 频道插件
+│   ├── runtime.ts         # 网关运行时（入站处理、投递）
+│   ├── tools.ts           # 代理工具定义（lansenger_send_*）
+│   ├── persistent-store.ts # 磁盘状态持久化
+│   ├── setup-wizard.ts    # 设置向导（多账号配置迁移）
+│   ├── setup-i18n.ts      # 设置向导多语言
+│   ├── *.test.ts          # 单元测试
 ├── skills/
-│   └── lansenger-messaging/
-│       └── SKILL.md    # 代理消息策略（工具 + CLI）
-├── dist/               # 编译后的 JavaScript
-├── index.ts            # 插件入口
-├── setup-entry.ts      # 设置向导入口
-├── openclaw.plugin.json # 插件元数据与 GUI 配置
+│   ├── lansenger-messaging/
+│   │   └── SKILL.md       # 代理消息策略（工具 + CLI）
+│   └── lansenger-setup/
+│       └── SKILL.md       # 安装助手（自动复制至 ~/.openclaw/skills）
+├── dist/                  # 编译后的 JavaScript
+├── index.ts               # 插件入口（registerFull、ensureSetupSkill）
+├── setup-entry.ts         # 设置向导入口
+├── openclaw.plugin.json   # 插件元数据与 GUI 配置
+├── CHANGELOG.md
+├── VERSION
+├── vitest.config.ts
 ├── package.json
 └── tsconfig.json
 ```

package/README.zhHant.md

@@ -359,6 +359,7 @@ openclaw channels status --probe
 - **reminder**——formatText 中可選欄位；群組聊天中建議使用。提及使用者時在文字中包含「@姓名」。
 - **媒體標籤**——`<media>` 標籤適用於工作區檔案；外部路徑請使用 `lansenger_send_file`。
 - **openclaw skill/message lansenger**——這些 CLI 命令不存在；請使用代理工具。
+- **lansenger-setup 技能自動複製**——插件在啟動時將 `lansenger-setup` 技能複製到 `~/.openclaw/skills/`，以便在頻道完全啟用前就能幫助設定藍信。此為設計行為，請勿手動刪除。
 - **代理工具**——代理工具（`lansenger_send_*`）需要工具插件且閘道注入成功——若工具不可用，請使用 CLI 作為備選。CLI 命令（`lansenger message send-*`）需要 `pipx install lansenger-cli`。
 - **alsoAllow**——本插件註冊了 agent 工具（`lansenger_send_*`），但在嚴格工具策略下可能**不可見**。需在 `openclaw.json` 中新增 `"tools": { "alsoAllow": ["group:plugins"] }` 以確保 agent 能看到並使用這些工具。否則工具可能靜默不出現在 agent 工具列表中。
 
@@ -388,23 +389,26 @@ npx tsc --noEmit
 ```
 openclaw-lansenger-channel/
 ├── src/
-│   ├── client.ts       # 藍信 API 客戶端（WS、HTTP、媒體）
-│   ├── channel.ts      # OpenClaw 频道插件
-│   ├── runtime.ts      # 閘道運行時（方法、入站處理器）
-│   ├── tools.ts        # 代理工具定義（10 個內建工具）
-│   ├── setup-wizard.ts # 設定精靈（多帳號配置遷移）
-│   ├── channel.test.ts # 频道插件測試
-│   ├── client.test.ts  # API 客戶端測試
-│   ├── runtime.test.ts # 運行時測試
-│   ├── tools.test.ts   # 工具測試
-│   └── setup-wizard.test.ts # 設定精靈測試
+│   ├── client.ts          # 藍信 API 客戶端（WS、HTTP、媒體）
+│   ├── channel.ts         # OpenClaw 頻道插件
+│   ├── runtime.ts         # 閘道運行時（入站處理、投遞）
+│   ├── tools.ts           # 代理工具定義（lansenger_send_*）
+│   ├── persistent-store.ts # 磁碟狀態持久化
+│   ├── setup-wizard.ts    # 設定精靈（多帳號配置遷移）
+│   ├── setup-i18n.ts      # 設定精靈多語言
+│   ├── *.test.ts          # 單元測試
 ├── skills/
-│   └── lansenger-messaging/
-│       └── SKILL.md    # 代理訊息策略（工具 + CLI）
-├── dist/               # 編譯後的 JavaScript
-├── index.ts            # 插件入口
-├── setup-entry.ts      # 設定精靈入口
-├── openclaw.plugin.json # 插件元資料與 GUI 設定
+│   ├── lansenger-messaging/
+│   │   └── SKILL.md       # 代理訊息策略（工具 + CLI）
+│   └── lansenger-setup/
+│       └── SKILL.md       # 安裝助手（自動複製至 ~/.openclaw/skills）
+├── dist/                  # 編譯後的 JavaScript
+├── index.ts               # 插件入口（registerFull、ensureSetupSkill）
+├── setup-entry.ts         # 設定精靈入口
+├── openclaw.plugin.json   # 插件元資料與 GUI 設定
+├── CHANGELOG.md
+├── VERSION
+├── vitest.config.ts
 ├── package.json
 └── tsconfig.json
 ```

package/README.zhHantHK.md

@@ -361,6 +361,7 @@ openclaw channels status --probe
 - **reminder** — formatText 中可選欄位；群組聊天中建議使用。提及使用者時在文字中包含「@姓名」。
 - **媒體標籤** — `<media>` 標籤適用於工作區檔案；外部路徑請使用 `lansenger_send_file`。
 - **openclaw skill/message lansenger** — 這些 CLI 命令不存在；請使用代理工具。
+- **lansenger-setup 技能自動複製** — 插件在啟動時將 `lansenger-setup` 技能複製到 `~/.openclaw/skills/`，以便在頻道完全啟用前就能幫助設定藍信。此為設計行為，請勿手動刪除。
 - **代理工具** — 代理工具（`lansenger_send_*`）需要工具插件且網關注入成功 — 若工具不可用，請使用 CLI 作為備選。CLI 命令（`lansenger message send-*`）需要 `pipx install lansenger-cli`。
 - **alsoAllow** — 本插件註冊了 agent 工具（`lansenger_send_*`），但在嚴格工具策略下可能**不可見**。需在 `openclaw.json` 中新增 `"tools": { "alsoAllow": ["group:plugins"] }` 以確保 agent 能看到並使用這些工具。否則工具可能靜默不出現在 agent 工具列表中。
 
@@ -390,23 +391,26 @@ npx tsc --noEmit
 ```
 openclaw-lansenger-channel/
 ├── src/
-│   ├── client.ts       # 藍信 API 客戶端（WS、HTTP、媒體）
-│   ├── channel.ts      # OpenClaw 频道插件
-│   ├── runtime.ts      # 網關運行時（方法、入站處理器）
-│   ├── tools.ts        # 代理工具定義（10 個內建工具）
-│   ├── setup-wizard.ts # 設定精靈（多帳號配置遷移）
-│   ├── channel.test.ts # 频道插件測試
-│   ├── client.test.ts  # API 客戶端測試
-│   ├── runtime.test.ts # 運行時測試
-│   ├── tools.test.ts   # 工具測試
-│   └── setup-wizard.test.ts # 設定精靈測試
+│   ├── client.ts          # 藍信 API 客戶端（WS、HTTP、媒體）
+│   ├── channel.ts         # OpenClaw 頻道插件
+│   ├── runtime.ts         # 網關運行時（入站處理、投遞）
+│   ├── tools.ts           # 代理工具定義（lansenger_send_*）
+│   ├── persistent-store.ts # 磁碟狀態持久化
+│   ├── setup-wizard.ts    # 設定精靈（多帳號配置遷移）
+│   ├── setup-i18n.ts      # 設定精靈多語言
+│   ├── *.test.ts          # 單元測試
 ├── skills/
-│   └── lansenger-messaging/
-│       └── SKILL.md    # 代理訊息策略（工具 + CLI）
-├── dist/               # 編譯後的 JavaScript
-├── index.ts            # 插件入口
-├── setup-entry.ts      # 設定精靈入口
-├── openclaw.plugin.json # 插件元資料與 GUI 設定
+│   ├── lansenger-messaging/
+│   │   └── SKILL.md       # 代理訊息策略（工具 + CLI）
+│   └── lansenger-setup/
+│       └── SKILL.md       # 安裝助手（自動複製至 ~/.openclaw/skills）
+├── dist/                  # 編譯後的 JavaScript
+├── index.ts               # 插件入口（registerFull、ensureSetupSkill）
+├── setup-entry.ts         # 設定精靈入口
+├── openclaw.plugin.json   # 插件元資料與 GUI 設定
+├── CHANGELOG.md
+├── VERSION
+├── vitest.config.ts
 ├── package.json
 └── tsconfig.json
 ```

package/dist/src/client.js

@@ -511,7 +511,7 @@ export class LansengerClient {
             return { success: false, error: e.message };
         }
     }
-    async queryGroups(pageOffset = 1, pageSize = 100) {
+    async queryGroups(pageOffset = 0, pageSize = 100) {
         const token = await this.getAppToken();
         if (!token)
             return { error: "No access token" };

package/dist/src/tools.js

@@ -428,7 +428,7 @@ export function registerLansengerTools(api) {
                 description: "Query the bot's group list on Lansenger (蓝信). Returns total count and group IDs. ⚠️ May return errCode=10005 'API服务无权限' on enterprise deployments where /v2/groups/fetch is not authorized. If permission denied, ask the user for group chatIds manually.",
                 parameters: QueryGroupsSchema,
                 async execute(_toolCallId, params) {
-                    const result = await tc.client.queryGroups(params.pageOffset ?? 1, params.pageSize ?? 100);
+                    const result = await tc.client.queryGroups(params.pageOffset ?? 0, params.pageSize ?? 100);
                     if ("error" in result)
                         return jsonResult({ error: result.error });
                     return jsonResult({ success: true, totalGroupIds: result.totalGroupIds, groupIds: result.groupIds });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lansenger-pm/openclaw-lansenger-channel",
-  "version": "3.16.2",
+  "version": "3.16.3",
   "type": "module",
   "main": "dist/index.js",
   "exports": {