Loading...
Loading...
Connect WeChat to AI agents (Claude, Codex, Gemini, Kimi, etc.) using the WeClaw bridge in Go.
npx skill4agent add aradotso/trending-skills weclaw-wechat-ai-bridgeSkill by ara.so — Daily 2026 Skills collection.
# 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 startweclaw 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"
}
}
}| Variable | Purpose |
|---|---|
| Override default agent at runtime |
| Change local HTTP API address (default |
| HTTP agent endpoint |
| HTTP agent API token |
| Mode | Process model | Best for |
|---|---|---|
| Long-running subprocess, JSON-RPC over stdio | Claude, Codex, Kimi, Gemini — fastest, session reuse |
| New process per message, | |
| OpenAI-compatible | Any REST-accessible model |
acpcli| Command | Action |
|---|---|
| Send to default agent |
| Route to named agent |
| Use alias ( |
| Switch default agent to Claude (persisted) |
| Show active agent info |
| List available commands |
| Alias | Agent |
|---|---|
| claude |
| codex |
| cursor |
| kimi |
| gemini |
| opencode |
| openclaw |
# Send plain text
weclaw send --to "user_id@im.wechat" --text "Hello from WeClaw"
# Send an image
weclaw send --to "user_id@im.wechat" --media "https://example.com/photo.png"
# Send text + media together
weclaw send --to "user_id@im.wechat" \
--text "Check this out" \
--media "https://example.com/photo.png"
# Send a file
weclaw send --to "user_id@im.wechat" --media "https://example.com/report.pdf"127.0.0.1:18011weclaw start# Send text
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"}'
# Send image
curl -X POST http://127.0.0.1:18011/api/send \
-H "Content-Type: application/json" \
-d '{"to": "user_id@im.wechat", "media_url": "https://example.com/photo.png"}'
# Send text + media
curl -X POST http://127.0.0.1:18011/api/send \
-H "Content-Type: application/json" \
-d '{"to": "user_id@im.wechat", "text": "See this", "media_url": "https://example.com/photo.png"}'pngjpggifwebpmp4movpdfdoczipWECLAW_API_ADDR=0.0.0.0:18011 weclaw startpackage main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
"os"
)
type SendRequest struct {
To string `json:"to"`
Text string `json:"text,omitempty"`
MediaURL string `json:"media_url,omitempty"`
}
type SendResponse struct {
OK bool `json:"ok"`
Message string `json:"message,omitempty"`
}
func sendToWeChat(to, text, mediaURL string) error {
apiAddr := os.Getenv("WECLAW_API_ADDR")
if apiAddr == "" {
apiAddr = "127.0.0.1:18011"
}
req := SendRequest{To: to, Text: text, MediaURL: mediaURL}
body, err := json.Marshal(req)
if err != nil {
return fmt.Errorf("marshal: %w", err)
}
resp, err := http.Post(
fmt.Sprintf("http://%s/api/send", apiAddr),
"application/json",
bytes.NewReader(body),
)
if err != nil {
return fmt.Errorf("post: %w", err)
}
defer resp.Body.Close()
var result SendResponse
if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
return fmt.Errorf("decode: %w", err)
}
if !result.OK {
return fmt.Errorf("weclaw error: %s", result.Message)
}
return nil
}
func main() {
recipient := os.Getenv("WECHAT_RECIPIENT_ID") // e.g. "user_id@im.wechat"
if err := sendToWeChat(recipient, "Build succeeded ✅", ""); err != nil {
fmt.Fprintf(os.Stderr, "failed: %v\n", err)
os.Exit(1)
}
fmt.Println("Message sent.")
}# Build image
docker build -t weclaw .
# Step 1: Interactive login (scan QR code)
docker run -it -v ~/.weclaw:/root/.weclaw weclaw login
# Step 2: Run daemon with HTTP agent
docker run -d --name weclaw \
-v ~/.weclaw:/root/.weclaw \
-e OPENCLAW_GATEWAY_URL=https://api.example.com \
-e OPENCLAW_GATEWAY_TOKEN="$OPENCLAW_GATEWAY_TOKEN" \
weclaw
# Expose the local API externally (bind carefully — no auth by default)
docker run -d --name weclaw \
-v ~/.weclaw:/root/.weclaw \
-e WECLAW_API_ADDR=0.0.0.0:18011 \
-p 18011:18011 \
-e OPENCLAW_GATEWAY_TOKEN="$OPENCLAW_GATEWAY_TOKEN" \
weclaw
docker logs -f weclawACP/CLI agents require the agent binary inside the container. Mount the binary or build a custom image. HTTP agents work out of the box.
cp service/com.fastclaw.weclaw.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.fastclaw.weclaw.plistsudo cp service/weclaw.service /etc/systemd/system/
sudo systemctl enable --now weclaw
journalctl -u weclaw -fmake dev # Hot reload
go build -o weclaw . # Build binary
./weclaw start -f # Run in foregroundgit tag v0.1.0
git push origin v0.1.0
# GitHub Actions builds darwin/linux × amd64/arm64 and uploads release artifacts/claude/codex~/.weclaw/config.jsonweclaw send{
"claude": { "type": "cli", "command": "/usr/local/bin/claude",
"args": ["--dangerously-skip-permissions"] },
"codex": { "type": "cli", "command": "/usr/local/bin/codex",
"args": ["--skip-git-repo-check"] }
}| Symptom | Fix |
|---|---|
| QR code not appearing | Run |
| Agent not auto-detected | Check binary is on |
| Confirm |
| Agent permission prompts block responses | Add |
| Docker — no agent binary | Mount binary: |
| Markdown not rendering | WeClaw strips markdown automatically for WeChat plain-text display; this is expected |
| Logs | |