cluic

wxauto

商業營運v1.0.0
作者:cluic更新於 2026-05-18@clawhub_cluic/wxauto
客服助手使用者營運#发送消息#微信#消息

據 AlphaMoat 統計,截至 2026-10,wxauto 累計下載 8,917 次、獲 11 個星標,按累計下載量在本次參與排名的 10,914 個 AI 技能中排名第 3,117 位,在「商業營運」分類(873 個)中排名第 255 位。

列表預設按累計下載量排序,也可按星標排序;詳情頁排名按累計下載量計算。

累計下載
8917
星標
11
全站下載量排名
#3,117
全站前 29% · 「商業營運」前 30%
平台累計下載星標評論
ClawHub ↗15192-
SkillHub ↗891711—

各平台的計數口徑不同,統計時間不一致。

這個技能是做什麼的

走 wxautox4 的本地介面,可發訊息給好友或群聊、讀聊天記錄、監聽新訊息,並管理好友與群列表。呼叫用 Bearer Token 認證,地址與令牌在 config.yaml 裡配置,預設指向本機服務。 保護 Bearer token;傳送訊息或接受好友申請前確認對象與內容。

資料釋出於 2026-10-27

可以用來做什麼

  • 給指定好友或群發通知
  • 匯出某段聊天記錄做整理

什麼時候用

  • 要在本機微信上做訊息收發自動化時
  • 需要監聽新訊息並觸發後續處理時

示例提示詞

以下是根據技能文件生成的示例,不代表實際執行結果。

給這個群發一條通知,內容我隨後給
把這個好友最近的聊天記錄匯出來

月度資料趨勢

累計下載8917
1020526195022026-03 · 累計下載 16052026-05 · 累計下載 29642026-07 · 累計下載 35012026-08 · 累計下載 39772026-09 · 累計下載 51522026-10 · 累計下載 891726-0326-0926-10
星標11
17122026-03 · 星標 22026-05 · 星標 62026-07 · 星標 102026-08 · 星標 112026-09 · 星標 112026-10 · 星標 1126-0326-0926-10

2026-09 起統計方法調整:同名技能按作者分別統計,並覆蓋全部技能。圖中虛線為調整前的月份,與之後的資料不直接比較,也不計算跨越調整的增長。

月份累計下載環比星標
2026-108917—11
2026-095152—11
2026-083977+13.6%11
2026-073501—10
2026-052964—6
2026-031605—2

SKILL.md 原文

以下是作者釋出的原始檔案,按純文字顯示,本站未做修改或稽核;其中的連結不可點選,命令請核實後再執行。抓取於 2026-10-23。

7.0 KB · ClawHub v1.0.0
---
name: wxauto
description: "微信自动化操作。通过 wxautox4 RESTful API 实现发送消息、获取聊天记录、监听消息、好友管理等功能。Use when: (1) 发送微信消息给好友或群聊,(2) 读取微信聊天记录,(3) 监听新消息,(4) 获取好友列表或群聊列表,(5) 接受好友申请,(6) 切换聊天窗口等微信操作。"
metadata:
  {
    "openclaw":
      {
        "emoji": "💬",
        "requires": { "bins": ["python"] },
        "install":
展開全部(共 290 行)
          [
            {
              "id": "pip-wxautox4",
              "kind": "pip",
              "package": "wxautox4",
              "label": "Install wxautox4 (pip)",
            },
          ],
      },
  }
---

# 微信自动化

通过本地 HTTP 服务操作微信,支持消息收发、监听、好友管理等功能。

## 前置要求

1. **安装 wxautox4**:
   
   ```bash
   pip install wxautox4
   ```
   
   > 注意:需windows系统,python3.9,3.10,3.11,3.12 64位,其他python版本暂不支持
   
2. **激活 wxautox4**:

   ```bash
   wxautox4 -a your-activation-code
   ```

   > 获取:https://docs.wxauto.org/plus

3. **部署 API 服务**:

   - 克隆项目:https://github.com/cluic/wxauto-restful-api
   - 配置 `config.yaml`
   - 启动服务:`python run.py`

## 服务配置

- 认证:Bearer Token(见 `config.yaml` 的 `auth.token`,默认值为 `token`)
- 服务状态文件:`~/.wxautox/service_status.json`(服务启动时自动生成,请查看该文件获取服务信息)

### 自动配置检测

服务启动后会自动将运行信息写入 `~/.wxautox/service_status.json`。wxapi.py 脚本会:
1. 自动读取此文件获取连接配置
2. 验证服务是否真的在运行(通过 API 健康检查)
3. 如果服务未运行,自动启动服务(需要服务目录存在)

服务目录搜索顺序:
- `../wxauto-restful-api`(相对于 skill 目录)
- `~/wxauto-restful-api`
- `WXAPI_SERVICE_DIR` 环境变量指定的路径

### 手动配置方式(可选)

如果需要覆盖自动配置,优先级从高到低:

1. **命令行参数**
   ```powershell
   python wxapi.py --base-url "http://localhost:9000" --token "my-token" send "好友" "消息"
   ```

2. **环境变量**
   
   ```powershell
   $env:WXAPI_BASE_URL = "http://localhost:9000"
   $env:WXAPI_TOKEN = "my-token"
   # 或者
   $env:WXAPI_PORT = "9000"
   $env:WXAPI_SERVICE_DIR = "/path/to/wxauto-restful-api"
   ```

3. **service_status.json** - 自动检测(推荐)

4. **config.yaml** - 服务目录下的配置文件

5. **默认值** - `http://localhost:8000`, token 为 `token`

## 启动服务

首次使用前需要启动服务:

```powershell
# 进入服务目录
cd /path/to/wxauto-restful-api
```

# 启动服务
```
python run.py
```

或后台启动(Windows):

```powershell
Start-Process python -ArgumentList "run.py" -WorkingDirectory "C:\path\to\wxauto-restful-api" -WindowStyle Hidden
```

如果服务已运行,脚本会自动连接;如果服务未运行且配置了服务目录,脚本会自动启动服务。

## 脚本路径

Python 调用脚本位于 skill 目录下的 `scripts/wxapi.py`。

使用 `{baseDir}` 引用 skill 目录:
```powershell
python "{baseDir}/scripts/wxapi.py" send "好友" "消息"
```

## 可用命令

### 初始化和状态

```powershell
# 初始化微信实例
python wxapi.py init

# 获取服务状态
python wxapi.py status

# 检查是否在线
python wxapi.py online

# 获取我的信息
python wxapi.py myinfo
```

### 发送消息

```powershell
# 主窗口发送
python wxapi.py send "好友名" "消息内容"

# 精确匹配
python wxapi.py send "好友名" "消息内容" --exact

# @群成员
python wxapi.py send "群名" "开会了" --at "张三,李四"

# 子窗口发送
python wxapi.py send-chat "好友名" "消息内容"
```

### 读取消息

```powershell
# 获取聊天记录(主窗口)
python wxapi.py getmsg "好友名"

# 获取聊天记录(子窗口)
python wxapi.py getmsg-chat "好友名"

# 获取历史消息
python wxapi.py history "好友名" --count 100

# 获取新消息(主窗口轮询)
python wxapi.py newmsg

# 获取新消息(子窗口)
python wxapi.py newmsg-chat "好友名"
```

### 监听管理

```powershell
# 添加监听(打开子窗口)
python wxapi.py listen "好友名"
```

### 会话管理

```powershell
# 获取会话列表
python wxapi.py session

# 获取所有子窗口
python wxapi.py windows

# 切换聊天窗口
python wxapi.py chatwith "好友名" --exact
```

### 获取列表

```powershell
# 好友列表
python wxapi.py friends

# 群聊列表
python wxapi.py groups
```

### 页面控制

```powershell
# 切换到聊天页面
python wxapi.py switch-chat

# 切换到联系人页面
python wxapi.py switch-contact
```

### 查看帮助

```powershell
python wxapi.py --help
```

## API 接口列表

根据 wxauto-restful-api 服务:

### 微信功能接口

| 接口 | 说明 |
|------|------|
| `POST /v1/wechat/initialize` | 初始化微信实例 |
| `GET /v1/wechat/status` | 获取微信状态 |
| `POST /v1/wechat/send` | 发送消息 |
| `POST /v1/wechat/sendfile` | 发送文件 |
| `POST /v1/wechat/sendurlcard` | 发送 URL 卡片 |
| `POST /v1/wechat/getallmessage` | 获取当前窗口消息 |
| `POST /v1/wechat/gethistorymessage` | 获取历史消息 |
| `POST /v1/wechat/getnextnewmessage` | 获取新消息 |
| `POST /v1/wechat/getsession` | 获取会话列表 |
| `POST /v1/wechat/getsubwindow` | 获取指定子窗口 |
| `POST /v1/wechat/getallsubwindow` | 获取所有子窗口 |
| `POST /v1/wechat/chatwith` | 切换聊天窗口 |
| `POST /v1/wechat/getfriends` | 获取好友列表 |
| `POST /v1/wechat/getmyinfo` | 获取我的信息 |
| `POST /v1/wechat/getrecentgroups` | 获取群聊列表 |
| `POST /v1/wechat/switch/chat` | 切换到聊天页面 |
| `POST /v1/wechat/switch/contact` | 切换到联系人页面 |
| `POST /v1/wechat/isonline` | 检查在线状态 |

### 聊天接口(子窗口)

| 接口 | 说明 |
|------|------|
| `POST /v1/chat/send` | 子窗口发送消息 |
| `POST /v1/chat/getallmessage` | 获取子窗口所有消息 |
| `POST /v1/chat/getnewmessage` | 获取子窗口新消息 |
| `POST /v1/chat/msg/quote` | 发送引用消息 |
| `POST /v1/chat/close` | 关闭子窗口 |

## 直接 API 调用(备选)

如需直接调用 HTTP API,用 Python(不要用 PowerShell,有中文编码问题):

```python
import requests

headers = {"Authorization": "Bearer token", "Content-Type": "application/json"}
body = {"who": "好友名", "msg": "消息内容"}
resp = requests.post("http://localhost:8000/v1/wechat/send", headers=headers, json=body)
print(resp.json())
```

## 响应格式

所有 API 返回统一格式:
```json
{
  "success": true,
  "message": "操作成功",
  "data": { ... }
}
```

## 注意事项

1. 微信客户端需要保持打开状态
2. wxautox4 需要激活后才能使用
3. **不要用 PowerShell 直接调用 API**(中文编码问题),请使用 Python 脚本
4. 修改 `config.yaml` 中的 `auth.token` 以增强安全性

「商業營運」分類下的熱門技能

標書寫作專家【百鍊標書】商業營運

百鍊®標書是一個面向投標場景標書寫作的skill,可以幫使用者完成四件事:解讀招標檔案、生成投標檔案、審查投標檔案合規風險以及標書查重。它適合用自然語言直接寫作,使用者只要提供檔案和需求,就能拿到解讀結果、成品標書、審查報告、查重報告。百鍊®標書官網:https://biaoshu.zhiliaobiaoxun.com

↓ 70.7萬★ 61u_62be253f
AdMapix廣告投放工具商業營運

AdMapix廣告原始資料層,廣告創意/應用/排名/下載收入

↓ 30.9萬★ 1u_8ee34d77
全國招標中標查詢及分析【知了標訊】商業營運

知了標訊:查詢和分析招標、中標、供應商與採購市場資訊。

↓ 21.4萬★ 14user_98035bfb
招標中標查詢及分析服務商業營運

透過知了標訊介面查詢和分析招投標相關資訊。

↓ 12.1萬★ 16user_98035bfb
標書審查【喜鵲標書】商業營運

喜鵲標書審查|讓投標風險看得見、查得清、改得準 投標檔案準備好了,還有哪些遺漏和隱患?喜鵲標書審查對照招標要求,檢查投標檔案中的響應缺漏、內容矛盾和潛在風險,幫助您在提交前發現問題、明確修改重點。 - 問題一目瞭然:區分已確認風險與待核實事項,清晰呈現問題位置、具體表現及潛在影響。 - 審查有據可查:關聯招標條款與投標內容,讓您看清“要求是什麼、哪裡存在問題、判斷依據是什麼”。 - 原文快速定位:結合頁碼、檢索線索和證據截圖,減少來回翻找,方便逐項核對。 - 完整報告可交付:提供 Word 審查報告及審查版 PDF,便於團隊複核、修改和留檔。 支援 PDF、DOCX 及多附件審查。先檢查檔案,再展示價格並按次付費;支援隨時查詢進度、繼續已付款任務和補領報告,讓每一次審查都有清晰結果。 https://www.xiquebiaoshu.com/?source=skillhub](https://www.xiquebiaoshu.com/?source=bid-review-pay

↓ 10.5萬★ 1u_84923c62
PollyReach商業營運

為 AI agent 提供電話號碼並代辦電話事務的技能。

↓ 10.2萬★ 56PollyReach
商品圖商業營運

將真實產品照片製作成影棚級電商主圖、場景圖或面向市場平台的高畫質商品圖。這款 AI 商品圖工作室用於商品圖片處理和電商圖片編輯,可替換背景、改善光效、搭建場景。它以原圖中的商品外觀特徵為依據,從一張手機隨拍就能做出白底主圖、生活場景圖和高階廣告圖。適用於亞馬遜白底產品圖、淘寶主圖、Shopify 產品大圖和社交媒體商品圖。從一張產品照片出發,組合多張參考圖,或在選定草稿上做定向精修,完成適合上架使用的成品;生活場景圖和廣告圖也能直接用作商品詳情頁圖片。

↓ 10.2萬★ 10user_87b8e34f
會員體系搭建商業營運

【零一數科·出品】會員體系搭建(免費版)。為私域使用者設計會員體系搭建,產出會員等級成長表、積分獲取消耗規則表、權益配置矩陣、積分財務測算表四件套。適用於會員積分體系設計、會員等級階梯、成長值規則、權益配置、積分獲取與消耗、積分財務測算、私域會員營運。

↓ 9.7萬★ 8u_c19e970c

資料月份:2026-10 · 下載/星標數聚合自公開技能註冊庫(ClawHub、SkillHub),按月更新。口徑說明見資料方法。