【OpenClaw】微信接入龙虾对话

【OpenClaw】微信接入龙虾对话 - ClawBot

注：如果已经安装OpenClaw可直接查看微信接入配置，跳过前面的安装。

什么是 ClawBot？

ClawBot 是基于 OpenClaw 平台的智能 AI 助手，可以让你在微信中直接与 AI 对话。OpenClaw 是一个开源的、自托管的 AI 网关，支持多个聊天平台（WhatsApp、Telegram、Discord、微信等）。

核心优势

- 🤖 多模型支持：支持 OpenAI、Claude、GLM 等多种 AI 模型

- 📱 多平台接入：一个 Gateway 服务同时支持微信、Telegram、Discord 等

- 🔐 数据自主可控：运行在你自己的设备上，数据不经过第三方服务器

- 🎨 功能丰富：支持文字、图片、语音、文件等多种消息类型

- ⚡ 响应迅速：本地部署，响应速度快

- 🛡️ 安全可靠：支持配对机制，只有授权用户才能使用

准备工作

系统要求

- 操作系统：macOS、Linux 或 Windows (WSL2)

- Node.js：版本 24.x（推荐）或 22.16+

- 网络环境：能够访问互联网

- 微信账号：用于扫码登录

检查 Node.js 版本

打开终端，运行：

node --version

如果版本低于 22.16，请先升级 Node.js。

安装步骤

第一步：安装 OpenClaw

在终端中运行以下命令：

npm install -g openclaw@latest

如果你使用 pnpm 或 bun：

# 使用 pnpmpnpm add -g openclaw@latest# 使用 bunbun add -g openclaw@latest

第二步：运行初始化向导

安装完成后，运行初始化命令：

openclaw onboard --install-daemon

这个命令会：

创建必要的配置文件
安装 Gateway 守护进程（后台服务）
引导你完成基础配置

第三步：启动 Gateway

openclaw gateway start

或者在前台运行（用于调试）：

openclaw gateway --port 18789 --verbose

微信接入配置

手机微信需要升级至最新版本，在设置-插件中有微信ClawBot模块。

方法一：快速安装（推荐）

运行以下命令自动安装微信插件：

npx -y @tencent-weixin/openclaw-weixin-cli install

方法二：手动安装

如果快速安装失败，可以手动执行以下步骤：

1. 安装微信插件

openclaw plugins install "@tencent-weixin/openclaw-weixin"

2. 启用插件

openclaw config set plugins.entries.openclaw-weixin.enabled true

3. 扫码登录

运行登录命令：

openclaw channels login --channel openclaw-weixin

终端会显示一个二维码：

██████████████████████████████████████████████████████████████ ▄▄▄▄▄ █▀█ ▄▄▄▄▄ ████████ █   █ █▀▀▀█   █ ████████ █▄▄▄█ ██▄ █▄▄▄█ ████...

使用手机微信扫描二维码并确认授权。授权成功后，登录凭据会自动保存在本地，无需重复登录。

4. 重启 Gateway

openclaw gateway restart

添加多个微信账号

如果需要同时使用多个微信号，可以重复登录：

openclaw channels login --channel openclaw-weixin

每次扫码登录都会创建一个新的账号条目，支持多个微信账号同时在线。

使用指南

开始对话

配置完成后，打开手机微信，找到刚刚登录的微信号（通常显示为"文件传输助手"或自定义昵称），发送消息即可与 AI 对话。

支持的消息类型

- 📝 文字：直接发送文字消息

- 🖼️ 图片：发送图片，AI 可以识别和分析

- 🎤 语音：发送语音消息（需要配置语音识别）

- 📄 文件：发送文档文件

常用命令

在微信中发送以下命令可以控制 AI 行为：

命令	功能
/status	查看会话状态（模型、Token 使用量）
/new 或 /reset	重置会话
/compact	压缩会话上下文
/think off\|low\|medium\|high	调整思考深度
/verbose on\|off	开启/关闭详细模式

多账号上下文隔离

默认情况下，所有渠道共享同一个 AI 对话上下文。如果需要为每个微信账号隔离对话上下文：

openclaw config set agents.mode per-channel-per-peer

这样每个"微信账号 + 消息发送者"组合都有独立的 AI 记忆，防止不同对话之间混淆。

高级配置

配置 AI 模型

编辑配置文件 ~/.openclaw/openclaw.json：

{  "agent": {    "model": "anthropic/claude-opus-4-6"  }}

支持的模型包括：

openai/gpt-4o
openai/gpt-4-turbo
anthropic/claude-opus-4-6
anthropic/claude-sonnet-4
zai/glm-5（智谱 GLM）
zai/glm-4.7

配置访问权限

仅允许特定用户

{  "channels": {    "openclaw-weixin": {      "allowFrom": ["user_id_1", "user_id_2"]    }  }}

配置配对机制

默认情况下，陌生用户需要配对码才能使用。批准配对：

openclaw pairing approve

多代理路由

OpenClaw 支持将不同渠道路由到不同的 AI 代理：

{  "agents": {    "mode": "per-channel",    "defaults": {      "model": "openai/gpt-4o"    },    "perChannel": {      "openclaw-weixin": {        "model": "anthropic/claude-opus-4-6"      }    }  }}

配置 Gateway 远程访问

如果需要在局域网外访问 Gateway：

使用 Tailscale

{  "gateway": {    "tailscale": {      "mode": "serve"    }  }}

使用密码保护

{  "gateway": {    "auth": {      "mode": "password",      "password": "your_secure_password"    }  }}

常见问题

Q1: 扫码登录失败怎么办？

A: 检查以下几点：

确保网络连接正常
确保手机微信已更新到最新版本
尝试重新运行 openclaw channels login --channel openclaw-weixin
检查 Gateway 是否正在运行：openclaw gateway status

Q2: 微信消息没有响应？

A: 排查步骤：

检查 Gateway 日志：openclaw gateway --verbose
确认插件已启用：openclaw config get plugins.entries.openclaw-weixin.enabled
重启 Gateway：openclaw gateway restart
检查 AI 模型配置是否正确

Q3: 如何查看运行日志？

A: 运行以下命令：

# 实时查看日志openclaw gateway --verbose# 或查看日志文件tail -f ~/.openclaw/logs/gateway.log

Q4: 如何更新到最新版本？

A: 运行更新命令：

# 更新 OpenClawnpm update -g openclaw@latest# 运行诊断工具openclaw doctor# 重启 Gatewayopenclaw gateway restart

Q5: 支持群聊吗？

A: 支持。配置群聊权限：

{  "channels": {    "openclaw-weixin": {      "groups": {        "*": {          "requireMention": true        }      }    }  }}

requireMention: true 表示只有在群里 @机器人时才会响应。

Q6: 如何切换不同的 AI 模型？

A: 有两种方式：

方式一：命令行切换

openclaw config set agent.model "openai/gpt-4o"

方式二：在对话中切换

发送命令：/model openai/gpt-4o

Q7: 数据安全吗？

A: ClawBot 运行在你自己的设备上，所有数据都保存在本地：

配置文件：~/.openclaw/openclaw.json
凭据：~/.openclaw/credentials
日志：~/.openclaw/logs/

只有你的 AI 对话会发送到相应的 AI 服务商（如 OpenAI、Anthropic），建议使用最强的最新一代模型以获得最佳体验和安全性。

Q8: 如何完全卸载？