cp0204/weclawbot-api repository overview

⁠WeClawBot-API

一个基于 Go 实现的 微信ClawBot (iLink) 机器人 API 服务。

它体积极小(≈10MB)，内存占用极低(≈10MB)，极易部署(Docker/二进制)，可以独立运行，直接提供 HTTP API 给其他程序调用。

⁠功能特性

• 多账号支持：支持同时登录多个微信号，每个账号独立推送、互不干扰
• 扫码登录：控制台直接打印二维码，微信扫码即可完成授权
• 持久化存储：登录凭证（Token、游标等）自动保存，重启后自动重连
• 命令行交互：内置简易控制台，可直接在终端中收发微信消息
• HTTP API：提供标准 RESTful 接口，支持通过 API 发送文本消息及设置“正在输入”状态

⁠部署

⁠Docker Compose (推荐)

创建 docker-compose.yml 文件：

name: weclawbot-api
services:
  weclawbot-api:
    image: cp0204/weclawbot-api:latest
    container_name: weclawbot-api
    ports:
      - "26322:26322"
    volumes:
      - ./config:/app/config
    restart: unless-stopped

⁠Docker Run

docker run -d \
  --name weclawbot-api \
  -p 26322:26322 \
  -v ./config:/app/config \
  --restart unless-stopped \
  cp0204/weclawbot-api:latest

⁠初次扫码登录

容器启动后，进入容器终端(sh)，输入 weclawbot-api 扫码登录，授权后的信息将保存在挂载的 config 目录下。

NAS 部署可通过 WebUI 进入容器终端，也可以在宿主机上通过以下命令进入：

# 进入容器终端
docker exec -it weclawbot-api sh
# 运行 weclawbot-api
weclawbot-api

⁠常用命令

• /login : 发起新的扫码登录流程
• /bots : 列出当前所有已登录 bot_id 及其 api_token
• /bot <序号> : 切换当前活跃发送身份
• /del <序号> : 删除指定索引的 Bot 账号配置

⁠API 文档

API 支持 GET 和 POST 请求，兼容以下多种提交方式：

• GET
• POST
  • application/json
  • application/x-www-form-urlencoded
  • multipart/form-data

⁠身份验证

所有接口均需验证 api_token（可通过 /bots 命令或查看 config/auth.json 获取）

你可以通过以下任一方式传递 Token：

• Header: Authorization: Bearer <api_token>
• Body/Query: token=<api_token>

⁠发送消息

Endpoint: /bots/{bot_id}/messages

参数:

• text: 消息文本内容。

示例:

curl http://192.168.8.8:26322/bots/{[email protected]}/messages?token={api_token}&text=Hello

⁠发送输入状态

Endpoint: /bots/{bot_id}/typing

参数:

• status: 1=正在输入，2=停止输入

示例:

curl http://192.168.8.8:26322/bots/{[email protected]}/typing?token={api_token}&status=1

⁠响应格式

所有 API 均返回标准 JSON 结构：

成功响应 (200 OK):

{
  "code": 200,
  "message": "OK"
}

错误响应 (4xx/5xx):

{
  "code": 401,
  "error": "Unauthorized"
}

⁠致谢

• 微信官方插件 @tencent-weixin/openclaw-weixin⁠