Files
Obsidian/MyBestNanobot/Nanobot对接微信.md
coco 8b94d76799 a
2026-07-21 13:57:15 +08:00

27 KiB
Raw Permalink Blame History

执行命令,,,每次都需要扫码那种(机器人说这样避免封号) cd /home/ubuntu/nanocode/weixin-nanobot-bridge && ./start-weixin.sh

我安装了1个库

sudo npm install -g weixin-agent-sdk https://github.com/wong2/weixin-agent-sdk ,感受一下,这个项目能不能在nanobot中使用? 能不能通过微信来连接nanobot。



我来详细介绍这个微信连接方案的技术原理和实现。

🔍 技术原理

1. weixin-agent-sdk 工作机制

┌─────────────────────────────────────────────────────────────┐
│                    微信服务器 (WeChat Server)                  │
│                    (微信官方消息网关)                          │
└───────────────────────────┬─────────────────────────────────┘
                            │
                            ▼ (长轮询/消息推送)
┌─────────────────────────────────────────────────────────────┐
│                   weixin-agent-sdk (Node.js)                 │
│  - 模拟微信 iPad 协议                                         │
│  - AES-128-ECB 加密通信                                       │
│  - 自动下载媒体文件 (图片/语音/视频)                           │
│  - 维持长连接接收消息                                         │
└───────────────────────────┬─────────────────────────────────┘
                            │ (JavaScript Agent 接口)
                            ▼
┌─────────────────────────────────────────────────────────────┐
│                     Bridge Adapter (Node.js)                 │
│  - 实现 Agent.chat(request) => Promise<response>            │
│  - HTTP POST 转发到桥接服务                                   │
└───────────────────────────┬─────────────────────────────────┘
                            │ (HTTP API)
                            ▼
┌─────────────────────────────────────────────────────────────┐
│              WeChat-Nanobot Bridge (Python/Flask)            │
│  - 接收微信消息                                               │
│  - 会话管理 + 安全控制                                        │
│  - 调用 nanobot 生成回复                                      │
└─────────────────────────────────────────────────────────────┘

2. 数据流转过程

接收消息:

微信用户发送 "你好"
    ↓
weixin-agent-sdk 接收加密消息,解密
    ↓
调用 agent.chat({
    conversationId: "wx_user_123",
    text: "你好",
    media: null
})
    ↓
axios.post('http://129.211.173.87:5000/chat', {...})
    ↓
Flask 服务接收,验证安全
    ↓
nanobot agent -m "系统提示 + 用户消息" 
    ↓
返回 AI 回复
    ↓
层层返回给微信用户


🛠️ 我做的适配工作

适配 1: 协议转换层

问题: weixin-agent-sdk 要求实现 JavaScript Agent 接口,但 nanobot 是 Python 命令行工具

解决: 创建双层架构

  • Node.js 层: 实现 Agent 接口,负责与微信通信
  • Python 层: Flask HTTP 服务,负责调用 nanobot

文件: weixin-bridge.js

// 核心适配代码
const agent = {
  async chat(request) {
    // 将微信消息格式转换为 HTTP API
    const response = await axios.post(NANOBOT_BRIDGE_URL, {
      conversationId: request.conversationId,  // 微信用户ID
      text: request.text,                       // 消息内容
      media: request.media                      // 媒体文件(图片/语音等)
    });
    
    // 返回微信需要的格式
    return {
      text: response.data.text,
      media: response.data.media
    };
  }
};

适配 2: nanobot 命令行调用

问题: nanobot 没有直接的 API 接口,只能通过命令行调用

解决: 在 nanobot_adapter.py 中封装命令行调用

def _call_nanobot(self, prompt: str) -> str:
    # 使用 nanobot agent 命令
    cmd = [
        "nanobot",
        "agent",
        "-m", prompt,                    # 消息内容
        "--session", f"wechat:{id}",     # 会话隔离
        "--no-markdown",                 # 纯文本输出
        "--no-logs"                      # 禁用日志输出
    ]
    
    result = subprocess.run(cmd, capture_output=True, text=True)
    return result.stdout.strip()

适配 3: 多用户会话隔离

问题: nanobot 是单用户设计,微信是多用户并发

解决: session_manager.py 实现会话管理

class SessionManager:
    def __init__(self):
        self.sessions: Dict[str, Dict] = {}
    
    def get_history(self, conversation_id: str) -> List[Dict]:
        # 每个微信用户有独立的会话历史
        return self.sessions.get(conversation_id, {}).get('messages', [])
    
    def add_message(self, conversation_id: str, role: str, content: str):
        # 隔离不同用户的消息记录
        if conversation_id not in self.sessions:
            self.sessions[conversation_id] = {'messages': []}
        self.sessions[conversation_id]['messages'].append({
            'role': role,
            'content': content
        })

适配 4: 安全控制

问题: 微信是开放平台,需要限制危险操作

解决: security.py 实现多层安全检查

class SecurityChecker:
    # 危险命令过滤
    blocked_commands = ['rm -rf /', 'dd if=', 'mkfs', 'shutdown']
    
    # 速率限制(防刷屏)
    def check_rate_limit(self, user_id: str) -> bool:
        # 每分钟最多10条消息
    
    # 敏感信息脱敏
    def sanitize_output(self, output: str) -> str:
        # 自动隐藏 API key、token 等

适配 5: 外网访问支持

问题: 微信服务器需要访问桥接服务

解决:

  • Flask 绑定 0.0.0.0(所有网卡)
  • 配置公网 IP 地址
  • 开放 5000 端口
# server.py
app.run(host='0.0.0.0', port=5000)  # 允许外网访问

# 环境变量配置
NANOBOT_BRIDGE_URL=http://129.211.173.87:5000/chat


📄 主要代码文件

1. 微信适配器 (Node.js)

文件: weixin-bridge.js (1130 bytes)

const { login, start } = require('weixin-agent-sdk');
const axios = require('axios');

const NANOBOT_BRIDGE_URL = process.env.NANOBOT_BRIDGE_URL;

const agent = {
  async chat(request) {
    // 转发到 Python 桥接服务
    const response = await axios.post(NANOBOT_BRIDGE_URL, {
      conversationId: request.conversationId,
      text: request.text,
      media: request.media
    }, { timeout: 70000 });
    
    return { text: response.data.text };
  }
};

(async () => {
  await login();   // 扫码登录
  await start(agent);  // 启动消息循环
})();

职责:

  • 微信协议通信
  • 消息格式转换
  • HTTP 桥接调用

2. HTTP 桥接服务 (Python/Flask)

文件: src/server.py (180+ lines)

核心路由:

@app.route('/health', methods=['GET'])
def health_check():
    # 健康检查接口

@app.route('/chat', methods=['POST'])
def chat():
    # 主消息处理接口
    # 1. 安全检查
    # 2. 获取会话历史
    # 3. 调用 nanobot
    # 4. 返回回复

@app.route('/clear', methods=['POST'])
def clear_session():
    # 清空会话历史

职责:

  • HTTP API 服务
  • 组件初始化
  • 请求路由

3. nanobot 调用适配器

文件: src/nanobot_adapter.py (200+ lines)

class NanobotAdapter:
    def chat(self, message: str, history: List[Dict], conversation_id: str) -> str:
        # 构建上下文提示
        context = self._build_context(history, conversation_id)
        prompt = self._build_prompt(context, message)
        
        # 调用 nanobot agent 命令
        return self._call_nanobot(prompt)
    
    def _call_nanobot(self, prompt: str) -> str:
        cmd = [
            "nanobot", "agent",
            "-m", prompt,
            "--session", f"wechat:{id}",
            "--no-markdown"
        ]
        result = subprocess.run(cmd, capture_output=True, text=True)
        return result.stdout.strip()

职责:

  • 封装 nanobot 命令行调用
  • 构建系统提示词
  • 解析输出结果

4. 会话管理器

文件: src/session_manager.py (150+ lines)

class SessionManager:
    def __init__(self, config: Dict):
        self.sessions: Dict[str, Dict] = {}
        self.max_history = config.get('max_history', 10)
        self.expire_hours = config.get('expire_hours', 24)
    
    def get_history(self, conversation_id: str) -> List[Dict]:
        # 获取用户会话历史
    
    def add_message(self, conversation_id: str, role: str, content: str):
        # 添加消息,限制历史长度
    
    def _cleanup_expired(self):
        # 自动清理过期会话

职责:

  • 多用户会话隔离
  • 消息历史管理
  • 过期会话清理

5. 安全控制

文件: src/security.py (200+ lines)

class SecurityChecker:
    def check_rate_limit(self, user_id: str) -> bool:
        # 速率限制:每分钟10条
    
    def check_content(self, content: str) -> bool:
        # 内容安全检查
    
    def check_command_safety(self, command: str) -> Tuple[bool, str]:
        # 危险命令过滤
    
    def sanitize_output(self, output: str) -> str:
        # 敏感信息脱敏

职责:

  • 速率限制(防刷屏)
  • 危险命令过滤
  • 敏感信息脱敏

6. 系统服务配置

文件: scripts/install-service.sh

创建 systemd 服务单元:

[Unit]
Description=WeChat-Nanobot Bridge Service
After=network.target

[Service]
Type=simple
User=ubuntu
ExecStart=/usr/bin/python3 /path/to/server.py
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

职责:

  • 开机自启
  • 自动重启
  • 日志管理



📊 架构总览

┌─────────────────────────────────────────────────────────────┐
│                         微信用户                             │
│                   (手机微信 App)                             │
└───────────────────────────┬─────────────────────────────────┘
                            │ (微信消息协议)
                            ▼
┌─────────────────────────────────────────────────────────────┐
│  weixin-bridge.js (Node.js)                                 │
│  ├─ weixin-agent-sdk (微信协议封装)                         │
│  ├─ axios (HTTP 客户端)                                      │
│  └─ Agent.chat() 接口实现                                   │
└───────────────────────────┬─────────────────────────────────┘
                            │ (HTTP POST)
                            ▼
┌─────────────────────────────────────────────────────────────┐
│  src/server.py (Python/Flask)                               │
│  ├─ /health (健康检查)                                       │
│  ├─ /chat (消息处理) ← 安全检查 → 会话管理                   │
│  └─ /clear (清空会话)                                        │
└───────────────────────────┬─────────────────────────────────┘
                            │ (subprocess)
                            ▼
┌─────────────────────────────────────────────────────────────┐
│  src/nanobot_adapter.py                                     │
│  ├─ 构建系统提示词                                           │
│  ├─ nanobot agent -m "..." (命令行调用)                     │
│  └─ 解析 stdout 输出                                         │
└───────────────────────────┬─────────────────────────────────┘
                            │ (本地调用)
                            ▼
┌─────────────────────────────────────────────────────────────┐
│                     nanobot AI 助手                          │
│              (Moonshot API → kimi-k2.5 模型)                 │
└─────────────────────────────────────────────────────────────┘

🎯 关键技术点

技术点 实现方式 目的
协议转换 Node.js Agent 接口 → HTTP → Python 跨语言通信
会话隔离 conversationId + 内存字典 多用户支持
安全控制 命令白名单 + 速率限制 防止滥用
服务保活 systemd + Restart=always 高可用
媒体处理 weixin-agent-sdk 自动下载解密 支持图片/语音

这套方案的核心是分层解耦:微信协议层、HTTP 桥接层、AI 处理层各自独立,便于维护和扩展。🐈

✅ 服务安装并启动成功!


📊 服务状态

● weixin-nanobot-bridge.service - WeChat-Nanobot Bridge Service
   Loaded: loaded (/etc/systemd/system/weixin-nanobot-bridge.service; enabled)
   Active: active (running) since Mon 2026-03-23 22:59:10 CST
   Main PID: 409553 (python3)
   Memory: 18.2M

🧪 功能测试

测试项 状态 结果
健康检查 ✅ {"status": "ok"}
消息处理 ✅ nanobot 正常回复
外网访问 ✅ http://129.211.173.87:5000

📝 已完成的配置

  • ✅ 系统服务安装: /etc/systemd/system/weixin-nanobot-bridge.service
  • ✅ 开机自启: 已启用 (enabled)
  • ✅ 自动重启: 崩溃后10秒自动重启
  • ✅ 服务已启动: PID 409553 运行中

🔧 管理命令

# 查看状态
sudo systemctl status weixin-nanobot-bridge

# 停止服务
sudo systemctl stop weixin-nanobot-bridge

# 重启服务
sudo systemctl restart weixin-nanobot-bridge

# 查看日志
sudo journalctl -u weixin-nanobot-bridge -f

# 或使用管理脚本
./scripts/manage.sh status
./scripts/manage.sh logs

📱 微信连接状态

现在你可以:

  1. 直接发消息给你的微信 → nanobot 自动回复
  2. 重启服务器后自动启动 → 无需手动操作
  3. 服务崩溃自动恢复 → 10秒后自动重启

⚠️ 微信适配器注意

如果需要微信自动登录(无需每次扫码),需要额外配置:

# 先手动登录一次(保存登录状态)
node weixin-bridge.js
# 扫码登录成功后,Ctrl+C 退出

# 然后安装微信适配器服务
sudo ./scripts/install-weixin-service.sh
sudo systemctl start weixin-nanobot-adapter

当前微信已连接,可以正常收发消息!🎉



✅ 系统服务已配置完成!已提交 Git


🚀 快速安装(只需2步)

cd /home/ubuntu/nanocode/weixin-nanobot-bridge

# 1. 安装服务
sudo ./scripts/install-service.sh

# 2. 启动服务
./scripts/manage.sh start

📋 管理命令大全

cd /home/ubuntu/nanocode/weixin-nanobot-bridge

# 服务管理
./scripts/manage.sh start      # 启动
./scripts/manage.sh stop       # 停止
./scripts/manage.sh restart    # 重启
./scripts/manage.sh status     # 查看状态
./scripts/manage.sh logs       # 查看日志
./scripts/manage.sh test       # 测试 API

# 或使用 systemctl
sudo systemctl start weixin-nanobot-bridge
sudo systemctl stop weixin-nanobot-bridge
sudo systemctl restart weixin-nanobot-bridge
sudo systemctl status weixin-nanobot-bridge

🔧 系统服务特性

特性 配置
开机自启 ✅ 已启用
自动重启 崩溃后10秒自动重启
日志管理 systemd journal + 文件日志
端口监控 5000 端口
用户权限 ubuntu 用户运行

📁 新增文件

weixin-nanobot-bridge/
├── scripts/
│   ├── install-service.sh      # 安装 Bridge 服务 ⭐
│   ├── install-weixin-service.sh # 安装微信适配器服务
│   └── manage.sh               # 统一管理工具 ⭐
├── weixin-bridge.js            # 微信适配器主文件
├── start-weixin.sh             # 一键启动脚本
├── SYSTEMD.md                  # 系统服务文档
└── QUICKSTART.md               # 快速开始指南

⚡ 现在你可以

  1. 立即执行安装:

    sudo ./scripts/install-service.sh
    
  2. 验证服务状态:

    ./scripts/manage.sh status
    
  3. 测试微信功能:

    • 发消息给你的微信
    • nanobot 会自动回复

⚠️ 注意事项

  1. 微信适配器需要手动先扫码登录一次,才能配置为自动启动

  2. 服务日志:

    • logs/server.log - 应用日志
    • logs/service.log - 服务日志
    • sudo journalctl -u weixin-nanobot-bridge -f - systemd 日志
  3. 重启后自动启动,无需手动操作


需要我现在帮你执行安装吗?🐈




✅ 代码已递交完成!

📊 Git 提交记录

b839b2e 简化配置:移除 Token 认证,仅保留 localhost 监听
82b78cb 安全修复:Bridge 服务仅监听本地地址  
f739d37 安全加固:添加 Token 认证机制
9cf9199 新增系统服务支持:WeChat-Nanobot Bridge 开机自启
b983f63 新增 weixin-nanobot-bridge 项目:微信与 nanobot 的桥接服务

📁 项目文件清单

文件 说明
weixin-bridge.js 微信适配器(Node.js)
src/server.py Flask HTTP 服务
src/nanobot_adapter.py nanobot 调用适配
src/session_manager.py 会话管理
src/security.py 安全控制
src/middleware.py 中间件(保留但未使用)
config/config.json 配置文件(监听 127.0.0.1)
scripts/install-service.sh 系统服务安装脚本
scripts/manage.sh 统一管理工具
SYSTEMD.md 系统服务文档

🚀 当前运行状态

# 服务状态
sudo systemctl status weixin-nanobot-bridge
# Active: active (running) - 正在运行

# 监听地址
sudo ss -tlnp | grep 5000
# 127.0.0.1:5000 - 仅本地

所有代码已推送至 Git 仓库! 🐈




是的,有两个服务,但目前只安装了第1个:

服务 状态 作用
1. weixin-nanobot-bridge ✅ 已安装运行 Flask HTTP API,接收微信消息,调用 nanobot
2. weixin-nanobot-adapter ❌ 未安装 Node.js 微信适配器,连接微信协议

当前状态

# 查看已安装的服务
sudo systemctl list-units | grep weixin

# 输出:
weixin-nanobot-bridge.service  loaded active running  ✅ 已运行
# weixin-nanobot-adapter.service  ❌ 不存在

两者的区别

┌─────────────────────────────────────────────────────────┐
│  weixin-nanobot-bridge (Python/Flask)                   │
│  - 系统服务 ✅ 已安装                                     │
│  - 开机自启 ✅ 已配置                                     │
│  - 端口 5000,接收 HTTP 请求                              │
│  - 调用 nanobot 生成回复                                  │
└─────────────────────────────────────────────────────────┘
                            ▲
                            │ HTTP POST
                            ▼
┌─────────────────────────────────────────────────────────┐
│  weixin-bridge.js (Node.js)                             │
│  - 当前:❌ 手动运行 (node weixin-bridge.js)             │
│  - 可安装为系统服务                                       │
│  - 连接微信协议 (weixin-agent-sdk)                        │
│  - 扫码登录微信                                           │
└─────────────────────────────────────────────────────────┘

微信目前能用吗?

  • 如果你之前运行的 node weixin-bridge.js 还没关 → 微信还能用 ✅
  • 如果你关闭了那个终端 → 微信断开了 ❌

是否需要安装第2个服务?

选项 A:保持现状(推荐测试期)

  • 需要微信时,手动运行:node weixin-bridge.js
  • 不需要时,Ctrl+C 关闭
  • 优点:可控,避免微信封号风险

选项 B:安装为系统服务

  • 开机自动连接微信(需先扫码登录一次)
  • 自动保持在线
  • 风险:如果微信被封,服务会一直尝试重连

你需要我现在安装第2个服务(微信适配器)吗? 🐈




✅ 代码已递交!支持 QQ Bot 风格命令

🎮 支持的命令

命令 功能 示例回复
/clear 清空当前会话历史 ✅ 会话历史已清空
/context 查看最近5条历史 📜 历史记录 (6条)...\n👤 你好...\n🤖 AI回复...
/reset 完全重置会话 ✅ 会话已完全重置
/stats 查看服务统计 📊 服务状态:\n会话数: 10\n消息数: 56
/help 显示帮助 🤖 可用命令列表

🔧 实现方式

用户发送: /clear
    ↓
weixin-bridge.js 识别为命令
    ↓
本地调用 POST /clear (不经过 nanobot)
    ↓
直接返回: ✅ 会话历史已清空

用户发送: 普通消息
    ↓
转发给 nanobot 生成 AI 回复

🚀 使用方法

微信用户直接发送:

/clear     → 清空聊天记录
/context   → 查看历史对话
/stats     → 查看服务状态
/help      → 显示所有命令

📊 Git 提交

e632451 新增系统命令支持:/clear, /context, /reset, /stats, /help

所有代码已推送! 🐈




执行这些指令 /clear, /context 和 /reset, 是不是nanobot自己直接响应,无需大模型的解析?

是的!完全正确!

🎯 命令执行流程

用户发送: /clear
    ↓
weixin-bridge.js (Node.js 代码)
    ↓
检测到以 "/" 开头 → 识别为系统命令
    ↓
直接调用 Bridge API (本地 HTTP)
    ↓
返回固定文本: "✅ 会话历史已清空"
    ↓
完全绕过 nanobot/大模型

⚡ 为什么这样设计?

优势 说明
速度极快 本地代码执行,毫秒级响应
零 Token 消耗 不调用 AI,不消耗 API 额度
可靠性高 不依赖大模型解析,不会误解
确定性 命令结果可预测,不会"幻觉"

🔍 代码逻辑

// weixin-bridge.js 中的命令检测
async function handleCommand(text, conversationId) {
  const cmd = text.trim().toLowerCase();
  
  switch (cmd) {
    case '/clear':
      // 直接调用 API,不经过 AI
      await axios.post(`${BASE_URL}/clear`, { conversationId });
      return { text: '✅ 会话历史已清空' };  // 固定回复
    
    case '/context':
      // 直接查询本地数据
      const res = await axios.post(`${BASE_URL}/context`, { conversationId });
      return { text: formatHistory(res.data) };  // 格式化返回
    
    // ... 其他命令同理
  }
}

// 主流程
const agent = {
  async chat(request) {
    // 先检查是否是命令
    const cmdResult = await handleCommand(text, conversationId);
    if (cmdResult) {
      return cmdResult;  // 命令直接返回,不走 AI
    }
    
    // 普通消息才转发给 nanobot
    const response = await axios.post(NANOBOT_BRIDGE_URL, {...});
    return response.data;
  }
};

🆚 对比

消息类型 处理路径 响应速度 Token 消耗
/clear 本地代码 → API ⚡ 10ms 0
你好 nanobot → Moonshot API ⏱️ 3-5s 有
/stats 本地代码 → API ⚡ 10ms 0

✅ 总结

  • 命令 (/clear, /context, /reset, /stats, /help):本地直接响应,零 AI 参与
  • 普通消息:转发给 nanobot → 大模型生成回复

这样又快又省!🐈


目录说明

WeClaw

微信 AI Agent 桥接器 — 将微信消息接入 AI Agent(Claude、Codex、Gemini、Kimi 等)。

nanobot:

The Ultra-Lightweight OpenClaw 这个项目支持很多channel方式接入,但是不支持微信。

Channel What you need
Telegram Bot token from @BotFather
Discord Bot token + Message Content intent
WhatsApp QR code scan
Feishu App ID + App Secret
Mochat Claw token (auto-setup available)
DingTalk App Key + App Secret
Slack Bot token + App-Level token
Email IMAP/SMTP credentials
QQ App ID + App Secret
Wecom Bot ID + Bot Secret

工作要求

参考WeClaw这个微信 AI Agent 桥接器项目里的实现方法,在nanobot里面,添加wechat bot(微信 bot)的接入方式。

先不急于写代码实现。

在理解两个项目的基础上,你提出可能的解决方案,软件实现方案。