weclaw

把微信消息接进你的 AI Agent，一条命令跑通

开源 🏷️定价信息待确认 ⏳ 访问状态待核验自动化工作流 🍴 复刻 214 🐛 待处理 29 👀 关注 4

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1696

维护状态较活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类自动化工作流

开发团队fastclaw-ai

官网地址https://weclaw.im

GitHubhttps://github.com/fastclaw-ai/weclaw

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态⏳ 访问状态待核验

是否开源是

开源协议MIT

主要语言Go

技术栈/模型clawbot,openclaw,openclaw-weixin,wechat-clawbot,weclaw,weixin-agent-sdk

GitHub 星标★ 1696

上线时间2026-03-22 00:00:00

代码更新2026-11-05

仓库体积2.3 MB

本站数据更新2026-11-15

维护状态较活跃

收录时间2026-11-15

浏览次数0

项目介绍

weclaw 是一个用 Go 编写的微信与 AI Agent 连接层，目标是把微信 ClawBot 生态中的消息通道与各类 Agent 打通。它解决的核心问题是：微信本身没有开放通用的机器人接口，而各类 Agent（如 OpenClaw 系列）又需要稳定的消息入口与出口，开发者往往要自己处理协议适配、消息路由和会话保持。weclaw 把这些工作收敛为一个中间件：向上对接微信侧的消息收发，向下以统一方式连接不同 Agent 运行时，让一个 Agent 可以同时服务多个微信会话，也方便替换底层 Agent 实现。项目提供 weixin-agent-sdk 相关集成，支持消息转发、会话上下文传递等基础能力，适合做客服助手、群内自动化、个人知识库问答等场景。代码以 Go 实现，部署为单二进制，资源占用低，便于在自有服务器上长期运行。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-11-15 · 当前星标 ★ 1696

技术标签

openclaw

使用教程

难度：入门约 10 分钟部署方式：命令行工具 8 步

环境要求

一台可运行命令行工具的 Linux/macOS 机器（Docker 方式需先装好 Docker）
已安装至少一个 AI Agent 命令行程序（如 Claude、Codex、Hermes、Gemini、Kimi），供自动探测
手机微信客户端，用于首次启动时扫描二维码登录
配置与日志目录 ~/.weclaw，需要可写权限

安装与启动步骤

1一键安装

执行官方安装脚本下载并安装 weclaw 可执行文件到系统路径，安装后即可在终端直接调用。
```
curl -sSL https://raw.githubusercontent.com/fastclaw-ai/weclaw/main/install.sh | sh
```
2或用 Go 安装

已有 Go 环境时可用 go install 方式安装，效果与安装脚本一致，二选一即可。
```
go install github.com/fastclaw-ai/weclaw@latest
```
3或用 Docker 运行

Docker 方式需把宿主机的 ~/.weclaw 挂载到容器内，否则登录状态与配置不会保留。
```
docker run -it -v ~/.weclaw:/root/.weclaw ghcr.io/fastclaw-ai/weclaw start
```
4启动并扫码登录

首次启动会展示二维码，用微信扫码完成登录，随后自动探测已安装的 Agent 并写入配置文件。
```
weclaw start
```
5前台调试启动

排查问题时用 -f 在前台运行，日志会直接输出到终端，默认则是后台运行。
```
weclaw start -f
```
6查看运行状态

确认进程是否在运行；日志写入 ~/.weclaw/weclaw.log，可据此判断消息收发是否正常。
```
weclaw status
```
7添加更多微信账号

需要让多个微信号接入同一实例时，执行 login 再扫一次码即可追加账号。
```
weclaw login
```
8更新到最新版本

更新命令会拉取最新版本，若实例正在运行会自动重启生效。
```
weclaw update
```

关键配置

配置项	必填	说明	示例
`default_agent`	是	指定默认使用哪个 Agent 处理微信消息，值为 agents 下的键名	`claude`
`agents.<名称>.type`	是	Agent 接入类型，ACP 为常驻子进程 JSON-RPC，http 为直接调接口	`acp`
`agents.<名称>.command`	是	ACP 模式下要启动的 Agent 可执行文件路径，需为绝对路径或已在 PATH 中	`/usr/local/bin/claude-agent-acp`
`agents.<名称>.env`	是	传给该 Agent 进程的环境变量，通常放模型服务的 API Key	`{"ANTHROPIC_API_KEY": "sk-ant-xxx"}`
`agents.<名称>.endpoint`	否	type 为 http 时使用的对话接口地址	`https://api.example.com/v1/chat/completions`
`heartbeat`	否	定时心跳配置，可设间隔、活跃时段、时区与目标微信用户 ID	`{"enabled": true, "interval": "30m", "active_hours": "09:00-`

如何确认成功

执行 weclaw status 确认进程运行中，并查看 ~/.weclaw/weclaw.log 无报错，用微信给已登录账号发消息能收到回复即成功。

常见问题

Q：首次启动卡在二维码界面怎么办？

A：首次启动必须用微信扫码登录，二维码需在有效时间内扫描；过期后重新执行 weclaw start 生成新二维码即可。

Q：没有自动识别到我的 AI Agent？

A：自动探测只覆盖已安装并能在 PATH 中找到的 Agent；可手动编辑 ~/.weclaw/config.json，在 agents 下补充 command 与 env。

Q：运行中出问题如何排查？

A：先停掉后台进程，用 weclaw start -f 前台运行观察输出，同时查看 ~/.weclaw/weclaw.log 中的错误信息。

Q：Docker 方式重启后登录状态丢失？

A：说明未挂载配置目录，启动时务必加上 -v ~/.weclaw:/root/.weclaw，把配置和登录状态持久化到宿主机。

Q：想换成别的模型或 Agent？

A：可在 config.json 中新增一个 agents 条目并修改 default_agent，或设置环境变量 WECLAW_DEFAULT_AGENT 覆盖默认值。

注意事项

项目声明仅供个人学习使用，不可用于商业用途。
首次启动会自动探测本机已安装的 AI Agent 并生成 ~/.weclaw/config.json，建议生成后再按需修改。
心跳功能需要填写真实的 target_user（微信用户 ID），否则不会向任何人发送。
MiniMax 相关环境变量用于新增一个兼容 OpenAI 接口的 Agent，已有保存的 Agent 配置不会被覆盖。

核心亮点

Go 单二进制实现，部署简单、常驻内存占用低
提供统一的 Agent 接入层，切换或并行接入不同 Agent 时改动小
围绕微信 ClawBot 生态做了消息路由与会话上下文传递，省去自行适配协议的工作

不足之处

生态较新，文档与示例覆盖度有限，遇到问题主要靠读源码
强依赖微信 ClawBot 相关协议与第三方 Agent 运行时，上游变动可能带来兼容成本
社区规模尚小，长期维护与问题响应有待观察

适用场景

个人或小团队搭建微信内的 AI 问答助手
企业客服场景中把微信消息转接到自有 Agent 处理
群聊自动化：关键词触发、消息汇总与 Agent 回复

替代项目

wechaty、openwechat、LangBot

上一篇：claude-squad

下一篇：没有了！