零基础保姆级教程:在 Windows 上部署 OpenClaw 接入 DeepSeek 与微信/Telegram

发布时间:2026/5/19 16:03:01

零基础保姆级教程:在 Windows 上部署 OpenClaw 接入 DeepSeek 与微信/Telegram 本文专为完全不懂计算机的普通用户编写。我们将从零开始一步步在 Windows 电脑上完成 OpenClaw 的彻底重装、DeepSeek 模型的接入以及 Telegram 和微信双频道的配置。更重要的是我会把部署过程中最容易踩坑的报错信息全部列出并给出直接的解决方案。一、彻底卸载旧版本如果你之前装过如果你之前折腾过 OpenClaw或者装过本地模型强烈建议先进行一次大扫除从零开始。1.打开命令行按下 Win R 键输入 cmd按下回车。2.停止并卸载后台服务在黑框中依次输入以下命令并回车openclaw gateway stop openclaw gateway uninstall3.卸载主程序npm uninstall -g openclaw4.删除残留数据关键这一步会清除旧的配置和聊天记录确保重装是全新状态。rmdir /s /q %USERPROFILE%\.openclaw rmdir /s /q %USERPROFILE%\.clawdbot二、全新安装与接入 DeepSeek1.安装openclaw在命令行中输入npm install -g openclawlatest2.运行初始化向导输入以下命令启动配置向导openclaw onboard --install-daemon在向导中请严格按照以下选项进行选择使用键盘上下键选择回车确认•Onboarding mode: 选择 Quickstart•Model/auth provider: 选择 Custom Provider•API Base URL: 输入 https://api.deepseek.com•API Key: 粘贴你申请好的 DeepSeek API Key•Endpoint compatibility: 选择 OpenAI-compatible•Model ID: 输入 deepseek-reasoner•Endpoint ID: 保持默认 直接回车•Model alias: 输入 deepseek•后续的各种可选集成 (Optional integrations): 全部选 No•Run the gateway: 选 Yes 启动网关3.修复上下文窗口限制必做OpenClaw 对自定义模型默认只给 4096 的上下文长度而 DeepSeek 需要更大的空间不改的话发长消息会报错。1.打开浏览器访问 http://127.0.0.1:18789/config 。2.在设置页面中选择 Raw 选项卡查看 JSON 源码。3.找到 models 下面的 contextWindow: 4096。4.将 4096 改为 128000。5.点击 Apply 保存。三、接入 Telegram 频道可跳过1.修改配置文件打开文件资源管理器进入 C:\Users\你的用户名\.openclaw\ 文件夹用记事本打开 openclaw.json。找到 channels 部分添加你的 Telegram Bot Tokenchannels: { telegram: { enabled: true, dmPolicy: pairing, botToken: 你的_TELEGRAM_BOT_TOKEN, groupPolicy: allowlist, streaming: partial } }同时确认 plugins 部分中 Telegram 插件已启用plugins: { entries: { telegram: { enabled: true } } }2.❗️踩坑预警Telegram 网络超时报错报错现象[telegram] fetch fallback: enabling sticky IPv4-only dispatcher (codesUND_ERR_CONNECT_TIMEOUT)[telegram] telegram setMyCommands failed: Network request for setMyCommands failed!原因在国内Telegram 的服务器是被屏蔽的OpenClaw 连不上。错误解法在 openclaw.json 里加 httpProxy 字段会报错 Unrecognized key: httpProxy 。正确解法1.在 C:\Users\你的用户名\.openclaw\ 目录下新建一个名为 .env 的文件注意前面有个点。2.用记事本打开写入你的代理配置假设你的代理软件本地端口是 7890HTTP_PROXYhttp://127.0.0.1:7890 HTTPS_PROXYhttp://127.0.0.1:78903.保存后 在命令行运行 openclaw gateway restart 重启网关。3.完成配对授权当你在 Telegram 给机器人发消息时可能会收到这样的回复OpenClaw: access not configured. Your Telegram user id: 8167999413 Pairing code: 6S9V3RXH Ask the bot owner to approve with: openclaw pairing approve telegram 6S9V3XXX这是安全机制。只需复制提示中的命令在你的电脑命令行中运行即可openclaw pairing approve telegram 6S9V3XXX四、接入微信频道微信接入是整个过程中最容易出问题的环节。官方提供了一个一键安装脚本但在 Windows 上往往会水土不服。踩坑预警1找不到 openclaw报错现象[openclaw-weixin] 未找到 openclaw请先安装npm install -g openclaw原因官方脚本使用了 Linux 的 which 命令来检测环境在 Windows 上根本不存在这个命令所以永远会报错。正确解法直接放弃官方的 npx 一键脚本改为手动执行它背后的三条核心命令。踩坑预警 2权限不足报错现象npm error code EPERMnpm error syscall opennpm error path D:\nodejs\node_cache\_cacache\tmp\...原因普通命令行窗口没有写入 Node.js 缓存目录的权限。正确解法点击开始菜单搜索 cmd右键选择以管理员身份运行。接下来的所有命令都在这个管理员窗口中执行。⭐️微信接入正确步骤手动在管理员权限的命令行中依次运行第一步安装微信插件openclaw plugins install tencent-weixin/openclaw-weixin第二步修改配置文件信任插件打开 C:\Users\你的用户名\.openclaw\openclaw.json在 plugins 部分添加 allow 字段plugins: { allow: [openclaw-weixin], entries: { telegram: { enabled: true }, openclaw-weixin: { enabled: true } } }保存后运行 openclaw gateway restart 重启网关。第三步扫码登录openclaw channels login --channel openclaw-weixin踩坑预警 3终端二维码无法扫描报错现象运行登录命令后终端里出现了一个由各种方块字符拼成的巨大二维码手机微信怎么扫都扫不出来。原因终端字符二维码比例失调信息已经损坏。正确解法1.在命令行内输入openclaw channels login --channel openclaw-weixin C:\Users\用户名\Desktop\wechat_login.log 212.生成日志文档。3.把内容原封不动输送给常用的大模型可以重新生成可扫描的二维码图片。4.用准备作为机器人的手机微信扫描生成的图片确认登录。总结到这里你的 OpenClaw 应该已经成功在后台运行并且同时接管了 Telegram 和微信的消息。DeepSeek 的强大推理能力将为你提供极佳的对话体验。部署开源项目时遇到报错是非常正常的关键是要看懂报错信息找到根本原因。希望这篇踩坑指南能帮你少走弯路顺利拥有自己的 AI 助手如果有任何问题欢迎在评论区讨论彩蛋目前的使用场景就是在手机微信端可以聊天也可以操作服务器端的文件输入输出无法访问好友列表、公众号列表等隐私信息还处于1.0.2版本静待腾讯之后的升级

相关新闻