LinuxDo 新帖推送

标题: 使用openclaw，对openclaw-weixin在openclaw2026.3.23-2版本的修复
作者: #LeanOn
板块: #开发调优
编号: 1810202
帖子: https://linux.do/t/topic/1810202
时间: 2026-03-25 09:39:44
摘要:

openclaw新版本的升级，重构了plugin sdk：

openclaw/plugin-sdk/channel-config-schema
openclaw/plugin-sdk/account-id
openclaw/plugin-sdk/infra-runtime
openclaw/plugin-sdk/channel-runtime
openclaw/plugin-sdk/command-auth
openclaw/plugin-sdk/text-runtime
openclaw/plugin-sdk/config-runtime

查看插件入口 index.ts，发现它一上来就导入：
import { buildChannelConfigSchema } from "openclaw/plugin-sdk/channel-config-schema";

再查看宿主 openclaw 的 package exports，确认当前运行环境下并没有正确暴露这个子路径。
修复提示词

为了方便，直接交给AI修改

# 修复提示词：OpenClaw 微信插件 `openclaw-weixin` Plugin SDK 兼容性修复

你现在是在一台安装了 OpenClaw 的 Linux 机器上，目标是修复微信插件 `@tencent-weixin/openclaw-weixin`，使其能够：

1. 正常加载
2. 扫码登录成功
3. 启动微信入站监听
4. 正常接收并回复微信消息
5. 日志写入 OpenClaw 新版本兼容的主日志文件，能通过 `openclaw logs --follow` 查看

---

## 一、背景与问题特征

这类机器上常见的现象是：

- `openclaw-weixin` 已安装、已启用
- `openclaw status --deep` 里看起来 channel 存在
- 微信扫码登录似乎成功
- 但插件启动时报一串类似错误：

text
Cannot find module 'openclaw/plugin-sdk/channel-config-schema'
Cannot find module 'openclaw/plugin-sdk/account-id'
Cannot find module 'openclaw/plugin-sdk/infra-runtime'
Cannot find module 'openclaw/plugin-sdk/channel-runtime'
Cannot find module 'openclaw/plugin-sdk/command-auth'
Cannot find module 'openclaw/plugin-sdk/text-runtime'
Cannot find module 'openclaw/plugin-sdk/config-runtime'


注意：

- 宿主 `openclaw` 版本可能已经是最新
- 问题不是“版本太旧”
- 而是 **插件源码 import 的多个 `openclaw/plugin-sdk/*` 子路径，在当前宿主插件加载链中无法被正确解析**
- 宿主包内部可能存在对应 dist 文件，但插件直接按包子路径 import 会失败

---

## 二、修复原则

### 目标
不是简单降级插件，而是做一组**本地兼容补丁**，使插件在当前宿主上正常运行。

### 原则
1. **优先复用宿主真实实现**
   - 例如宿主 `dist/plugin-sdk/infra-runtime.js`
   - 例如宿主 `dist/plugin-sdk/config-runtime.js`

2. **如果宿主真实实现无法直接调用，再 fallback 本地兼容实现**

3. **路径、日志、配置写回、文件锁** 尽量对齐 OpenClaw 新版本行为

4. **高风险 SDK 子路径**（如 command-auth / text-runtime / account-id）允许保留本地兼容实现，避免再次把插件搞挂

---

## 三、需要修改的文件

默认插件路径通常是：

bash
~/.openclaw/extensions/openclaw-weixin


你需要检查并修改这些文件：

### 已修改/需要修改的文件
- `index.ts`
- `src/channel.ts`
- `src/auth/accounts.ts`
- `src/auth/pairing.ts`
- `src/util/logger.ts`
- `src/messaging/process-message.ts`
- `src/messaging/send.ts`
- `src/log-upload.ts`

### 需要新增的兼容文件
- `src/util/account-id-compat.ts`
- `src/util/command-auth-compat.ts`
- `src/util/text-runtime-compat.ts`
- `src/util/openclaw-host-compat.ts`

### 还要检查宿主配置文件
- `~/.openclaw/openclaw.json`

---

## 四、具体修改要求

### 1. 修改 `index.ts`

#### 问题
不要再依赖：

ts
openclaw/plugin-sdk/channel-config-schema


#### 修改要求
删除：

ts
import { buildChannelConfigSchema } from "openclaw/plugin-sdk/channel-config-schema";


把：

ts
configSchema: buildChannelConfigSchema(WeixinConfigSchema)


改成：

ts
configSchema: WeixinConfigSchema


---

### 2. 新增 `src/util/account-id-compat.ts`

添加一个本地账号 ID 兼容函数：

ts
export function normalizeAccountId(value: string): string {
return value.trim().replace(/@/g, "-").replace(/\./g, "-");
}


#### 用途
替代：

ts
openclaw/plugin-sdk/account-id


---

### 3. 新增 `src/util/command-auth-compat.ts`

实现一个最小可用版本，至少提供：

- `resolveSenderCommandAuthorizationWithRuntime`
- `resolveDirectDmAuthorizationOutcome`

核心逻辑要求：

- 读取 `allowFrom`
- 判断 sender 是否授权
- 只有 `/命令` 才视为 commandAuthorized
- `dmPolicy = pairing` 且未授权时返回 `unauthorized`

示意逻辑：

ts
type DmPolicy = "allow" | "pairing" | "disabled" | string;

export async function resolveSenderCommandAuthorizationWithRuntime(...) {
...
}

export function resolveDirectDmAuthorizationOutcome(...) {
...
}


---

### 4. 新增 `src/util/text-runtime-compat.ts`

实现一个轻量 `stripMarkdown(text: string)`，至少能去掉：

- 行内代码
- 标题符号
- 粗体/斜体
- 引用
- 列表符号

用于替代：

ts
openclaw/plugin-sdk/text-runtime


---

### 5. 新增 `src/util/openclaw-host-compat.ts`

这是关键文件。

这个文件要负责提供：

#### (1) `resolvePreferredOpenClawTmpDirCompat()`
要求：
- 尽量按宿主 OpenClaw `tmp-openclaw-dir` 真实逻辑实现
- 优先 `/tmp/openclaw`
- 如果不安全或不可写，再 fallback 到 `tmpdir()/openclaw[-uid]`
- 权限尽量使用 0700
- 行为尽量对齐宿主 `resolvePreferredOpenClawTmpDir`

#### (2) `withFileLockCo

3 views01:40