@lansenger-pm/openclaw-lansenger-channel 3.2.4 → 3.2.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/README.fr.md +14 -10
  2. package/README.md +14 -10
  3. package/README.zhHans.md +14 -10
  4. package/README.zhHant.md +14 -10
  5. package/README.zhHantHK.md +14 -10
  6. package/package.json +1 -1
  7. package/skills/lansenger-messaging/SKILL.md +9 -8
package/README.fr.md CHANGED
@@ -35,14 +35,16 @@ Connecte OpenClaw à Lansenger — une plateforme de messagerie d'entreprise —
35
35
 
36
36
  ## Outils de l'agent & CLI
37
37
 
38
- Les messages peuvent être envoyés via les **outils de l'agent**, les **commandes CLI**, ou les deux :
38
+ **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.
39
+
40
+ Les messages peuvent être envoyés via les **commandes CLI** (principal) ou les **outils agent** (repli) :
39
41
 
40
42
  | Méthode | Installation | Utilisation |
41
43
  |---------|-------------|-------------|
42
- | Outils agent | `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools` | `lansenger_send_file`, `lansenger_send_text`, etc. |
43
- | Commandes CLI | `pip install lansenger-cli` | `lansenger message send-file`, `lansenger message send-text`, etc. |
44
+ | **Commandes CLI** (principal) | `pipx install lansenger-cli` (`pip install lansenger-cli` comme alternative) | `lansenger message send-file`, `lansenger message send-text`, etc. |
45
+ | Outils agent (repli) | `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools` | `lansenger_send_file`, `lansenger_send_text`, etc. |
44
46
 
45
- > ⚠️ **Les outils agent nécessitent le plugin `lansenger-tools`** — installation séparée. Les commandes CLI nécessitent `lansenger-cli` (Python). Sans aucun des deux, seules les réponses Markdown normales fonctionnent.
47
+ > ⚠️ **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.
46
48
 
47
49
  ## Installation et Configuration
48
50
 
@@ -52,15 +54,15 @@ Les messages peuvent être envoyés via les **outils de l'agent**, les **command
52
54
  # 1. Installer le plugin de canal
53
55
  openclaw plugins install @lansenger-pm/openclaw-lansenger-channel
54
56
 
55
- # 2. Installer le plugin outils OU le CLI (au moins un est nécessaire pour les messages)
56
- # Option A : Plugin outils agent OpenClaw
57
+ # 2. Installer le CLI OU le plugin outils (au moins un est nécessaire pour les messages)
58
+ # Option A : CLI Python (principal — fonctionne toujours via bash)
59
+ pipx install lansenger-cli # ou : pip install lansenger-cli
60
+ # Option B : Plugin outils agent OpenClaw (repli — nécessite injection passerelle)
57
61
  openclaw plugins install @lansenger-pm/openclaw-lansenger-tools
58
- # Option B : CLI Python (fonctionne via bash)
59
- pip install lansenger-cli
60
62
 
61
63
  # 3. Activer les plugins (si non auto-activés)
62
64
  openclaw config set plugins.entries.lansenger.enabled true
63
- openclaw config set plugins.entries.lansenger-tools.enabled true # si Option A
65
+ openclaw config set plugins.entries.lansenger-tools.enabled true # si Option B
64
66
 
65
67
  # 4. Configurer le canal (assistant interactif)
66
68
  openclaw channels add
@@ -69,6 +71,8 @@ openclaw channels add
69
71
  openclaw gateway restart
70
72
  ```
71
73
 
74
+ > **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).
75
+
72
76
  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.
73
77
 
74
78
  > **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).
@@ -305,7 +309,7 @@ Le plugin supporte les cartes d'approbation :
305
309
  - **reminder** — champ optionnel dans formatText ; recommandé dans les chats de groupe. Inclure « @姓名 » dans le texte pour les mentions.
306
310
  - **Média** — les balises `<media>` fonctionnent pour les fichiers du workspace ; pour les chemins externes, utilisez `lansenger_send_file`.
307
311
  - **openclaw skill/message lansenger** — ces commandes CLI n'existent PAS ; utilisez les outils de l'agent.
308
- - **Plugin outils** — les outils agent (`lansenger_send_*`) nécessitent le plugin `@lansenger-pm/openclaw-lansenger-tools` installé séparément. Les commandes CLI (`lansenger message send-*`) nécessitent `pip install lansenger-cli`. Installez au moins l'un des deux.
312
+ - **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`.
309
313
 
310
314
  ## Développement
311
315
 
package/README.md CHANGED
@@ -33,14 +33,16 @@ Lansenger (蓝信) channel plugin for OpenClaw — WebSocket inbound, HTTP API o
33
33
 
34
34
  ## Agent Tools & CLI
35
35
 
36
- Messages can be sent via **agent tools**, **CLI commands**, or both:
36
+ **CLI is the PRIMARY method** — it always works via bash. Agent tools are a FALLBACK — they may not inject properly in some Gateway versions.
37
+
38
+ Messages can be sent via **CLI commands** (primary) or **agent tools** (fallback):
37
39
 
38
40
  | Method | How to install | Usage |
39
41
  |--------|---------------|-------|
40
- | Agent tools | `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools` | `lansenger_send_file`, `lansenger_send_text`, etc. |
41
- | CLI commands | `pip install lansenger-cli` | `lansenger message send-file`, `lansenger message send-text`, etc. |
42
+ | **CLI commands** (primary) | `pipx install lansenger-cli` (`pip install lansenger-cli` as alternative) | `lansenger message send-file`, `lansenger message send-text`, etc. |
43
+ | Agent tools (fallback) | `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools` | `lansenger_send_file`, `lansenger_send_text`, etc. |
42
44
 
43
- > ⚠️ **Agent tools require the `lansenger-tools` plugin** — install separately. CLI commands require `lansenger-cli` (Python). Without either, only normal Markdown replies work.
45
+ > ⚠️ **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.
44
46
 
45
47
  | Tool | Description |
46
48
  |------|-------------|
@@ -64,15 +66,15 @@ Tools are also available via CLI: `lansenger message send-text`, `lansenger mess
64
66
  # 1. Install the channel plugin
65
67
  openclaw plugins install @lansenger-pm/openclaw-lansenger-channel
66
68
 
67
- # 2. Install the tools plugin OR the CLI (at least one is needed for messaging)
68
- # Option A: OpenClaw agent tools plugin
69
+ # 2. Install the CLI OR the tools plugin (at least one is needed for messaging)
70
+ # Option A: Python CLI (primary — always works via bash)
71
+ pipx install lansenger-cli # or: pip install lansenger-cli
72
+ # Option B: OpenClaw agent tools plugin (fallback — requires Gateway injection)
69
73
  openclaw plugins install @lansenger-pm/openclaw-lansenger-tools
70
- # Option B: Python CLI (works via bash)
71
- pip install lansenger-cli
72
74
 
73
75
  # 3. Enable the plugins (if not auto-enabled)
74
76
  openclaw config set plugins.entries.lansenger.enabled true
75
- openclaw config set plugins.entries.lansenger-tools.enabled true # if using Option A
77
+ openclaw config set plugins.entries.lansenger-tools.enabled true # if using Option B
76
78
 
77
79
  # 4. Configure the channel (interactive wizard)
78
80
  openclaw channels add
@@ -81,6 +83,8 @@ openclaw channels add
81
83
  openclaw gateway restart
82
84
  ```
83
85
 
86
+ > **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.
87
+
84
88
  The `package.json` `peerDependencies` will warn during npm install if the tools plugin is missing. The setup wizard also reminds you to install it.
85
89
 
86
90
  > **Custom gateway**: For enterprise deployments (e.g. 奇安信), set `apiGatewayUrl` in `openclaw.json` or environment after configuration — see [Optional Configuration](#optional-configuration).
@@ -311,7 +315,7 @@ The plugin supports approval workflow cards:
311
315
  - **reminder** — optional in formatText; recommended in group chat. Include "@姓名" in text when mentioning.
312
316
  - **Media** — `<media>` tags work for workspace files; for external paths use `lansenger_send_file`.
313
317
  - **openclaw skill/message lansenger** — these CLI commands do NOT exist; use agent tools instead.
314
- - **Tools plugin** — agent tools (`lansenger_send_*`) require `@lansenger-pm/openclaw-lansenger-tools` plugin installed separately. CLI commands (`lansenger message send-*`) require `pip install lansenger-cli`. Install at least one.
318
+ - **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`.
315
319
 
316
320
  ## Development
317
321
 
package/README.zhHans.md CHANGED
@@ -35,14 +35,16 @@
35
35
 
36
36
  ## 代理工具 & CLI
37
37
 
38
- 消息可以通过**代理工具**、**CLI 命令**或两者发送：
38
+ **CLI 是主要方式** — 始终通过 bash 调用即可使用。代理工具为备选方式 — 在某些网关版本中可能无法正确注入。
39
+
40
+ 消息可以通过**CLI 命令**（主要）或**代理工具**（备选）发送：
39
41
 
40
42
  | 方式 | 安装方法 | 使用 |
41
43
  |------|----------|------|
42
- | 代理工具 | `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools` | `lansenger_send_file`、`lansenger_send_text` 等 |
43
- | CLI 命令 | `pip install lansenger-cli` | `lansenger message send-file`、`lansenger message send-text` 等 |
44
+ | **CLI 命令**（主要） | `pipx install lansenger-cli`（`pip install lansenger-cli` 为替代） | `lansenger message send-file`、`lansenger message send-text` 等 |
45
+ | 代理工具（备选） | `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools` | `lansenger_send_file`、`lansenger_send_text` 等 |
44
46
 
45
- > ⚠️ **代理工具需要 `lansenger-tools` 插件** — 需单独安装。CLI 命令需要 `lansenger-cli`（Python）。两者均未安装时，代理只能通过普通 Markdown 文本回复。
47
+ > ⚠️ **代理工具需要 `lansenger-tools` 插件且网关注入成功** — 若工具不可用，请使用 CLI 作为备选。CLI 命令需要 `lansenger-cli`（Python）。两者均未安装时，代理只能通过普通 Markdown 文本回复。
46
48
 
47
49
  | 工具 | 说明 |
48
50
  |------|------|
@@ -66,15 +68,15 @@
66
68
  # 1. 安装频道插件
67
69
  openclaw plugins install @lansenger-pm/openclaw-lansenger-channel
68
70
 
69
- # 2. 安装工具插件或 CLI（至少需要一个来发送消息）
70
- # 方案 A：OpenClaw 代理工具插件
71
+ # 2. 安装 CLI 或工具插件（至少需要一个来发送消息）
72
+ # 方案 A：Python CLI（主要 — 始终可通过 bash 调用）
73
+ pipx install lansenger-cli # 或：pip install lansenger-cli
74
+ # 方案 B：OpenClaw 代理工具插件（备选 — 需网关注入）
71
75
  openclaw plugins install @lansenger-pm/openclaw-lansenger-tools
72
- # 方案 B：Python CLI（通过 bash 调用）
73
- pip install lansenger-cli
74
76
 
75
77
  # 3. 启用插件（如未自动启用）
76
78
  openclaw config set plugins.entries.lansenger.enabled true
77
- openclaw config set plugins.entries.lansenger-tools.enabled true # 使用方案 A 时
79
+ openclaw config set plugins.entries.lansenger-tools.enabled true # 使用方案 B 时
78
80
 
79
81
  # 4. 配置频道（交互式向导）
80
82
  openclaw channels add
@@ -83,6 +85,8 @@ openclaw channels add
83
85
  openclaw gateway restart
84
86
  ```
85
87
 
88
+ > **注意**：代理工具（方案 B）在某些网关版本中可能无法正确注入 — 请务必检查代理工具列表中是否出现 `lansenger_send_*` 工具。若工具缺失，请使用 CLI（方案 A）。
89
+
86
90
  `package.json` 的 `peerDependencies` 在 npm install 时会警告缺失 tools 插件。设置向导也会提醒安装。
87
91
 
88
92
  > **自定义网关**：企业私有化部署（如奇安信）需在配置后通过 `openclaw.json` 或环境变量设置 `apiGatewayUrl` — 见[可选配置](#可选配置)。
@@ -319,7 +323,7 @@ openclaw channels status --probe
319
323
  - **reminder** — formatText 中可选字段；群聊中建议使用。提及用户时在文本中包含"@姓名"。
320
324
  - **媒体标签** — `<media>` 标签适用于工作区文件；外部路径请使用 `lansenger_send_file`。
321
325
  - **openclaw skill/message lansenger** — 这些 CLI 命令不存在；请使用代理工具。
322
- - **工具插件** — 代理工具（`lansenger_send_*`）需要单独安装 `@lansenger-pm/openclaw-lansenger-tools` 插件。CLI 命令（`lansenger message send-*`）需要 `pip install lansenger-cli`。至少安装其中一个。
326
+ - **代理工具** — 代理工具（`lansenger_send_*`）需要工具插件且网关注入成功 — 若工具不可用，请使用 CLI 作为备选。CLI 命令（`lansenger message send-*`）需要 `pipx install lansenger-cli`。
323
327
 
324
328
  ## 开发
325
329
 
package/README.zhHant.md CHANGED
@@ -35,14 +35,16 @@
35
35
 
36
36
  ## 代理工具 & CLI
37
37
 
38
- 訊息可以透過**代理工具**、**CLI 命令**或兩者傳送：
38
+ **CLI 是主要方式** — 始終透過 bash 呼叫即可使用。代理工具為備選方式 — 在某些閘道版本中可能無法正確注入。
39
+
40
+ 訊息可以透過**CLI 命令**（主要）或**代理工具**（備選）傳送：
39
41
 
40
42
  | 方式 | 安裝方法 | 使用 |
41
43
  |------|----------|------|
42
- | 代理工具 | `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools` | `lansenger_send_file`、`lansenger_send_text` 等 |
43
- | CLI 命令 | `pip install lansenger-cli` | `lansenger message send-file`、`lansenger message send-text` 等 |
44
+ | **CLI 命令**（主要） | `pipx install lansenger-cli`（`pip install lansenger-cli` 為替代） | `lansenger message send-file`、`lansenger message send-text` 等 |
45
+ | 代理工具（備選） | `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools` | `lansenger_send_file`、`lansenger_send_text` 等 |
44
46
 
45
- > ⚠️ **代理工具需要 `lansenger-tools` 插件** — 需單獨安裝。CLI 命令需要 `lansenger-cli`（Python）。兩者均未安裝時，代理只能透過普通 Markdown 文字回覆。
47
+ > ⚠️ **代理工具需要 `lansenger-tools` 插件且閘道注入成功** — 若工具不可用，請使用 CLI 作為備選。CLI 命令需要 `lansenger-cli`（Python）。兩者均未安裝時，代理只能透過普通 Markdown 文字回覆。
46
48
 
47
49
  ## 安裝與設定
48
50
 
@@ -52,15 +54,15 @@
52
54
  # 1. 安裝頻道插件
53
55
  openclaw plugins install @lansenger-pm/openclaw-lansenger-channel
54
56
 
55
- # 2. 安裝工具插件或 CLI（至少需要一個來傳送訊息）
56
- # 方案 A：OpenClaw 代理工具插件
57
+ # 2. 安裝 CLI 或工具插件（至少需要一個來傳送訊息）
58
+ # 方案 A：Python CLI（主要 — 始終可透過 bash 呼叫）
59
+ pipx install lansenger-cli # 或：pip install lansenger-cli
60
+ # 方案 B：OpenClaw 代理工具插件（備選 — 需閘道注入）
57
61
  openclaw plugins install @lansenger-pm/openclaw-lansenger-tools
58
- # 方案 B：Python CLI（透過 bash 呼叫）
59
- pip install lansenger-cli
60
62
 
61
63
  # 3. 啟用插件（如未自動啟用）
62
64
  openclaw config set plugins.entries.lansenger.enabled true
63
- openclaw config set plugins.entries.lansenger-tools.enabled true # 使用方案 A 時
65
+ openclaw config set plugins.entries.lansenger-tools.enabled true # 使用方案 B 時
64
66
 
65
67
  # 4. 配置頻道（互動式精靈）
66
68
  openclaw channels add
@@ -69,6 +71,8 @@ openclaw channels add
69
71
  openclaw gateway restart
70
72
  ```
71
73
 
74
+ > **注意**：代理工具（方案 B）在某些閘道版本中可能無法正確注入 — 請務必檢查代理工具列表中是否出現 `lansenger_send_*` 工具。若工具缺失，請使用 CLI（方案 A）。
75
+
72
76
  `package.json` 的 `peerDependencies` 在 npm install 時會警告缺少 tools 插件。設定精靈也會提醒安裝。
73
77
 
74
78
  > **自訂閘道**：企業私有化部署（如奇安信）需在設定後透過 `openclaw.json` 或環境變數設定 `apiGatewayUrl` — 見[可選設定](#可選設定)。
@@ -305,7 +309,7 @@ openclaw channels status --probe
305
309
  - **reminder**——formatText 中可選欄位；群組聊天中建議使用。提及使用者時在文字中包含「@姓名」。
306
310
  - **媒體標籤**——`<media>` 標籤適用於工作區檔案；外部路徑請使用 `lansenger_send_file`。
307
311
  - **openclaw skill/message lansenger**——這些 CLI 命令不存在；請使用代理工具。
308
- - **工具插件**——代理工具（`lansenger_send_*`）需要單獨安裝 `@lansenger-pm/openclaw-lansenger-tools` 插件。CLI 命令（`lansenger message send-*`）需要 `pip install lansenger-cli`。至少安裝其中一個。
312
+ - **代理工具**——代理工具（`lansenger_send_*`）需要工具插件且閘道注入成功——若工具不可用，請使用 CLI 作為備選。CLI 命令（`lansenger message send-*`）需要 `pipx install lansenger-cli`。
309
313
 
310
314
  ## 開發
311
315
 
package/README.zhHantHK.md CHANGED
@@ -35,14 +35,16 @@
35
35
 
36
36
  ## 代理工具 & CLI
37
37
 
38
- 訊息可以透過**代理工具**、**CLI 命令**或兩者發送：
38
+ **CLI 是主要方式** — 始終透過 bash 呼叫即可使用。代理工具為備選方式 — 在某些網關版本中可能無法正確注入。
39
+
40
+ 訊息可以透過**CLI 命令**（主要）或**代理工具**（備選）發送：
39
41
 
40
42
  | 方式 | 安裝方法 | 使用 |
41
43
  |------|----------|------|
42
- | 代理工具 | `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools` | `lansenger_send_file`、`lansenger_send_text` 等 |
43
- | CLI 命令 | `pip install lansenger-cli` | `lansenger message send-file`、`lansenger message send-text` 等 |
44
+ | **CLI 命令**（主要） | `pipx install lansenger-cli`（`pip install lansenger-cli` 為替代） | `lansenger message send-file`、`lansenger message send-text` 等 |
45
+ | 代理工具（備選） | `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools` | `lansenger_send_file`、`lansenger_send_text` 等 |
44
46
 
45
- > ⚠️ **代理工具需要 `lansenger-tools` 插件** — 需單獨安裝。CLI 命令需要 `lansenger-cli`（Python）。兩者均未安裝時，代理只能透過普通 Markdown 文字回覆。
47
+ > ⚠️ **代理工具需要 `lansenger-tools` 插件且網關注入成功** — 若工具不可用，請使用 CLI 作為備選。CLI 命令需要 `lansenger-cli`（Python）。兩者均未安裝時，代理只能透過普通 Markdown 文字回覆。
46
48
 
47
49
  ## 安裝與設定
48
50
 
@@ -52,15 +54,15 @@
52
54
  # 1. 安裝頻道插件
53
55
  openclaw plugins install @lansenger-pm/openclaw-lansenger-channel
54
56
 
55
- # 2. 安裝工具插件或 CLI（至少需要一個來發送訊息）
56
- # 方案 A：OpenClaw 代理工具插件
57
+ # 2. 安裝 CLI 或工具插件（至少需要一個來發送訊息）
58
+ # 方案 A：Python CLI（主要 — 始終可透過 bash 呼叫）
59
+ pipx install lansenger-cli # 或：pip install lansenger-cli
60
+ # 方案 B：OpenClaw 代理工具插件（備選 — 需網關注入）
57
61
  openclaw plugins install @lansenger-pm/openclaw-lansenger-tools
58
- # 方案 B：Python CLI（透過 bash 呼叫）
59
- pip install lansenger-cli
60
62
 
61
63
  # 3. 啟用插件（如未自動啟用）
62
64
  openclaw config set plugins.entries.lansenger.enabled true
63
- openclaw config set plugins.entries.lansenger-tools.enabled true # 使用方案 A 時
65
+ openclaw config set plugins.entries.lansenger-tools.enabled true # 使用方案 B 時
64
66
 
65
67
  # 4. 配置頻道（互動式精靈）
66
68
  openclaw channels add
@@ -69,6 +71,8 @@ openclaw channels add
69
71
  openclaw gateway restart
70
72
  ```
71
73
 
74
+ > **注意**：代理工具（方案 B）在某些網關版本中可能無法正確注入 — 請務必檢查代理工具列表中是否出現 `lansenger_send_*` 工具。若工具缺失，請使用 CLI（方案 A）。
75
+
72
76
  `package.json` 的 `peerDependencies` 在 npm install 時會警告缺少 tools 插件。設定精靈也會提醒安裝。
73
77
 
74
78
  > **自訂閘道**：企業私有化部署（如奇安信）需在設定後透過 `openclaw.json` 或環境變數設定 `apiGatewayUrl` — 見[可選設定](#可選設定)。
@@ -307,7 +311,7 @@ openclaw channels status --probe
307
311
  - **reminder** — formatText 中可選欄位；群組聊天中建議使用。提及使用者時在文字中包含「@姓名」。
308
312
  - **媒體標籤** — `<media>` 標籤適用於工作區檔案；外部路徑請使用 `lansenger_send_file`。
309
313
  - **openclaw skill/message lansenger** — 這些 CLI 命令不存在；請使用代理工具。
310
- - **工具插件** — 代理工具（`lansenger_send_*`）需要單獨安裝 `@lansenger-pm/openclaw-lansenger-tools` 插件。CLI 命令（`lansenger message send-*`）需要 `pip install lansenger-cli`。至少安裝其中一個。
314
+ - **代理工具** — 代理工具（`lansenger_send_*`）需要工具插件且網關注入成功 — 若工具不可用，請使用 CLI 作為備選。CLI 命令（`lansenger message send-*`）需要 `pipx install lansenger-cli`。
311
315
 
312
316
  ## 開發
313
317
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lansenger-pm/openclaw-lansenger-channel",
3
- "version": "3.2.4",
3
+ "version": "3.2.6",
4
4
  "type": "module",
5
5
  "main": "dist/index.js",
6
6
  "exports": {
package/skills/lansenger-messaging/SKILL.md CHANGED
@@ -1,19 +1,19 @@
1
1
  ---
2
2
  name: lansenger-messaging
3
- description: How to communicate on Lansenger (蓝信) — choose the right tool or CLI command, send rich content, approvals, and pitfalls
4
- metadata: {"openclaw":{"requires":{"config":["channels.lansenger"],"plugins":["lansenger-tools"]},"primaryEnv":"LANSENGER_APP_ID"}}
3
+ description: How to communicate on Lansenger (蓝信) — send rich content via CLI (primary) or agent tools (fallback), approvals, and pitfalls
4
+ metadata: {"openclaw":{"requires":{"config":["channels.lansenger"],"plugins":["lansenger-tools"],"cli":["lansenger"]},"primaryEnv":"LANSENGER_APP_ID"}}
5
5
  ---
6
6
 
7
7
  # Lansenger (蓝信) Messaging — Agent Quick Reference
8
8
 
9
- > ⚠️ **Agent tools require the `lansenger-tools` plugin** — install with `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools`. Without it, only normal Markdown replies and CLI commands work.
10
-
11
9
  In a Lansenger session, **just write your reply normally** — Markdown renders automatically as formatText. No tool needed for formatted text unless you also need @mentions.
12
10
 
13
- You can send messages via **agent tools** or **CLI commands**. Both work. Choose whichever is available:
11
+ You can send messages via **CLI commands** (primary, always works) or **agent tools** (fallback, may not inject properly in some Gateway versions):
12
+
13
+ - **CLI commands** (PRIMARY): `lansenger message send-file`, `lansenger message send-text`, etc. — via bash exec. Requires `pipx install lansenger-cli` or `pip install lansenger-cli`.
14
+ - **Agent tools** (FALLBACK): `lansenger_send_file`, `lansenger_send_text`, etc. — available ONLY when `lansenger-tools` plugin is installed AND Gateway successfully injects them. If `toolNames: []`, tools are unavailable — use CLI instead.
14
15
 
15
- - **Agent tools**: `lansenger_send_file`, `lansenger_send_text`, etc. — available when `lansenger-tools` plugin is installed.
16
- - **CLI commands**: `lansenger message send-file`, `lansenger message send-text`, etc. — available via bash.
16
+ > ⚠️ **Install CLI first**: `pipx install lansenger-cli` (or `pip install lansenger-cli`). This is the reliable path. Agent tools may not inject in some OpenClaw versions — always verify availability before relying on them.
17
17
 
18
18
  However, Markdown and file attachments are **mutually exclusive**. If you need both formatting AND a file, send the Markdown reply first, then call `lansenger_send_file` or `lansenger message send-file` separately.
19
19
 
@@ -261,4 +261,5 @@ Status colors: #FFB116 (pending), #198754 (approved), #dc3545 (denied)
261
261
  | AppCard `text-indent: 0` | Use `0em` with unit. Bare 0 causes silent failure. |
262
262
  | headStatusInfo div wrapping | description supports div-style for color. colour is the DOT/圆点 color. Separate. |
263
263
  | Message too long | ~4000 character limit. Split into multiple messages. |
264
- | Tools not available | Install `lansenger-tools` plugin: `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools` |
264
+ | Tools not available | **Use CLI as fallback**: `pipx install lansenger-cli`, then `lansenger message send-text <chatId> <content>`. Agent tools may not inject in some Gateway versions. |
265
+ | CLI command not found | Install: `pipx install lansenger-cli` or `pip install lansenger-cli`. Then verify: `lansenger --help`. |