NewFuture/openclaw-weixin

最近记录的来源活动: 2026年8月16日 03:42

SkillsMP 收录数据更新: 2026年11月12日 12:52

已收集 skills: 3

GitHub 星标: 7
GitHub Forks: 4

用 AI 助手安装

复制这段 Prompt，发给你正在使用的 AI 助手。

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/NewFuture/openclaw-weixin.

仓库 README

仓库 README 来源：README.md

查看 README 源文件

展开完整 README

# openclaw-weixin  [English](https://openclaw-weixin.newfuture.cc/en/) · [在线文档](https://openclaw-weixin.newfuture.cc/)  **把 OpenClaw 接入微信** 社区维护的 OpenClaw 微信渠道插件，支持 npm 和 ClawHub 安装。需要 OpenClaw `>=2026.6.1`（[兼容矩阵](https://openclaw-weixin.newfuture.cc/contributing.html#openclaw-兼容矩阵)）。 <a id="connect-wechat"></a> ## 选择一种安装方式 [**复制提示词**](#agent-install) **或** [**运行命令**](#direct-install)  <a id="agent-install"></a> ### 让 OpenClaw 自动完成安装把下面这段话粘贴到 OpenClaw 聊天框并发送： ```text 用 OpenClaw 官方 CLI 后台非交互安装/更新微信社区插件到最新版：已装沿源更新，不沿用旧版本号；新装优先 clawhub:openclaw-wechat，源不可用再用 npm:openclaw-weixin。保留配置和登录态，确认在聊天中完成，最后核验版本 ```  <a id="direct-install"></a> ### 直接运行命令 **之前使用下方 ClawHub 或 npm 命令安装社区版：** 运行 `openclaw plugins update openclaw-weixin`。 **首次安装、替换腾讯官方包，或现有插件通过其他来源安装：** 从下面任选一个安装命令，无需先卸载。替换现有插件时，在所选安装命令末尾加 `--force`。配置和登录状态会保留。  <a id="clawhub-source"></a> #### ClawHub：[`openclaw-wechat`](https://clawhub.ai/newfuture/plugins/openclaw-wechat) <a id="clawhub-cli-install"></a> ```bash openclaw plugins install clawhub:openclaw-wechat ```   <a id="npm-source"></a> #### npm：[`openclaw-weixin`](https://www.npmjs.com/package/openclaw-weixin) <a id="npm-cli-install"></a> ```bash openclaw plugins install npm:openclaw-weixin ```  **如果当前 OpenClaw 已有微信登录状态，安装后通常只需确认连接。** 全新安装需要展开完整检查并扫码绑定；安装报错、未自动恢复连接或需要确认目标账号时，也在此检查。 <details id="verify-connection" class="full-check"> <summary>完整检查、扫码与恢复</summary> ### 安装命令报告版本不兼容仅在安装命令报告版本不兼容时检查： ```bash openclaw --version ``` 需要 OpenClaw `>=2026.6.1`。若版本过低或 Nix 模式禁止安装，请不要卸载现有插件；按 [安装限制与故障排查](https://openclaw-weixin.newfuture.cc/guide.html#安装限制)处理。 ### 安装后没有自动连接安装可能使启用了配置重载的受管 Gateway 自动重载。若仍未连接，请重启实际承载 OpenClaw 的服务、容器或 Pod，然后执行： ```bash openclaw plugins list openclaw channels status --probe ``` **满足以下条件即表示连接成功：** - `openclaw plugins list` 显示插件已启用，并且没有加载错误。 - `openclaw channels status --probe` 对目标微信账号探测成功。 - 使用多账号时，探测结果对应你准备使用的别名或账号 ID。 | 检查结果 | 下一步 | | --- | --- | | 插件显示已停用 | 执行 `openclaw plugins enable openclaw-weixin`，重载 Gateway，然后重新探测 | | 插件无加载错误，且目标账号探测成功 | 已完成，无需继续操作 | | 账号显示未登录 | 继续下面的扫码绑定 | | Channel 显示 `OK` 但未连接 | 按[连接故障排查](https://openclaw-weixin.newfuture.cc/guide.html#channel-显示-ok-但未连接)重载实际运行单元 | <a id="bind-account"></a> ### 状态显示未登录仅在探测显示目标账号未登录时执行： ```bash openclaw plugins enable openclaw-weixin openclaw channels login --channel openclaw-weixin ``` 登录命令会在终端显示二维码。扫码并等待登录完成，然后再次执行： ```bash openclaw channels status --probe ``` </details> ## 多账号如果会同时使用多个微信账号，建议先按「账号 + 渠道 + 对端」隔离私聊上下文： ```bash openclaw config set session.dmScope per-account-channel-peer ``` 这是 OpenClaw 的全局会话设置，会影响所有渠道；它不影响账号登录，只决定之后收到的私聊消息如何分配会话。再次执行登录命令即可绑定其他微信账号。建议为每个号使用**稳定别名**，以便 `openclaw.json` / bindings 用可读 `accountId`（而不是仅服务端 hash）： ```bash openclaw channels login --channel openclaw-weixin --account wukong openclaw channels login --channel openclaw-weixin --account nezha ``` <details> <summary>账号 ID 与状态文件</summary> 登录成功后会写入： - `openclaw-weixin/accounts/<ilink_bot_id 规范化>.json`（凭证与状态命名空间；`listAccountIds` / monitor 只用此 id） - `openclaw-weixin/account-aliases.json`（一对一 `alias → hash` 逻辑映射，供 bindings / 出站解析；别名不会再起一条 transport）未传 `--account` 时（宿主会传入 `default` 哨兵）只索引服务端 bot id，不会创建名为 `default` 的账号。已绑定过的 hash 账号再执行 `login --account <alias>` 时，会在不歧义的情况下登记别名映射（不在线改名、不搬迁状态命名空间）。凭证、账号 ID 和 context token 均为敏感数据；不要共享 `~/.openclaw/openclaw-weixin/` 下的状态文件。 </details> ## 主动与定时发送微信后端要求每条出站消息携带由该收件人入站消息下发的账号级 context token。插件收到消息后会按账号保存该 token： - 尚未收到该收件人的消息或 token 缺失时，插件会拒绝发送消息，不会返回本地“成功” 结果。 - 已保存的 token 仍可能失效；长时间无交互后发送失败时，请让收件人先向对应 bot 发送一条消息以刷新 token，再重试。多账号部署的定时任务应同时显式设置 `delivery.to` 和 `delivery.accountId`。未指定 `accountId` 时，只有恰好能从账号级上下文选出一个账号才会发送；缺失或歧义都会失败。 context token 属于敏感数据，不要跨账号复制或写入任务配置。 ## 文档与支持 - [详细指南](https://openclaw-weixin.newfuture.cc/guide.html)：安装行为、可选配置、主动发送限制、卸载和故障排查 - [社区版与腾讯版](https://openclaw-weixin.newfuture.cc/distributions.html) - [后端 API 协议](https://openclaw-weixin.newfuture.cc/backend-api.html) - [架构说明](https://openclaw-weixin.newfuture.cc/architecture.html) - [参与贡献与 Agent 工作流](https://openclaw-weixin.newfuture.cc/contributing.html)：开 Issue、修复 Bug 和开发新功能 - [Coding Agent 指引](https://github.com/NewFuture/openclaw-weixin/blob/main/AGENTS.md) - [变更日志](https://openclaw-weixin.newfuture.cc/changelog.html) - [安全策略](https://openclaw-weixin.newfuture.cc/security.html) - [问题反馈](https://github.com/NewFuture/openclaw-weixin/issues) - [llms.txt](https://openclaw-weixin.newfuture.cc/llms.txt)：面向智能体的文档索引

正在加载仓库 README…

这个仓库中的 skills

软件开发工程师

1 个职业分类 · 已分类 100%

skill

职业分类

描述

更新

release-preparation

软件开发工程师

Prepare a narrow openclaw-weixin version release pull request without publishing or changing release automation.

原文语言：英语

2026-08-16

openclaw-host-compatibility

软件开发工程师

Review, implement, or test openclaw-weixin changes involving OpenClaw SDK imports or exported subpaths, host APIs, plugin registration, entry points, peer or minimum host versions, build output, packaging, or compatibility claims.

原文语言：英语

2026-08-07

stateful-message-processing

软件开发工程师

Review, implement, or test openclaw-weixin changes involving persistent or account-scoped state, context or dedupe keys, claims, locks, monitor admission lanes, retries, abort handling, migrations, or resource cleanup.

原文语言：英语

2026-08-07

已展示 3 / 3 个已收集 Skill。