1. 概述

本文档记录了在 Windows 11 系统上将 OpenClaw（个人 AI 助手框架）接入微信的完整过程。通过这一配置，用户可以在微信上与 AI 机器人对话，由 DeepSeek V4 Pro 模型提供智能回复。整个过程涉及 OpenClaw 安装、微信插件配置、扫码授权、DeepSeek 提供商配置以及网关启动等步骤。

2. 安装 OpenClaw

首先需要全局安装 OpenClaw 框架。OpenClaw 是一个个人 AI 助手框架，支持接入多种聊天渠道（微信、Telegram、Discord 等），并提供插件系统和网关服务。

命令：

npm install -g openclaw

该命令会安装约 560 个依赖包。安装过程中会看到一些弃用警告（deprecated warnings），这些警告不影响正常使用。安装完成后，可通过以下命令验证：

openclaw –version          # 输出: OpenClaw 2026.5.7 (eeef486)

3. 安装微信插件

OpenClaw 通过插件机制支持微信渠道。执行以下命令安装微信插件：

命令：

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

此命令执行以下操作：

1. 检测本地已安装的 OpenClaw 版本（2026.5.7）

2. 下载并安装 @tencent-weixin/openclaw-weixin 插件到 ~\.openclaw\npm\node_modules\

3. 创建扩展符号链接：将插件链接到 ~\.openclaw\extensions\ 目录

4. 尝试进行首次微信连接

4. 解决 Symlink 权限问题

在 Windows 系统上，安装程序尝试创建符号链接（symlink）时遇到权限错误：

错误信息：

EPERM: operation not permitted, symlink ‘…\openclaw-weixin’ -> ‘…\extensions\openclaw-weixin’

⚠️ 注意：Windows 默认情况下，创建符号链接需要管理员权限。这是 Windows 安全策略的一部分，非管理员用户无法创建 symlink。

解决方案：手动复制目录

由于权限限制无法创建符号链接，采用手动复制目录的方式绕过此问题：

命令：

cp -r ~/.openclaw/npm/node_modules/@tencent-weixin/openclaw-weixin \          ~/.openclaw/extensions/openclaw-weixin

复制完成后，OpenClaw 即可识别 openclaw-weixin 渠道。如果后续插件有更新，需要重新执行此复制操作。

5. 扫码登录微信

插件就绪后，执行登录命令进行微信授权：

命令：

openclaw channels login –channel openclaw-weixin

登录过程：

1. 终端显示一个二维码（ASCII QR Code）

2. 使用手机微信扫描该二维码

3. 确认授权后，系统提示「已将此 OpenClaw 连接到微信」

4. 配置文件和认证凭据自动保存到 ~\.openclaw\openclaw.json

💡 提示：二维码有效期约 60 秒，过期后会自动刷新（最多 3 次）。建议在终端显示二维码后立即用手机扫描。如果 3 次都过期，需要重新执行登录命令。

登录成功后，OpenClaw 配置中会增加微信渠道的认证信息，包括微信账号 ID 和会话凭据。

6. 配置 DeepSeek AI 提供商

OpenClaw 默认使用 OpenAI 作为 AI 提供商。我们需要将其切换为 DeepSeek。DeepSeek 提供兼容 OpenAI API 格式的接口，可通过 OpenClaw 的原生 DeepSeek 提供商进行配置。

6.1 执行 onboard 配置

命令：

openclaw onboard –non-interactive \          –mode local \          –auth-choice deepseek-api-key \          –deepseek-api-key “sk-xxxxxxxx” \          –skip-health \          –accept-risk

此命令自动完成以下配置：

6.2 手动修改默认模型

onboard 默认将 deepseek-v4-flash 设为 primary 模型。根据需求手动修改配置文件，将主模型切换为 deepseek-v4-pro：

修改位置：

# 修改 ~\.openclaw\openclaw.json          “model”: {          “primary”: “deepseek/deepseek-v4-pro”          }

7. 启动网关

所有配置完成后，启动 OpenClaw 网关服务。网关负责管理 AI 模型调用、渠道消息收发、插件运行等核心功能。

7.1 安装网关服务

命令：

openclaw gateway install

该命令会注册 Windows 启动项，使网关服务随系统自动启动。同时自动生成网关 Token 并写入配置文件。

7.2 启动网关

命令：

openclaw gateway

启动成功后，终端显示关键状态信息：

⚠️ 注意：如果启动时提示端口已被占用，先执行 openclaw gateway stop 停止旧进程，再重新启动。

8. 最终状态总览

以下是系统正常运行时的完整状态：

9. 常用命令速查

10. 已知问题与注意事项

■ Windows Symlink 权限

在非管理员权限下无法创建符号链接。当前采用手动复制目录的方式绕过。如需彻底解决，可使用管理员权限运行安装命令，或启用 Windows 开发者模式。

■ 插件安全警告

openclaw-weixin 插件包含 4 个可疑代码模式。建议运行 openclaw security audit –deep 进行检查。

■ Web 搜索功能

如需使用 Web 搜索工具，需额外配置 Brave API Key：          openclaw configure –section web

■ Windows 兼容性

OpenClaw 官方建议在 WSL2 上运行以获得最佳体验。Windows 原生模式可用，但可能遇到一些边缘问题。

11. 架构示意

以下为文字版架构说明，建议配合截图工具标注关键流程：

┌─────────────────────────────────────────────────────┐          │手机微信│          │(用户发送/接收消息)│          └─────────────────┬───────────────────────────────────┘          │ 微信服务器中转          ▼          ┌─────────────────────────────────────────────────────┐          │OpenClaw Gateway (127.0.0.1:18789)│          │┌──────────┐┌───────────┐┌──────────────────┐ │          ││ Weixin││Agent││Other Plugins│ │          ││ Plugin│──│Engine│──│(browser, …)│ │          │└──────────┘└─────┬─────┘└──────────────────┘ │          │││          ││ API 调用│          └──────────────────────┼──────────────────────────────┘          │          ▼          ┌─────────────────────────┐          │DeepSeek API│          │(api.deepseek.com)│          │模型: V4 Pro│          └─────────────────────────┘          

— 全文完 —