weclaw-wechat-ai-bridge

用途

WeClaw（WeChat AI Agent Bridge）用于把微信连接到各类 AI 智能体（Claude、Codex、Gemini、Kimi、OpenClaw 等）。它基于 Go 实现，负责处理扫码登录、消息路由、媒体转换和智能体生命周期管理。

主要能力

微信扫码登录，支持添加或重新认证微信账号。
三种智能体接入模式：
- acp：常驻子进程，基于 stdio 的 JSON-RPC，适配 Claude、Codex、Kimi、Gemini，速度最快并支持会话复用。
- cli：每条消息新建进程，可用 --resume 保持会话。
- http：兼容 OpenAI 的 /v1/chat/completions 接口，适用于任何可通过 REST 访问的模型。
当同时存在 acp 与 cli 二进制时，自动检测优先选择 acp。
微信聊天命令：hello（发送到默认智能体）、/codex ...（路由到指定智能体）、/cc ...（使用别名）、/claude（切换默认智能体并持久化）、/status、/help。
内置别名：/cc→claude、/cx→codex、/cs→cursor、/km→kimi、/gm→gemini、/ocd→opencode、/oc→openclaw。
主动消息推送：通过 weclaw send 命令行或本地 HTTP API（默认监听 127.0.0.1:18011）向微信发送纯文本、图片或文件；支持文本与媒体同时发送。
媒体处理：若智能体回复中包含 ![alt](https://...)，WeClaw 会自动下载、AES-128-ECB 加密、上传到微信 CDN，并以原生图片消息发送，无需额外配置。

安装与使用方式

安装方式：

# One-line installer
curl -sSL https://raw.githubusercontent.com/fastclaw-ai/weclaw/main/install.sh | sh

# Via Go toolchain
go install github.com/fastclaw-ai/weclaw@latest

# Via Docker
docker run -it -v ~/.weclaw:/root/.weclaw ghcr.io/fastclaw-ai/weclaw start

首次运行流程：

weclaw start        # Shows QR code → scan with WeChat → auto-detects agents → saves config
weclaw login        # Add/re-authenticate a WeChat account
weclaw status       # Show running state and active agent
weclaw stop         # Stop the background daemon
weclaw start -f     # Foreground mode (debug/verbose)

日志位于 ~/.weclaw/weclaw.log，配置位于 ~/.weclaw/config.json。

配置示例：

{
  "default_agent": "claude",
  "agents": {
    "claude": {
      "type": "acp",
      "command": "/usr/local/bin/claude-agent-acp",
      "model": "sonnet"
    },
    "codex": {
      "type": "acp",
      "command": "/usr/local/bin/codex-acp"
    },
    "claude-cli": {
      "type": "cli",
      "command": "/usr/local/bin/claude",
      "args": ["--dangerously-skip-permissions"]
    },
    "codex-cli": {
      "type": "cli",
      "command": "/usr/local/bin/codex",
      "args": ["--skip-git-repo-check"]
    },
    "openclaw": {
      "type": "http",
      "endpoint": "https://api.example.com/v1/chat/completions",
      "api_key": "$OPENCLAW_GATEWAY_TOKEN",
      "model": "openclaw:main"
    }
  }
}

环境变量：WECLAW_DEFAULT_AGENT（运行时覆盖默认智能体）、WECLAW_API_ADDR（修改本地 HTTP API 地址，默认 127.0.0.1:18011）、OPENCLAW_GATEWAY_URL（HTTP 智能体端点）、OPENCLAW_GATEWAY_TOKEN（HTTP 智能体 API token）。

主动推送示例（命令行）：

# 发送纯文本
weclaw send --to "user_id@im.wechat" --text "Hello from WeClaw"

# 发送图片
weclaw send --to "user_id@im.wechat" --media "https://example.com/photo.png"

# 同时发送文本与媒体
weclaw send --to "user_id@im.wechat" \
  --text "Check this out" \
  --media "https://example.com/photo.png"

主动推送示例（HTTP API）：

curl -X POST http://127.0.0.1:18011/api/send \
  -H "Content-Type: application/json" \
  -d '{"to": "user_id@im.wechat", "text": "Hello from WeClaw"}'

支持的媒体类型：png、jpg、gif、webp、mp4、mov、pdf、doc、zip。修改监听地址：WECLAW_API_ADDR=0.0.0.0:18011 weclaw start。

Docker：可先 docker build -t weclaw .，再交互式执行 docker run -it -v ~/.weclaw:/root/.weclaw weclaw login 扫码登录，随后以守护方式运行。ACP/CLI 智能体需要容器内存在对应二进制，可通过挂载或自定义镜像解决；HTTP 智能体开箱即用。

系统服务（开机自启）：macOS 使用 launchd（com.fastclaw.weclaw.plist），Linux 使用 systemd（weclaw.service）。

开发：make dev（热重载）、go build -o weclaw .（构建二进制）、./weclaw start -f（前台运行）。发布通过打 tag 推送，GitHub Actions 构建 darwin/linux × amd64/arm64 产物。

适用场景

通过微信与 AI 智能体对话，或在微信内路由到不同智能体。
按用户切换默认智能体（发送 /claude 或 /codex，选择持久化在 ~/.weclaw/config.json）。
CI/CD 构建通知：构建完成后调用 weclaw send 或 HTTP API 推送结果到微信联系人或群组。
智能体回复中的图片自动转换为微信原生图片消息。
无头使用：为 CLI 智能体配置 --dangerously-skip-permissions（Claude）或 --skip-git-repo-check（Codex）以禁用权限提示；ACP 智能体自动处理权限，无需这些参数。

限制与注意事项

本地 HTTP API 默认无认证，暴露到外部时需谨慎绑定。
Docker 中的 ACP/CLI 智能体需要镜像内存在对应二进制。
WeClaw 会自动移除 Markdown，以适配微信纯文本显示，这是预期行为。
常见问题排查方向：二维码不显示（显式执行 weclaw login，终端需支持 UTF-8）、智能体未被自动检测（检查二进制是否在 $PATH）、HTTP API 连接被拒绝（确认 weclaw start 在运行并检查 WECLAW_API_ADDR）、权限提示阻塞回复（添加相应参数或使用 ACP 模式）。

本条目未提供的信息（如收费、价格、具体平台支持范围等）暂未提供。

技能介绍

用途

主要能力

安装与使用方式

适用场景

限制与注意事项