@seeed-studio/meshtastic 0.2.0 → 0.2.1

package/README.zh-CN.md

@@ -1,60 +1,52 @@
-# OpenClaw Meshtastic 插件
+# MeshClaw：OpenClaw Meshtastic 频道插件
 
-[![npm version](https://img.shields.io/npm/v/@seeed-studio/meshtastic.svg)](https://www.npmjs.com/package/@seeed-studio/meshtastic)
-[![license](https://img.shields.io/npm/l/@seeed-studio/meshtastic.svg)](https://www.npmjs.com/package/@seeed-studio/meshtastic)
+<p align="center">
+  <a href="https://www.npmjs.com/package/@seeed-studio/meshtastic">
+    <img alt="npm 版本" src="https://img.shields.io/npm/v/@seeed-studio/meshtastic.svg" />
+  </a>
+  <a href="https://www.npmjs.com/package/@seeed-studio/meshtastic">
+    <img alt="许可证" src="https://img.shields.io/npm/l/@seeed-studio/meshtastic.svg" />
+  </a>
+</p>
 
-[English](README.md) | **[中文](README.zh-CN.md)**
+<!-- LANG_SWITCHER_START -->
+<p align="center">
+  <a href="README.md">English</a> | <b>中文</b> | <a href="README.ja.md">日本語</a> | <a href="README.fr.md">Français</a> | <a href="README.pt.md">Português</a> | <a href="README.es.md">Español</a>
+</p>
+<!-- LANG_SWITCHER_END -->
 
-[OpenClaw](https://github.com/openclaw/openclaw) 的 [Meshtastic](https://meshtastic.org/) LoRa 网状网络频道插件。通过 USB 串口、HTTP 或 MQTT 将 AI 网关连接到 mesh 网络，无需云服务。
+MeshClaw 是一个 OpenClaw 频道插件，让你的 AI 网关通过 Meshtastic 发送和接收消息——无需互联网、无需蜂窝网络，只靠电波。在山里、海上，或任何不在电网覆盖范围的地方，都能与 AI 助手沟通。
+
+⭐ 欢迎在 GitHub 上为我们点 Star——这对我们很有激励！
 
 > [!IMPORTANT]
-> 这是 [OpenClaw](https://github.com/openclaw/openclaw) AI 网关的**频道插件**，不是独立应用程序。你需要一个运行中的 OpenClaw 实例（Node.js 22+）才能使用。
+> 这是用于 [OpenClaw](https://github.com/openclaw/openclaw) AI 网关的“频道插件”，并非独立应用。使用前需要一个已运行的 OpenClaw 实例（Node.js 22+）。
 
-[文档][docs] · [硬件指南](#推荐硬件) · [报告问题][issues] · [功能请求][issues]
-
-<p align="center">
-  <img src="media/hardware.jpg" width="420" alt="Meshtastic LoRa 硬件" />
-</p>
+[文档][docs] · [硬件指南](#recommended-hardware) · [提交 Bug][issues] · [功能请求][issues]
 
 ## 目录
 
-- [快速开始](#快速开始)
 - [工作原理](#工作原理)
 - [推荐硬件](#推荐硬件)
+- [功能](#功能)
+- [能力与路线图](#能力与路线图)
 - [演示](#演示)
-- [功能特性](#功能特性)
+- [快速开始](#快速开始)
 - [设置向导](#设置向导)
-- [配置](#配置)
-- [故障排查](#故障排查)
-- [开发](#开发)
-- [贡献](#贡献)
-
-## 快速开始
-
-```bash
-# 1. 安装插件
-openclaw plugins install @seeed-studio/meshtastic
-
-# 2. 交互式设置 — 引导完成传输方式、频率区域、访问策略等配置
-openclaw setup
-
-# 3. 验证
-openclaw channels status --probe
-```
-
-<p align="center">
-  <img src="media/setup-screenshot.png" width="700" alt="OpenClaw 设置向导" />
-</p>
+- [配置](#1-传输方式)
+- [故障排查](#2-lora-区域)
+- [开发](#3-节点名称)
+- [贡献](#4-频道访问grouppolicy)
 
 ## 工作原理
 
 ```mermaid
 flowchart LR
-    subgraph mesh ["📻 LoRa Mesh 网络"]
-        N["Meshtastic 节点"]
+    subgraph mesh ["📻 LoRa Mesh Network"]
+        N["Meshtastic Nodes"]
     end
-    subgraph gw ["⚙️ OpenClaw 网关"]
-        P["Meshtastic 插件"]
+    subgraph gw ["⚙️ OpenClaw Gateway"]
+        P["Meshtastic Plugin"]
         AI["AI Agent"]
     end
     N -- "Serial (USB)" --> P
@@ -63,13 +55,13 @@ flowchart LR
     P <--> AI
 ```
 
-本插件在 Meshtastic LoRa 设备和 OpenClaw AI Agent 之间架起桥梁，支持三种传输模式：
+该插件在 Meshtastic LoRa 设备与 OpenClaw AI 代理之间建立桥接。支持三种传输模式：
 
-- **Serial** — 通过 USB 直连本地 Meshtastic 设备
-- **HTTP** — 通过 WiFi / 局域网连接设备
-- **MQTT** — 订阅 Meshtastic MQTT broker，无需本地硬件
+- 串口（Serial）——通过 USB 直连本地 Meshtastic 设备
+- HTTP ——通过 WiFi/局域网连接设备
+- MQTT ——订阅 Meshtastic MQTT 代理，无需本地硬件
 
-入站消息经过访问控制（私信策略、群组策略、@mention 门控）后到达 AI。出站回复会自动去除 markdown 格式（LoRa 设备无法渲染），并按无线电包大小限制进行分片。
+入站消息会经过访问控制（私信策略、群组策略、@提及门槛）后再交给 AI。出站回复会移除 Markdown 格式（LoRa 设备无法渲染），并按无线电数据包大小限制进行分片发送。
 
 ## 推荐硬件
 
@@ -77,110 +69,149 @@ flowchart LR
   <img src="media/XIAOclaw.png" width="760" alt="搭载 Seeed XIAO 模组的 Meshtastic 设备" />
 </p>
 
-| 设备 | 适用场景 | 链接 |
-|---|---|---|
-| XIAO ESP32S3 + Wio-SX1262 套件 | 低成本离网节点 | [购买][hw-xiao] |
-| Wio Tracker L1 Pro | 即插即用网关 | [购买][hw-wio] |
-| SenseCAP Card Tracker T1000-E | 便携追踪器 | [购买][hw-sensecap] |
+| 设备                         | 最佳用途               | 链接               |
+| ---------------------------- | ---------------------- | ------------------ |
+| XIAO ESP32S3 + Wio-SX1262 套件 | 入门级开发             | [购买][hw-xiao]    |
+| Wio Tracker L1 Pro           | 便携式现场网关         | [购买][hw-wio]     |
+| SenseCAP Card Tracker T1000-E | 小型追踪器             | [购买][hw-sensecap] |
+
+没有硬件？可使用 MQTT 传输通过代理连接——无需本地设备。
+
+任何兼容 Meshtastic 的设备都可以使用。
 
-任何 Meshtastic 兼容设备均可使用。Serial 和 HTTP 直连设备；MQTT 完全不需要本地硬件。
+## 功能
+
+- AI 代理集成——将 OpenClaw AI 代理与 Meshtastic LoRa Mesh 网络桥接，实现无云依赖的智能通信。
+
+- 三种传输模式——支持串口（USB）、HTTP（WiFi）与 MQTT
+
+- 私信与群组频道的访问控制——支持两种会话模式，提供私信白名单、频道响应规则与@提及门槛
+
+- 多账号支持——可同时运行多个独立连接
+
+- 稳健的 Mesh 通信——可配置自动重连与重试，优雅应对掉线与中断
+
+## 能力与路线图
+
+该插件将 Meshtastic 视为一等公民的通讯渠道——就像 Telegram 或 Discord 一样——使 AI 对话与工具调用完全通过 LoRa 无线电进行，无需依赖互联网。
+
+| 离线查询信息                                            | 跨渠道桥接：离网发送，任意处接收                        | 🔜 接下来：                                                |
+| ------------------------------------------------------- | ------------------------------------------------------- | --------------------------------------------------------- |
+| <img src="media/image1.png" alt="离线查询信息" />       | <img src="media/image2.png" alt="跨渠道桥接" />         | 我们计划将实时节点数据（GPS 位置、环境传感、设备状态）注入 OpenClaw 上下文，让 AI 能监控 Mesh 网络健康状况，并主动广播告警，而无需等待用户发问。 |
 
 ## 演示
 
-https://github.com/user-attachments/assets/a3e46e9d-cf5a-4743-9830-f671a1998ca0
+<div align="center">
+
+https://github.com/user-attachments/assets/837062d9-a5bb-4e0a-b7cf-298e4bdf2f7c
+
+</div>
+
+备用视频： [media/demo.mp4](media/demo.mp4)
+
+## 快速开始
+
+```bash
+# 1. Install plugin
+openclaw plugins install @seeed-studio/meshtastic
 
-备用链接：[media/demo.mp4](media/demo.mp4)
+# 2. Guided setup — walks you through transport, region, and access policy
+openclaw onboard
 
-## 功能特性
+# 3. Verify
+openclaw channels status --probe
+```
 
-- **私信和 mesh 频道** — 支持按频道设置独立规则
-- **访问控制** — 私信策略（`open` / `pairing` / `allowlist`）、群组策略（`open` / `allowlist` / `disabled`）、@mention 门控、按频道白名单
-- **多账户** — 同时运行独立的 serial、HTTP、MQTT 连接
-- **区域感知** — 连接时自动设置设备区域，自动推导 MQTT topic 默认值
-- **自动重连** — 弹性重试处理
+<p align="center">
+  <img src="media/setup-screenshot.png" width="700" alt="OpenClaw 设置向导" />
+</p>
 
 ## 设置向导
 
-运行 `openclaw setup` 会启动一个交互式向导，逐步引导你完成配置。以下是每一步的含义和选择建议。
+运行 `openclaw onboard` 会启动交互式向导，引导你完成每一步配置。下面解释每一步的含义与选择建议。
 
-### 1. 传输方式（Transport）
+### 1. 传输方式
 
-网关如何连接到 Meshtastic mesh 网络：
+网关如何连接到 Meshtastic Mesh：
 
-| 选项 | 说明 | 要求 |
-|---|---|---|
-| **Serial**（USB 串口） | 通过 USB 直连本地设备，自动检测可用端口。 | Meshtastic 设备已通过 USB 连接 |
-| **HTTP**（WiFi） | 通过局域网连接设备。 | 设备 IP 或主机名（如 `meshtastic.local`） |
-| **MQTT**（broker） | 通过 MQTT broker 连接 mesh 网络，无需本地硬件。 | broker 地址、凭据和订阅 topic |
+| 选项               | 说明                                                          | 要求                                           |
+| ------------------ | ------------------------------------------------------------- | ---------------------------------------------- |
+| 串口（Serial，USB） | 通过 USB 直连本地设备。可自动检测可用端口。                    | 通过 USB 连接的 Meshtastic 设备                |
+| HTTP（WiFi）       | 通过局域网连接设备。                                           | 设备 IP 或主机名（如 `meshtastic.local`）      |
+| MQTT（代理）       | 通过 MQTT 代理接入 Mesh——无需本地硬件。                         | 代理地址、凭据与订阅主题                       |
 
-### 2. LoRa 频率区域（Region）
+### 2. LoRa 区域
 
-> 仅 Serial 和 HTTP 模式需要。MQTT 模式从订阅 topic 中自动推导区域。
+> 仅适用于串口与 HTTP。MQTT 会根据订阅主题推导区域。
 
-设置设备的无线电频率区域，必须与当地法规和 mesh 网络中其他节点一致。常用选项：
+设置设备的无线频段区域。必须符合当地法规，并与 Mesh 上其他节点一致。常见选项：
 
-| 区域 | 频率 |
-|---|---|
-| `US` | 902–928 MHz |
-| `EU_868` | 869 MHz |
-| `CN` | 470–510 MHz |
-| `JP` | 920 MHz |
-| `UNSET` | 保持设备默认值 |
+| 区域     | 频段               |
+| -------- | ------------------ |
+| `US`     | 902–928 MHz        |
+| `EU_868` | 869 MHz            |
+| `CN`     | 470–510 MHz        |
+| `JP`     | 920 MHz            |
+| `UNSET`  | 保持设备默认       |
 
 完整列表参见 [Meshtastic 区域文档](https://meshtastic.org/docs/getting-started/initial-config/#lora)。
 
-### 3. 节点名称（Node Name）
+### 3. 节点名称
 
-设备在 mesh 网络中的显示名称，同时作为群组频道中的 **@mention 触发词** — 其他用户发送 `@OpenClaw` 即可与你的 bot 对话。
+设备在 Mesh 上的显示名称。也作为群组频道中的“@提及触发词”——其他用户发送 `@OpenClaw` 与机器人对话。
 
-- **Serial / HTTP**：可选 — 留空会自动从连接的设备读取名称。
-- **MQTT**：必填 — 没有物理设备可供读取名称。
+- 串口/HTTP：可选——若留空，将自动从连接的设备读取名称。
+- MQTT：必填——因为没有实体设备可读取名称。
 
-### 4. 频道访问控制（Channel Access / `groupPolicy`）
+### 4. 频道访问（groupPolicy）
 
-控制 bot 是否以及如何响应 **mesh 群组频道**（如 LongFast、Emergency）中的消息：
+控制机器人在“Mesh 群组频道”（如 LongFast、Emergency）中的响应策略：
 
-| 策略 | 行为 |
-|---|---|
-| `disabled`（默认） | 忽略所有群组频道消息。仅处理私信。 |
-| `open` | 在 mesh 上的**所有**频道中响应消息。 |
-| `allowlist` | 仅在**指定频道**中响应。设置时会提示输入频道名称（逗号分隔，如 `LongFast, Emergency`）。使用 `*` 通配符匹配所有频道。 |
+| 策略                 | 行为说明                                                     |
+| -------------------- | ------------------------------------------------------------ |
+| `disabled`（默认）   | 忽略所有群组频道消息。仅处理私信。                           |
+| `open`               | 在 Mesh 上的“所有”频道中响应。                               |
+| `allowlist`          | 仅在“列出的”频道中响应。会提示输入频道名（逗号分隔，如 `LongFast, Emergency`）。使用 `*` 作为通配符匹配全部。 |
 
-### 5. 需要 @mention 才回复（Require Mention）
+### 5. 需要 @提及
 
-> 仅在频道访问控制不为 `disabled` 时出现。
+> 仅当频道访问已启用（非 `disabled`）时出现。
 
-启用时（默认：**是**），bot 在群组频道中只有被 @mention 时才会回复（如 `@OpenClaw 天气怎么样?`），防止 bot 对频道中的每条消息都回复。
+启用时（默认：是），机器人只在群组频道里被@到其节点名时才回应（例如 `@OpenClaw 天气怎么样？`）。这可避免机器人对频道中每一条消息都做出回复。
 
-禁用时，bot 会回复允许频道中的**所有**消息。
+若关闭，则机器人会在允许的频道中对“所有”消息回复。
 
-### 6. 私信访问策略（DM Access Policy / `dmPolicy`）
+### 6. 私信访问策略（dmPolicy）
 
-控制谁可以给 bot 发送**私信（Direct Message）**：
+控制谁可以给机器人发送“私信”：
 
-| 策略 | 行为 |
-|---|---|
-| `pairing`（默认） | 新发送者会触发配对请求，审批通过后才能对话。 |
-| `open` | mesh 上的任何人都可以自由私信 bot。 |
-| `allowlist` | 仅 `allowFrom` 列表中的节点可以私信，其他人被忽略。 |
+| 策略                 | 行为说明                                                     |
+| -------------------- | ------------------------------------------------------------ |
+| `pairing`（默认）    | 新发送者会触发配对请求，需先批准后才能聊天。                 |
+| `open`               | Mesh 上任何人都可以自由私信机器人。                          |
+| `allowlist`          | 只有 `allowFrom` 列表中的节点可以私信。其他一律忽略。        |
 
-### 7. 私信白名单（DM Allowlist / `allowFrom`）
+### 7. 私信白名单（allowFrom）
 
-> 仅在 `dmPolicy` 为 `allowlist` 或向导判断需要时出现。
+> 仅当 `dmPolicy` 为 `allowlist`，或向导判定需要时出现。
 
-允许发送私信的 Meshtastic 节点 ID 列表。格式为 `!aabbccdd`（十六进制节点 ID），多个条目用逗号分隔。
+允许发送私信的 Meshtastic 用户 ID 列表。格式：`!aabbccdd`（16 进制用户 ID）。多个条目用逗号分隔。
+
+<p align="center">
+  <img src="media/image3.jpg" width="400" />
+</p>
 
-### 8. 账户显示名称（Account Display Names）
+### 8. 账号显示名称
 
-> 仅在多账户配置时出现。可选。
+> 仅对多账号配置显示。可选。
 
-为你的账户设置人类可读的显示名称。例如，ID 为 `home` 的账户可以显示为「家里基站」。如果跳过，系统直接使用原始 account ID。这是纯展示性的设置，不影响任何功能。
+为你的账号分配易读的显示名称。比如，将 ID 为 `home` 的账号显示为 “Home Station”。若跳过，将直接使用原始账号 ID。仅用于显示，不影响功能。
 
 ## 配置
 
-交互式设置（`openclaw setup`）涵盖以下所有内容。详细步骤说明参见[设置向导](#设置向导)。如需手动编辑，使用 `openclaw config edit`。
+引导式设置（`openclaw onboard`）已覆盖以下所有内容。详见[设置向导](#setup-wizard)。若需手动配置，可用 `openclaw config edit` 编辑。
 
-### Serial（USB 串口）
+### 串口（USB）
 
 ```yaml
 channels:
@@ -200,7 +231,7 @@ channels:
     nodeName: OpenClaw
 ```
 
-### MQTT（broker）
+### MQTT（代理）
 
 ```yaml
 channels:
@@ -214,7 +245,7 @@ channels:
       topic: "msh/US/2/json/#"
 ```
 
-### 多账户
+### 多账号
 
 ```yaml
 channels:
@@ -231,76 +262,76 @@ channels:
 ```
 
 <details>
-<summary><b>全部选项参考</b></summary>
-
-| 配置项 | 类型 | 默认值 | 说明 |
-|---|---|---|---|
-| `transport` | `serial \| http \| mqtt` | `serial` | |
-| `serialPort` | `string` | — | Serial 模式必填 |
-| `httpAddress` | `string` | `meshtastic.local` | HTTP 模式必填 |
-| `httpTls` | `boolean` | `false` | |
-| `mqtt.broker` | `string` | `mqtt.meshtastic.org` | |
-| `mqtt.port` | `number` | `1883` | |
-| `mqtt.username` | `string` | `meshdev` | |
-| `mqtt.password` | `string` | `large4cats` | |
-| `mqtt.topic` | `string` | `msh/US/2/json/#` | 订阅 topic |
-| `mqtt.publishTopic` | `string` | 自动推导 | |
-| `mqtt.tls` | `boolean` | `false` | |
-| `region` | 枚举 | `UNSET` | `US`、`EU_868`、`CN`、`JP`、`ANZ`、`KR`、`TW`、`RU`、`IN`、`NZ_865`、`TH`、`EU_433`、`UA_433`、`UA_868`、`MY_433`、`MY_919`、`SG_923`、`LORA_24`。仅 Serial/HTTP 模式。 |
-| `nodeName` | `string` | 自动检测 | 显示名称及 @mention 触发词。MQTT 模式必填。 |
-| `dmPolicy` | `open \| pairing \| allowlist` | `pairing` | 私信访问策略。详见[私信访问策略](#6-私信访问策略dm-access-policy--dmpolicy)。 |
-| `allowFrom` | `string[]` | — | 私信白名单节点 ID，如 `["!aabbccdd"]` |
-| `groupPolicy` | `open \| allowlist \| disabled` | `disabled` | 群组频道响应策略。详见[频道访问控制](#4-频道访问控制channel-access--grouppolicy)。 |
-| `channels` | `Record<string, object>` | — | 按频道覆盖：`requireMention`、`allowFrom`、`tools` |
+<summary><b>所有选项参考</b></summary>
+
+| 键                   | 类型                             | 默认值               | 说明                                                         |
+| -------------------- | -------------------------------- | -------------------- | ------------------------------------------------------------ |
+| `transport`          | `serial \| http \| mqtt`         | `serial`             |                                                              |
+| `serialPort`         | `string`                         | —                    | 串口模式必填                                                 |
+| `httpAddress`        | `string`                         | `meshtastic.local`   | HTTP 模式必填                                                |
+| `httpTls`            | `boolean`                        | `false`              |                                                              |
+| `mqtt.broker`        | `string`                         | `mqtt.meshtastic.org`|                                                              |
+| `mqtt.port`          | `number`                         | `1883`               |                                                              |
+| `mqtt.username`      | `string`                         | `meshdev`            |                                                              |
+| `mqtt.password`      | `string`                         | `large4cats`         |                                                              |
+| `mqtt.topic`         | `string`                         | `msh/US/2/json/#`    | 订阅主题                                                     |
+| `mqtt.publishTopic`  | `string`                         | derived              |                                                              |
+| `mqtt.tls`           | `boolean`                        | `false`              |                                                              |
+| `region`             | enum                             | `UNSET`              | `US`, `EU_868`, `CN`, `JP`, `ANZ`, `KR`, `TW`, `RU`, `IN`, `NZ_865`, `TH`, `EU_433`, `UA_433`, `UA_868`, `MY_433`, `MY_919`, `SG_923`, `LORA_24`。仅串口/HTTP。 |
+| `nodeName`           | `string`                         | auto-detect          | 显示名与 @提及触发词。MQTT 必填。                            |
+| `dmPolicy`           | `open \| pairing \| allowlist`   | `pairing`            | 谁可以发送私信。见[私信访问策略](#6-私信访问策略-dmpolicy)。 |
+| `allowFrom`          | `string[]`                       | —                    | 私信白名单节点 ID，例如 `["!aabbccdd"]`                      |
+| `groupPolicy`        | `open \| allowlist \| disabled`  | `disabled`           | 群组频道响应策略。见[频道访问](#4-频道访问-grouppolicy)。    |
+| `channels`           | `Record<string, object>`         | —                    | 按频道覆盖：`requireMention`、`allowFrom`、`tools`           |
 
 </details>
 
 <details>
 <summary><b>环境变量覆盖</b></summary>
 
-以下环境变量覆盖默认账户的配置（YAML 中的命名账户配置优先）：
+这些环境变量会覆盖“默认账号”的配置（对命名账号，以 YAML 配置为准）：
 
-| 变量 | 等效配置项 |
-|---|---|
-| `MESHTASTIC_TRANSPORT` | `transport` |
-| `MESHTASTIC_SERIAL_PORT` | `serialPort` |
-| `MESHTASTIC_HTTP_ADDRESS` | `httpAddress` |
-| `MESHTASTIC_MQTT_BROKER` | `mqtt.broker` |
-| `MESHTASTIC_MQTT_TOPIC` | `mqtt.topic` |
+| 变量名                      | 等效配置键         |
+| --------------------------- | ------------------ |
+| `MESHTASTIC_TRANSPORT`      | `transport`        |
+| `MESHTASTIC_SERIAL_PORT`    | `serialPort`       |
+| `MESHTASTIC_HTTP_ADDRESS`   | `httpAddress`      |
+| `MESHTASTIC_MQTT_BROKER`    | `mqtt.broker`      |
+| `MESHTASTIC_MQTT_TOPIC`     | `mqtt.topic`       |
 
 </details>
 
 ## 故障排查
 
-| 症状 | 检查项 |
-|---|---|
-| Serial 无法连接 | 设备路径是否正确？主机是否有权限？ |
-| HTTP 无法连接 | `httpAddress` 是否可达？`httpTls` 是否与设备设置匹配？ |
-| MQTT 收不到消息 | `mqtt.topic` 中的区域是否正确？broker 凭据是否有效？ |
-| 私信无回复 | `dmPolicy` 和 `allowFrom` 是否已配置？详见[私信访问策略](#6-私信访问策略dm-access-policy--dmpolicy)。 |
-| 群组频道无回复 | `groupPolicy` 是否已启用？频道是否在白名单中？是否需要 @mention？详见[频道访问控制](#4-频道访问控制channel-access--grouppolicy)。 |
+| 现象                  | 检查点                                                      |
+| --------------------- | ----------------------------------------------------------- |
+| 串口无法连接          | 设备路径是否正确？主机是否有访问权限？                      |
+| HTTP 无法连接         | `httpAddress` 是否可达？`httpTls` 是否与设备设置匹配？      |
+| MQTT 没有收到消息     | `mqtt.topic` 中的区域是否正确？代理凭据是否有效？           |
+| 私信没响应            | `dmPolicy` 与 `allowFrom` 是否配置？见[私信访问策略](#6-私信访问策略-dmpolicy)。 |
+| 群组无回复            | `groupPolicy` 是否启用？频道是否在白名单？是否需要 @提及？见[频道访问](#4-频道访问-grouppolicy)。 |
 
-发现 bug？请[提交 issue][issues]，附上传输方式、配置（隐去密钥）以及 `openclaw channels status --probe` 的输出。
+发现 Bug？请[提交 Issue][issues]，并附上传输类型、配置（注意去除敏感信息）以及 `openclaw channels status --probe` 的输出。
 
 ## 开发
 
 ```bash
-git clone https://github.com/Seeed-Solution/openclaw-meshtastic.git
-cd openclaw-meshtastic
+git clone https://github.com/Seeed-Solution/MeshClaw.git
+cd MeshClaw
 npm install
-openclaw plugins install -l ./openclaw-meshtastic
+openclaw plugins install -l ./MeshClaw
 ```
 
-无构建步骤 — OpenClaw 直接加载 TypeScript 源码。使用 `openclaw channels status --probe` 验证。
+无需构建步骤——OpenClaw 会直接加载 TypeScript 源码。使用 `openclaw channels status --probe` 进行验证。
 
 ## 贡献
 
-- [提交 issue][issues] 报告 bug 或提出功能请求
-- 欢迎 Pull Request — 请保持与现有 TypeScript 代码风格一致
+- 发现问题或需要新功能，请[提交 Issue][issues]
+- 欢迎提交 PR——请保持代码风格与现有 TypeScript 约定一致
 
 <!-- Reference-style links -->
 [docs]: https://meshtastic.org/docs/
-[issues]: https://github.com/Seeed-Solution/openclaw-meshtastic/issues
+[issues]: https://github.com/Seeed-Solution/MeshClaw/issues
 [hw-xiao]: https://www.seeedstudio.com/Wio-SX1262-with-XIAO-ESP32S3-p-5982.html
 [hw-wio]: https://www.seeedstudio.com/Wio-Tracker-L1-Pro-p-6454.html
-[hw-sensecap]: https://www.seeedstudio.com/SenseCAP-Card-Tracker-T1000-E-for-Meshtastic-p-5913.html
+[hw-sensecap]: https://www.seeedstudio.com/SenseCAP-Card-Tracker-T1000-E-for-Meshtastic-p-5913.html

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "@seeed-studio/meshtastic",
-  "version": "0.2.0",
-  "description": "OpenClaw Meshtastic LoRa mesh channel plugin",
+  "version": "0.2.1",
+  "description": "MeshClaw — OpenClaw channel plugin for Meshtastic LoRa mesh networks",
   "type": "module",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Seeed-Solution/openclaw-meshtastic"
+    "url": "https://github.com/Seeed-Solution/MeshClaw"
   },
   "keywords": [
+    "meshclaw",
     "openclaw",
     "meshtastic",
     "lora",

package/src/channel.ts

@@ -10,7 +10,7 @@ import {
   resolveDefaultGroupPolicy,
   setAccountEnabledInConfigSection,
   type ChannelPlugin,
-} from "openclaw/plugin-sdk";
+} from "openclaw/plugin-sdk/irc";
 import {
   listMeshtasticAccountIds,
   resolveDefaultMeshtasticAccountId,
@@ -294,7 +294,7 @@ export const meshtasticPlugin: ChannelPlugin<ResolvedMeshtasticAccount, Meshtast
       if (!account.configured) {
         return {
           ok: false,
-          error: "Not configured. Run 'openclaw setup' to configure.",
+          error: "Not configured. Run 'openclaw onboard' to configure.",
           transport: account.transport,
         } as MeshtasticProbe;
       }
@@ -377,7 +377,7 @@ export const meshtasticPlugin: ChannelPlugin<ResolvedMeshtasticAccount, Meshtast
       if (!account.configured) {
         throw new Error(
           `Meshtastic is not configured for account "${account.accountId}". ` +
-            `Run 'openclaw setup' or set channels.meshtastic.transport and connection details in config.`,
+            `Run 'openclaw onboard' or set channels.meshtastic.transport and connection details in config.`,
         );
       }
       const transportDesc =

package/src/config-schema.ts

@@ -5,7 +5,7 @@ import {
   ReplyRuntimeConfigSchemaShape,
   ToolPolicySchema,
   requireOpenAllowFrom,
-} from "openclaw/plugin-sdk";
+} from "openclaw/plugin-sdk/irc";
 import { z } from "zod";
 
 const MeshtasticGroupSchema = z

package/src/inbound.ts

@@ -1,7 +1,6 @@
 import {
   GROUP_POLICY_BLOCKED_LABEL,
   createNormalizedOutboundDeliverer,
-  createReplyPrefixOptions,
   formatTextWithAttachmentLinks,
   logInboundDrop,
   resolveControlCommandGate,
@@ -12,7 +11,8 @@ import {
   type OutboundReplyPayload,
   type OpenClawConfig,
   type RuntimeEnv,
-} from "openclaw/plugin-sdk";
+} from "openclaw/plugin-sdk/irc";
+import { createReplyPrefixOptions } from "openclaw/plugin-sdk/matrix";
 import type { ResolvedMeshtasticAccount } from "./accounts.js";
 import {
   normalizeMeshtasticAllowlist,

package/src/monitor.ts

@@ -1,5 +1,5 @@
 import { randomUUID } from "node:crypto";
-import { createLoggerBackedRuntime, type RuntimeEnv } from "openclaw/plugin-sdk";
+import { createLoggerBackedRuntime, type RuntimeEnv } from "openclaw/plugin-sdk/irc";
 import { resolveMeshtasticAccount } from "./accounts.js";
 import { connectMeshtasticClient, DeviceStatus, SetOwnerRebootError, type MeshtasticClient } from "./client.js";
 import { handleMeshtasticInbound } from "./inbound.js";
@@ -59,7 +59,7 @@ export async function monitorMeshtasticProvider(
   if (!account.configured) {
     throw new Error(
       `Meshtastic is not configured for account "${account.accountId}". ` +
-        `Run 'openclaw setup' or set channels.meshtastic.transport and connection details in config.`,
+        `Run 'openclaw onboard' or set channels.meshtastic.transport and connection details in config.`,
     );
   }
 
@@ -247,7 +247,7 @@ async function monitorMqtt(params: {
   const mqttConfig = account.config.mqtt;
 
   if (!mqttConfig?.broker) {
-    throw new Error("MQTT broker not configured. Set channels.meshtastic.mqtt.broker or run 'openclaw setup'.");
+    throw new Error("MQTT broker not configured. Set channels.meshtastic.mqtt.broker or run 'openclaw onboard'.");
   }
 
   let mqttClient: MeshtasticMqttClient | null = null;

package/src/onboarding.ts

@@ -3,13 +3,17 @@ import {
   addWildcardAllowFrom,
   DEFAULT_ACCOUNT_ID,
   formatDocsLink,
-  promptAccountId,
-  promptChannelAccessConfig,
-  type ChannelOnboardingAdapter,
-  type ChannelOnboardingDmPolicy,
   type DmPolicy,
   type WizardPrompter,
-} from "openclaw/plugin-sdk";
+} from "openclaw/plugin-sdk/irc";
+import {
+  promptAccountId,
+  promptChannelAccessConfig,
+} from "openclaw/plugin-sdk/matrix";
+import type {
+  ChannelSetupAdapter as ChannelOnboardingAdapter,
+  ChannelSetupDmPolicy as ChannelOnboardingDmPolicy,
+} from "openclaw/plugin-sdk/setup";
 import {
   listMeshtasticAccountIds,
   resolveDefaultMeshtasticAccountId,

package/src/send.ts

@@ -1,6 +1,6 @@
 import { randomUUID } from "node:crypto";
 
-import { stripMarkdown } from "openclaw/plugin-sdk";
+import { stripMarkdown } from "openclaw/plugin-sdk/text-runtime";
 
 import { resolveMeshtasticAccount } from "./accounts.js";
 import { hexToNodeNum, normalizeMeshtasticMessagingTarget } from "./normalize.js";
@@ -53,7 +53,7 @@ export async function sendMessageMeshtastic(
   if (!account.configured) {
     throw new Error(
       `Meshtastic is not configured for account "${account.accountId}". ` +
-        `Run 'openclaw setup' or set channels.meshtastic.transport and connection details in config.`,
+        `Run 'openclaw onboard' or set channels.meshtastic.transport and connection details in config.`,
     );
   }
 

package/src/types.ts

@@ -1,5 +1,5 @@
-import type { BaseProbeResult } from "openclaw/plugin-sdk";
 import type {
+  BaseProbeResult,
   BlockStreamingCoalesceConfig,
   DmConfig,
   DmPolicy,
@@ -8,7 +8,7 @@ import type {
   GroupToolPolicyConfig,
   MarkdownConfig,
   OpenClawConfig,
-} from "openclaw/plugin-sdk";
+} from "openclaw/plugin-sdk/irc";
 
 export type MeshtasticChannelConfig = {
   requireMention?: boolean;