博客

# 吐血整理！OpenClaw 接入个人微信全流程详解

## 前言

之前写了一篇关于 AI 助手接入各种平台的经验分享，今天来填一个坑——**如何在 OpenClaw 中接入个人微信**。

说起来这个过程还挺曲折的，踩了不少坑，也终于走通了。今天把完整流程分享出来，手把手教大家避坑。

—

## 整体思路

OpenClaw 接入个人微信的核心思路是：通过 ilink 提供的中转服务，实现微信与 OpenClaw 之间的消息互通。整个过程分为以下几个步骤：

1. 在 OpenClaw 中安装微信插件
2. 获取 ilink 授权二维码
3. 用微信扫码授权
4. 配置账号凭证
5. 重启服务，完成绑定

—

## 第一步：检查插件是否安装

登录服务器，检查 OpenClaw 的微信插件是否已经安装：

“`bash
ls ~/.openclaw/extensions/openclaw-weixin/package.json
“`

如果提示文件不存在，说明插件未安装，执行安装命令：

“`bash
npx -y @tencent-weixin/openclaw-weixin-cli install
“`

—

## 第二步：获取授权二维码

插件安装完成后，调用 ilink 接口获取登录二维码：

“`python
import urllib.request
import json

url = “https://ilinkai.weixin.qq.com/ilink/bot/get_bot_qrcode?bot_type=3”
req = urllib.request.Request(url, headers={“User-Agent”: “Mozilla/5.0”})

with urllib.request.urlopen(req, timeout=15) as r:
data = json.loads(r.read().decode())
qrcode = data[“qrcode”]
qrcode_img = data[“qrcode_img_content”]
print(f”QR Code: {qrcode}”)
print(f”QR Image URL: {qrcode_img}”)
“`

接口会返回一个二维码链接，用微信扫一扫即可。

> 注意：这个二维码有效期约 60 秒，如果超时未扫码，需要重新获取。

—

## 第三步：用微信扫码授权

用个人微信打开扫一扫，扫描上一步得到的二维码。

扫码成功后，微信上会弹出授权确认页面，点击”确认授权”。

—

## 第四步：获取授权凭证并保存

扫码成功后，调用状态查询接口，获取正式的授权凭证：

“`python
import urllib.request
import json

qrcode = “此处填写第二步获取的qrcode值”
status_url = f”https://ilinkai.weixin.qq.com/ilink/bot/get_qrcode_status?qrcode={qrcode}”

req = urllib.request.Request(status_url, headers={“User-Agent”: “Mozilla/5.0”})
with urllib.request.urlopen(req, timeout=15) as r:
data = json.loads(r.read().decode())
bot_id = data[“ilink_bot_id”]
bot_token = data[“bot_token”]
base_url = data[“baseurl”]
user_id = data[“ilink_user_id”]
print(f”Bot ID: {bot_id}”)
print(f”User ID: {user_id}”)
“`

拿到凭证后，需要将它们写入 OpenClaw 的账号配置文件：

“`python
import json, os, stat

account_id = f”{bot_id.split(‘@’)[0]}-im-bot”
accounts_dir = os.path.expanduser(“~/.openclaw/openclaw-weixin/accounts”)
os.makedirs(accounts_dir, exist_ok=True)

account_data = {
“token”: f”{bot_id}:{bot_token}”,
“savedAt”: “2026-03-25”,
“baseUrl”: base_url,
“userId”: user_id
}

account_file = os.path.join(accounts_dir, f”{account_id}.json”)
with open(account_file, “w”) as f:
json.dump(account_data, f, indent=2)
os.chmod(account_file, stat.S_IRUSR | stat.S_IWUSR)

# 更新账号索引文件
index_file = os.path.join(accounts_dir, “accounts.json”)
accounts = []
if os.path.exists(index_file):
with open(index_file) as f:
accounts = json.load(f)
if account_id not in accounts:
accounts.append(account_id)
with open(index_file, “w”) as f:
json.dump(accounts, f, indent=2)

print(f”✅ 凭证已保存到 {account_file}”)
“`

—

## 第五步：重启 OpenClaw Gateway

配置完成后，需要重启 OpenClaw Gateway 让插件生效：

“`bash
openclaw gateway restart
“`

重启完成后，在微信里给机器人发一条消息，例如”你好”，如果机器人能自动回复，说明接入成功！

—

## 常见问题

**Q1: 二维码过期了怎么办？**
重新调用第一步的接口获取新二维码即可，注意每次获取二维码有效期只有 60 秒。

**Q2: 扫码后提示”账号异常”？**
微信个人账号接入第三方平台有时会有安全限制，建议使用实名认证的微信账号尝试。

**Q3: 重启 Gateway 后仍然无法收发消息？**
检查凭证文件是否写入成功，确认 account_id 格式正确，以及 OpenClaw 配置文件中 channels 部分是否正确引用了该账号。

**Q4: 消息发送成功但接收不到回复？**
确认 OpenClaw 的 webhook 回调地址已正确配置，且服务器防火墙对对应端口已开放。

—

## 接入后的效果

接入个人微信后，就可以通过微信直接和 AI 助手对话了，不用再打开网页，在手机上随时随地都能使用，体验非常流畅。

—

## 写在最后

整个接入过程并不复杂，关键点在于：二维码有时效，扫码要迅速；凭证要写对位置；写完后必须重启 Gateway。只要注意这三点，基本都能一次成功。

如果还有疑问，欢迎留言交流！

—

*本文基于 OpenClaw + ilinkai 服务编写，微信版本需保持最新以获得最佳兼容性。*

# nginx黑名单自动deny脚本

tail -n50000 /usr/local/nginx/logs/access.log | awk '{print $1}' | sort | uniq -c | sort -rn | awk '{if($1>100 && $1<1000 && $2 ~! /^49.80.*/)print "deny "$2";"}' >> /usr/local/nginx/conf/blacklist.conf;

/usr/local/nginx/sbin/nginx -s reload

# 注：if条件中的&& $2 ~! /^49.80.*/是做的白名单，可以在后面追加白名单ip

# 后续步骤：

# 1、保存为可执行文件nginx-blacklist-update.sh    保存后执行chmod +x nginx-blacklist-update.sh

# 2、nginx配置/usr/local/nginx/conf/nginx.conf文件http模块下引入 include blacklist.conf;

# 3、执行crontab -e  然后写入定时执行脚本定时执行更新黑名单 * */2 * * * /root/shell/nginx-blacklist-update.sh

本文为胖虎原创文章,转载无需和我联系,但请注明来自胖虎博客panghucat.cn

• 上一篇：没有了
• 下一篇： 使用nvm实现多版本node自由切换

我们一般安装的是最新版本的node,但是有时候，我们又需要使用低版本的node,在不借助第三方工具的情况下，我们只能卸载现有版本,安装需要的版本，这样显然很麻烦，今天就来介绍一个windows系统使用的node多版本管理工具nvm，全称是node.js version management,可以在多个node版本之间自由切换！

1、下载

下载地址

2、安装nvm

注意：安装之前必须完全卸载已安装的node

解压.zip压缩包，双击nvm-setup.exe开始安装，下面两个步骤需要注意：

• 这里是设置nvm的安装路径

在这里插入图片描述

• 这里是设置使用nvm安装node时，node的安装路径

在这里插入图片描述

安装完成后，在CMD命令窗口输入nvm -v,输出如下版本号即证明安装成功

Running version 1.1.7.

3、修改nvm配置文件（可选）

nvm安装完成后，打开nvm安装目录下的settings.txt文件:

root: D:\nvm
path: D:\nodejs 
arch: 64 proxy: none
node_mirror: http://npm.taobao.org/mirrors/node/npm_mirror: https://npm.taobao.org/mirrors/npm/

root和path分别是nvm和node的安装路径，这两个不要动，这是之前安装时根据你选择的路径自动生成的，这个配置文件默认也只有这两项。因为我没改配置文件，所以后面的4项我都没有，只是后来搜到了，就说一下，arch表示安装的node是多少位，proxy是设置代理，node_mirror是更改nvm下载node时的镜像，这里是设置为淘宝镜像，npm_mirror是更改npm下载依赖包的镜像，也是修改为了淘宝镜像。

4、安装node

• 查看nvm支持安装的node版本

使用nvm list available

在这里插入图片描述

• 使用nvm install 版本号安装指定版本node

我刚开始没有使用查询指令，使用nvm install 12.0.0安装，结果出了问题，后来才知道，nvm支持安装的版本里面就没有12.0.0,其实node也没有12.0.0,所以这里一定要查询版本号之后再安装。我这里选择安装12.18.3。

C:\Users\lulu>nvm install 12.18.3
Downloading node.js version 12.18.3 (64-bit)...
Complete
Creating D:\nvm\temp

Downloading npm version 6.14.6... Complete
Installing npm v6.14.6...

Installation complete. If you want to use this version, type

nvm use 12.18.3

这里同时安装了node和npm,因为我没修改下载镜像，所以速度很慢，如果介意可以修改下载镜像为淘宝镜像。

• 检测node和npm是否安装成功,如下显示则为成功：

C:\Users\lulu>node -v
v12.18.3

C:\Users\lulu>npm -v
6.14.6

5、切换node版本

初次使用nvm安装node之后，必须先使用nvm use 版本号切换到已安装版本的node才可以

C:\Users\lulu>nvm use 12.18.3
Now using node v12.18.3 (64-bit)

我这里刚开始没切换，发现D盘下没有我指定的nodejs目录，后来执行切换命令后才出现。

6、配置node

• 修改全局依赖包下载路径

我上面将node安装在D盘，但是如果使用node安装全局依赖包的话，它还是会把依赖包下载到C盘下，所以我这里修改一下，分别执行以下两条CMD指令，修改使用npm下载全局依赖包的下载目录和缓存目录

C:\Users\lulu>npm  config set prefix "D:\nodejs\node_global"

C:\Users\lulu>npm  config set cache "D:\nodejs\node_cache"

执行完成会在我的D:\nodejs下创建node_global目录，node_cache目录是缓存目录，在使用npm下载依赖包后会生成

• 查看修改结果

C:\Users\lulu>npm config list
; cli configs
metrics-registry = "https://registry.npmjs.org/"
scope = ""
user-agent = "npm/6.14.6 node/v12.18.3 win32 x64"

; userconfig C:\Users\Silence\.npmrc
cache = "D:\\nodejs\\node_cache"
prefix = "D:\\nodejs\\node_global"

; node bin location = D:\nodejs\node.exe
; cwd = C:\Users\Silence
; HOME = C:\Users\Silence
; "npm config ls -l" to show all defaults.

• 修改环境配置

因为我修改了全局依赖包的下载目录，所以要把该目录添加到环境变量，否则，使用全局指令是就会报错。如果你没修改全局依赖包的下载目录，这一步可以跳过。

在这里插入图片描述

可以看到，关于nvm的环境配置，已经添加好了，不需要我们手动添加，其实你仔细看的话，在安装nvm的时候，界面也有提示会自动添加。

7、多版本node切换

为了演示多版本node切换，我这重复上面的第4步，安装一个最新版本的node

• 查看当前安装的所有node版本

C:\Users\lulu>nvm list

    14.7.0
  * 12.18.3 (Currently using 64-bit executable)

*号符表示的是当前使用的版本

• 切换不同版本的noe

C:\Users\lulu>nvm use 14.7.0
Now using node v14.7.0 (64-bit)
C:\Users\Silence>nvm list  
* 14.7.0 (Currently using 64-bit executable)    
12.18.3

8、nvm常用指令

nvm off                     //禁用node.js版本管理(不卸载任何东西)
nvm on                      //启用node.js版本管理
nvm install <version>       //安装指定版本node,例如nvm install 12.18.3
nvm uninstall <version>     //卸载指定版本node,例如nvm uninstall 12.18.3 
nvm list                    //显示所有安装的node.js版本
nvm list available          //显示可以安装的所有node.js的版本(windows系统)
nvm use <version>           //切换到使用指定的nodejs版本，例如nvm use 12.18.3

• 上一篇： nginx黑名单自动deny脚本
• 下一篇： 使用python脚本对excel进行去重

使用python便捷进行excel文件列的去重操作，并保留唯一行：

上脚本：

PS：drop_duplicates的用法：

subset='去重复的列名'

keep='重复处理保留第一个还是最后一个，可选first或last'

inplace='去除重复项true，保留重复项的副本false'

import pandas as pd

frame = pd.read_excel('source.xlsx')
data = pd.DataFrame(frame)
data.drop_duplicates(['车位号','客户名称','关联主房间'], keep='first', inplace=True)
data.to_excel('out.xlsx')
print('去重结束')

1、将source.xlsx替换为当前需替换的excel文件名

2、将脚本保存为filter.py

3、进入目录执行：python filter.py

注意：如果有未安装的库，会报错

举例1：执行pip install pandas

举例2：执行pip install xlrd

举例3：执行pip install openpyxl

本文为胖虎原创文章,转载无需和我联系,但请注明来自胖虎博客panghucat.cn

• 上一篇： 使用nvm实现多版本node自由切换
• 下一篇： 前端vue中切换路由利用watch自动刷新页面数据、及离开或切换浏览器后回到页面自动刷新功能实现

我们在项目中经常遇到，切换了路由回到原页面，数据没刷新，导致页面展示的数据不是最新数据的问题，可以用以下代码解决：

场景1：切换路由自动刷新页面

只要在vue的script中写入观察模块，watch到$route的目标页，再执行刷新数据操作

watch: {
  '$route' (to) {
    // to为路由跳转的实体，targe_page为当前页的name
    if(to.name == 'targe_page') {
      // 获取分类
      this.getCategoryList();
      // 加载数据
      this.loadTableData();
    }
  },
}

场景2：离开或切换浏览器后回到页面自动刷新

在vue的mounted中添加document的监听事件，可见时执行刷新数据操作

mounted () {
  // 获取分类
  this.getCategoryList();
  // 加载数据
  this.loadTableData();
  // 显示隐藏时刷新
  var self = this;
  document.addEventListener('visibilitychange', function () {
    // 页面变为不可见时触发
    if (document.visibilityState == 'hidden') {
      // document.title = '离开';
    }
    // 页面变为可见时触发
    if (document.visibilityState == 'visible') {
      // 获取分类
      self.getCategoryList();
      // 加载数据
      self.loadTableData();
    }
  });
}

本文为胖虎原创文章,转载无需和我联系,但请注明来自胖虎博客panghucat.cn

• 上一篇： 使用python脚本对excel进行去重
• 下一篇： 使用expect实现linux交互脚本scp、sftp操作，远程收发文件使用