乐于分享
好东西不私藏

从 0 到 1 微信接入 OpenClaw 小龙虾:完整详细指南

从 0 到 1 微信接入 OpenClaw 小龙虾:完整详细指南

微信官方推出 ClawBot 插件,终于可以合规地把你的“龙虾”请进微信聊天列表了。本文手把手教你完成接入,安卓和 iOS 都能用。

前言:什么是 OpenClaw(小龙虾)?

OpenClaw,昵称“龙虾”,是一款开源的 AI 智能体工具,上线不久便迅速成为 2026 年度现象级“开源奇迹”。你可以把它理解为一个能帮你干活、能调用你电脑各种能力的 AI 助手

而微信刚刚推出的 ClawBot 插件,正式打通了微信与 OpenClaw 之间的通道。这意味着:

  • 你可以在微信里直接和你的龙虾聊天
  • 龙虾能读取你发来的文件、图片、链接
  • 支持语音输入,按住说话就行
  • 龙虾能操作你的电脑(比如从电脑里找出文件发给你)
  • 官方支持,不封号

目前微信 ClawBot 插件已支持 iOS 8.0.70+ 和安卓 8.0.69+ 版本。下面我们就从零开始,一步步完成接入。


第一部分:准备工作

1.1 确认微信版本

  • iOS 用户
    :微信需要 8.0.70 或以上版本
  • 安卓用户
    :微信需要 8.0.69 或以上版本

更新完微信后,建议手动关闭微信 App,再重新打开,清掉缓存。这一步很重要——很多人一开始找不到插件入口,重启后就出现了。

1.2 检查 Node.js 环境

OpenClaw 基于 Node.js 运行,你需要在电脑上安装 Node.js(版本 18 或以上)。

打开终端(Mac 的 Terminal 或 Windows 的命令提示符),输入:

node --version

如果显示版本号(比如 v20.10.0),说明已安装。如果没有,先去 nodejs.org 下载安装。

1.3 准备一个 API Key(可选但推荐)

龙虾本身需要调用大模型才能回答问题。你可以提前准备好任意平台的 API Key:

  • 国内:智谱、Kimi、MiniMax、通义千问、DeepSeek 等
  • 国外:OpenAI、Anthropic 等

如果暂时没有 API Key,也可以用龙虾自带的测试模型先体验(但功能受限)。


第二部分:安装 OpenClaw(龙虾本体)

2.1 一条命令安装

打开电脑终端,执行:

npm install -g openclaw@latest

安装过程大概 1-3 分钟,取决于网络速度。看到类似“added xxx packages”的提示,就说明安装成功了。

2.2 初始化配置

接着运行:

openclaw onboard --install-daemon

这一步会启动配置向导,按照提示操作即可:

  1. 是否安装守护进程?
    选 yes(这样龙虾开机自启)
  2. 配置大模型 API
    :选择你要用的模型平台,输入 API Key
    • 注意区分“国内”和“海外”平台,OpenClaw 会有相应选项
    • 如果你买了 Coding Plan,别选错计费方式
  3. 选择 channel
    :这一步会问你要接入哪个平台(飞书、Discord 等),暂时跳过,因为微信的 channel 还没出现在列表里,我们稍后用插件方式接入
  4. 配置 Skills、搜索、Hook
    :建议先跳过,后续需要再加

配置完成后,终端会显示 OpenClaw Gateway 的 Web 管理界面地址(通常是 http://127.0.0.1:4000)。可以打开浏览器看看,确认龙虾已经跑起来了。


第三部分:微信接入(核心步骤)

3.1 找到插件安装命令

打开微信,依次点击:

「我」→「设置」→「插件」→ 找到「ClawBot」

如果没看到 ClawBot 插件,说明:

  • 微信版本不够新(检查更新)
  • 或者没重启微信(关掉 App 重开试试)

找到插件后,点击进入,里面会显示一行专属的安装命令,类似这样:

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

把这行命令复制下来,等下要用。

3.2 在电脑终端运行安装命令

回到电脑终端,粘贴刚才复制的命令,回车执行。

终端会开始下载并安装微信 ClawBot 插件。这个过程大概一两分钟,取决于网络。

如果遇到安装卡住不动超过 3 分钟的情况,不要慌——这是常见问题。直接 Ctrl + C取消,改用下面的“备用方案”。

3.3 备用方案(当官方命令卡住时)

实测这个方法更稳,本人就是这么救活的:

第一步:停掉 OpenClaw

openclaw gateway stop

第二步:确认进程彻底结束

pkill -f openclaw

第三步:手动安装插件

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

第四步:手动启用插件

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

第五步:触发扫码绑定微信

openclaw channels login --channel openclaw-weixin

此时终端会弹出一个二维码。

3.4 扫码配对

拿起手机,打开微信的「扫一扫」,扫描终端上的二维码。

手机上会弹出授权确认页面,点击「连接」或「允许」。

终端会显示类似这样的提示:

与微信连接成功!正在重启 OpenClaw Gateway。

第六步:重启 Gateway

这一步很容易被忽略,但不重启的话龙虾可能没反应:

openclaw gateway restart

3.5 确认接入成功

完成以上步骤后,打开微信的「通讯录」,你会发现多了一个叫 「微信 ClawBot」的好友。

发一条消息给它,比如“你好,能收到吗?”。

如果它回复了——恭喜,接入成功!🎉


第四部分:实测能力一览

接入成功后,你可以试试这些功能:

能力
实测结果
怎么用
文字对话
✅ 完美支持
直接打字聊天
语音输入
✅ 完美支持
按住说话,龙虾听得懂
读取文件
✅ 支持
把 PDF/Word/TXT 发给它,龙虾能解析内容
识别图片
✅ 支持
发截图,龙虾能读图(文字识别、物体识别)
解析链接
✅ 支持
发公众号文章链接,龙虾帮你总结
远程调取电脑文件
✅ 支持
发语音“帮我把桌面上的XX文件发给我”
斜杠命令
✅ 支持
输入 /model deepseek切换模型
引用回复
✅ 支持
长按龙虾的消息,引用后继续追问
表情包搜索
✅ 支持
发“帮我找一张小龙虾的表情包”
发送文件
❌ 暂不支持
龙虾还不能主动给你发文件(但能发图片)
群聊
❌ 暂不支持
目前仅限私聊
转发消息
❌ 暂不支持
不能把聊天记录直接转给龙虾

特别实测亮点

1. 文件读取把一份 PDF 提案发给 ClawBot,它能秒读内容并总结要点。不打断心流,点一点就完成。

2. 语音远程取文件人在外面,文件在电脑上。发语音“帮我把桌面上那个产品资料文档发给我”,龙虾去电脑里找到文件,直接发到微信。

3. 公众号链接一键解析复制文章链接发给 ClawBot,龙虾自动读文章、提炼要点,甚至能帮你归档到 Obsidian(需要配置 Skill)。

4. 图片识别发一张简历截图,龙虾能识别出里面的学校名称、学历层次(211/985/双非),连小字都能看清。


第五部分:常见问题与排错

问题
解决方法
插件里找不到 ClawBot
检查微信版本,更新到最新;关掉微信重开;实在没有就再等等,可能灰度中
安装命令卡住不动
用备用方案手动安装(见 3.3)
扫码后没反应
重启微信 App,重新扫码
扫码成功但龙虾不回消息
检查 Gateway 是否重启(openclaw gateway restart);检查插件是否启用(openclaw config get plugins
提示“未找到 OpenClaw”
先确认 OpenClaw 已安装(openclaw --version
想换模型怎么操作
微信里直接发 /model glm或 /model deepseek即可
安卓能用吗
能!本文作者实测 8.0.69 版本可用

第六部分:安全提示

根据工业和信息化部、国家安全部的官方提醒,使用 OpenClaw 时请注意:

“六要六不要”建议:

  • ✅ 从官方渠道下载安装
  • ✅ 谨慎授予 API 权限
  • ✅ 定期检查 Skill 和插件来源
  • ❌ 不要在龙虾中存入敏感个人信息
  • ❌ 不要让龙虾自动执行高风险操作
  • ❌ 不要将 API Key 硬编码在公开脚本中

微信 ClawBot 是官方支持的接入方式,不会导致封号。但龙虾本身的权限和操作范围,还是需要你自己把控。


第七部分:接下来还能玩什么?

接入只是第一步,龙虾真正的威力在于扩展性

1. 给龙虾装 Skills

OpenClaw 支持 Skills 扩展。你可以给龙虾装上:周报生成器、简历优化助手、翻译官、公众号排版工具……装得越多,龙虾能干的事越多。

2. 接入 TTS(文字转语音)

目前龙虾还不会语音回复,但你可以自己配一个 TTS 服务。配好之后,发语音过去,龙虾语音回复你——就像真人对话一样。

3. 接入图片生成

发一条消息“画一只穿西装的小龙虾”,几秒后图片就到微信里了。做公众号的话,封面图、配图都可以让龙虾生成。

4. 打通 Obsidian 知识库

配置好 Skill 后,龙虾可以帮你把聊天精华、文章摘要自动归档到 Obsidian,打造你的第二大脑。


写在最后

AI Agent 真正普及,不靠大家学一堆配置,而是靠它悄悄进到大家本来就在用的地方。

微信,就是那个最现实的入口。

以前用 AI 工具的流程:打开浏览器 → 输入网址 → 登录账号 → 输入提示词 → 等待回复 → 复制结果 → 粘贴到需要的地方。

现在呢?微信里按住说话,结果直接在聊天窗口里出来。

对于微信重度用户来说,这种原生接入的方式,真的太爽了。

赶紧试试吧。

有问题评论区见,我们下期见!

本文综合参考了多位作者的实际测试经验,包括二哥狗腿子、逛逛GitHub、摸鱼小李、吴所不AI、凌顺实验室等。感谢先行者的探索。

参考文献:

https://mp.weixin.qq.com/s/NchBJfJ8D9J-TM1S3himog

https://mp.weixin.qq.com/s/p_ixB9WoWbDZ9BcDLCGTlQ 

https://mp.weixin.qq.com/s/fUR966lD16MN3cOQlmS0yw 

https://mp.weixin.qq.com/s/CmBxJtsHnXdKJS9n9c2vpQ 

https://mp.weixin.qq.com/s/J6LxZ9gsa44-ToObvqHTVQ 

https://mp.weixin.qq.com/s/75mJFt30uqG91w-opBKgtQ

📌 一键保存本文
👍 点赞 + 在看,分享给更多想玩龙虾的朋友~