用 OpenClaw + DeepSeek 接入微信 ClawBot：我的 AI 微信机器人搭建过程

这篇文章记录我把微信接入 AI 的完整过程。最终效果是：微信里出现一个 “微信 ClawBot” 联系人，它背后由 OpenClaw 微信接入 + DeepSeek 模型回复 + 本地后台 Gateway 服务 组成。

一、整体架构

我的最终方案不是使用 itchat-uos，而是使用更稳定的 OpenClaw 接入方式。

整体结构如下：

微信消息
  ↓
微信 ClawBot
  ↓
OpenClaw 微信接入
  ↓
OpenClaw Gateway 本地后台服务
  ↓
DeepSeek API
  ↓
AI 生成回复
  ↓
返回到微信

简单理解：

微信 ClawBot = OpenClaw 的微信接入 + DeepSeek 提供回复 + 后台 gateway 服务常驻运行

二、为什么不用 itchat-uos

我一开始尝试过使用 itchat-uos 写微信机器人，但遇到了一个很典型的问题：

• 扫码后无法稳定登录
• 二维码反复刷新
• 登录状态容易失效
• 部分微信号已经不支持网页版协议

原因是 itchat-uos 依赖微信网页版协议，而现在微信对网页版登录限制比较严格。所以后面我换成了 OpenClaw 方案。

三、确认电脑上已经有 OpenClaw

我在终端中检查 OpenClaw 是否安装：

command -v openclaw

我的电脑返回：

/opt/homebrew/bin/openclaw

然后查看 OpenClaw 版本：

openclaw --version

返回结果类似：

OpenClaw 2026.7.1

这说明 OpenClaw 已经安装成功。

四、安装 DeepSeek Provider 插件

为了让 OpenClaw 使用 DeepSeek 模型，我安装了 DeepSeek Provider：

openclaw plugins install @openclaw/deepseek-provider

这个插件的作用是让 OpenClaw 可以调用 DeepSeek API 生成回复。

五、配置 DeepSeek API Key

我先准备 DeepSeek API Key，然后配置到本地环境文件中。

可以创建或编辑：

~/.openclaw/.env

写入：

DEEPSEEK_API_KEY=你的_DeepSeek_API_Key

注意：

这个文件里包含密钥，不能上传到 GitHub，也不要截图公开。

如果你之前已经在项目 .env 里写过 DeepSeek Key，也可以把它同步到 OpenClaw 的环境配置里。

六、初始化 OpenClaw，并安装后台服务

接下来运行 OpenClaw 初始化命令：

openclaw onboard --auth-choice deepseek-api-key --install-daemon

这个命令主要做了几件事：

1. 使用 DeepSeek API Key 作为 AI 模型认证方式
2. 初始化 OpenClaw 配置
3. 安装本地后台服务
4. 让 OpenClaw Gateway 可以常驻运行

安装完成后，OpenClaw 会在本机创建相关配置目录。

我的配置目录位于：

~/.openclaw

其中微信接入相关数据在：

~/.openclaw/openclaw-weixin

七、确认微信接入配置

我本地可以看到类似这样的微信接入文件：

~/.openclaw/openclaw-weixin/accounts.json
~/.openclaw/openclaw-weixin/accounts/xxxx-im-bot.json

这些文件说明 OpenClaw 已经创建了微信机器人账号配置。

微信里显示出来的联系人就是：

微信 ClawBot

它就是 OpenClaw 创建的微信 AI 接入口。

八、确认后台 Gateway 服务

OpenClaw 会安装一个 macOS 后台服务。

我的服务文件在：

~/Library/LaunchAgents/ai.openclaw.gateway.plist

里面可以看到 Gateway 服务启动命令，核心是：

openclaw gateway --port 18789

也就是说，本地会常驻一个 OpenClaw Gateway 服务，端口是：

18789

可以用下面命令查看服务是否存在：

launchctl list | grep openclaw

如果需要重启服务，可以执行：

launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway

九、最终效果

配置完成后，微信中出现：

微信 ClawBot

我给它发送消息，它会经过 OpenClaw 转发给 DeepSeek，然后把 AI 生成的内容回复到微信。

整个链路是：

我发送微信消息
  → 微信 ClawBot 收到
  → OpenClaw Gateway 处理
  → DeepSeek 生成回复
  → ClawBot 返回微信消息

十、上传 GitHub 时要注意

如果我要把项目上传到 GitHub，一定要添加 .gitignore，避免泄露密钥和本地缓存。

推荐 .gitignore：

.env
*.env
__pycache__/
*.pyc
.venv/
venv/
.DS_Store
itchat.pkl
QR.png

尤其不要上传：

DEEPSEEK_API_KEY
OPENAI_API_KEY
~/.openclaw/.env

十一、总结

这次最终跑通的方案是：

OpenClaw + 微信接入 + DeepSeek Provider + macOS 后台 Gateway

相比 itchat-uos，OpenClaw 方案更稳定，不需要一直处理网页版微信登录失败、二维码反复刷新等问题。

我电脑里的实际状态是：

OpenClaw 安装路径：/opt/homebrew/bin/openclaw
OpenClaw 配置目录：~/.openclaw
微信接入目录：~/.openclaw/openclaw-weixin
后台服务文件：~/Library/LaunchAgents/ai.openclaw.gateway.plist
Gateway 端口：18789
AI 模型来源：DeepSeek

最终微信里的 “微信 ClawBot”，就是通过这套流程接入成功的。
这个 微信 ClawBot 不是用 python main.py 启动的，它是通过 OpenClaw 后台服务运行的。

1. 先确认 OpenClaw 是否在后台运行
   在终端输入：
   launchctl list | grep openclaw
   如果能看到类似：
   ai.openclaw.gateway
   说明后台服务已经在运行。
2. 如果没运行，启动它
   输入：
   launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway
   这会启动或重启 OpenClaw Gateway。
3. 查看日志
   如果想看它有没有正常工作：
   tail -f ~/Library/Logs/openclaw/gateway.log
   按 Control + C 可以退出日志查看。
4. 使用方法
   打开微信，找到这个联系人：
   微信 ClawBot
   直接给它发消息就行。消息链路是：
   你发消息给微信 ClawBot
   → OpenClaw Gateway 收到
   → 调用 DeepSeek
   → 生成 AI 回复
   → 微信 ClawBot 回复你
5. 如果 DeepSeek Key 失效
   检查这个配置文件：
   ~/.openclaw/.env
   里面应该有：
   DEEPSEEK_API_KEY=你的_DeepSeek_API_Key
   改完 Key 后重启：
   launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway
   简单说：平时你不用手动运行 Python 脚本，只要后台 ai.openclaw.gateway 在运行，直接在微信里找 微信 ClawBot 聊天就可以。

11:02