OpenClaw 中文安装教程:5分钟自部署私人AI助手,支持微信/QQ

🔧 AI工具 2026-07-12 · 更新于 2026-08-20 约 6 分钟阅读

OpenClaw 是一个 37 万+ Star 的开源个人 AI 助手,能把 Claude 系模型接进微信、QQ、Telegram 等 20 多个聊天平台。但中文安装教程几乎为零,很多人卡在第一步。这篇按「安装 → 配置 → 连微信/QQ → 排错」的顺序,一步步带你从零部署。

💡 你将学到

OpenClaw 是一个 37 万+ Star 的开源个人 AI 助手,能把 Claude 系模型接进微信、QQ、Telegram 等 20 多个聊天平台。但中文安装教程几乎为零,很多人卡在第一步。这篇按「安装 → 配置 → 连微信/QQ → 排错」的顺序,一步步带你从零部署。

📜 目录

OpenClaw 中文安装教程:5 分钟自部署私人 AI 助手,支持微信/QQ

OpenClaw 是一个跑在你本地设备上的开源 AI 助手:它把强大的大模型接入日常聊天软件,你直接在微信、QQ、Telegram 里跟它对话、让它查资料、写代码、跑定时任务。GitHub 上已有 37 万+ Star(以官方仓库为准),是目前最流行的自部署 AI 助手之一。中文用户最大的痛点是:官方文档偏英文、教程少,很多人卡在「怎么装」「怎么连微信」上。这篇教程按「安装 → 配置 → 接入 → 排错」四步讲完,全程可在 Windows 上操作。

一、安装前准备:3 样东西

准备项 要求 说明
Node.js 18.0 及以上 OpenClaw 基于 Node.js 运行,官网下载 LTS 版即可
Git 任意版本 拉取代码和更新用(可选,用 zip 包则不需要)
大模型 API Key 任选一家 支持 Anthropic Claude 系或 OpenAI 兼容接口;没有的话可用 Ollama 本地模型兜底

说明:OpenClaw 本身免费开源,运行成本主要来自你调用的大模型 API。想省钱可以先接便宜的模型,后续随时可换。

二、安装:两条路选一条

路线 A:npm 一键安装(推荐,最快)

Windows 下打开 PowerShell 或 CMD,依次执行:

npm install -g openclaw

安装完成后输入 openclaw --version,能打印版本号就说明装好了。

路线 B:源码安装(适合想二次开发的人)

git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm run build

源码安装的好处是升级灵活、能自己改代码,缺点是首次构建要等几分钟。

三、首次配置:把模型接进来

安装完还不能直接用,需要告诉 OpenClaw 用哪个模型。首次启动时按引导操作:

  1. 在终端输入 openclaw 启动
  2. 按提示选择模型提供商(Anthropic / OpenAI 兼容 / 本地 Ollama)
  3. 粘贴你的 API Key
  4. 确认后,OpenClaw 会在后台起一个本地服务(默认端口以官方文档为准)

验证是否跑通:在终端里直接跟它说一句话,比如「你好,介绍一下你自己」,能正常回复就说明模型通道 OK,可以进入下一步接聊天平台。

四、接入微信 / QQ(核心步骤)

通用逻辑:OpenClaw 通过「桥接器(bridge)」连接各平台。手机端微信、QQ 目前走的是扫码登录方式,需要保持手机在线。

接入微信:

  1. 在 OpenClaw 里执行启用微信桥接的命令(openclaw bridge add wechat,具体以官方文档为准)
  2. 终端会生成一个二维码
  3. 微信小号扫码(建议不要用主号,避免风控风险)
  4. 扫码成功后,别人给你这个小号发消息,OpenClaw 就会自动回复

接入 QQ:

  1. 执行 openclaw bridge add qq
  2. 同样用 QQ 小号扫码登录
  3. 登录成功后,QQ 消息自动接入 AI 回复

⚠️ 注意:个人微信 / QQ 的自动化登录有账号风控风险,务必使用小号,并遵守各平台用户协议。官方对风控问题的处理以官方文档说明为准。

其他平台:Telegram、Discord、Slack 等走 Bot Token 方式接入,比微信更稳,适合长期使用。如果你只是自己用,Telegram 其实是体验最好的选择。

五、常用配置速查表

配置项 作用 建议
默认模型 日常对话用的模型 先选便宜档,跑顺再升级
温度(temperature) 控制回答随机性 聊天 0.7 左右,写代码 0.2 左右
系统提示词 设定 AI 人设和边界 中文场景建议写「用中文回答」
自动回复开关 是否自动应答所有消息 不想被打扰时关掉,改为关键词触发
定时任务 让 AI 每天定点干活 日报、提醒、抓取都行

六、常见问题(FAQ)

Q:安装时提示 npm 权限不足 / EACCES 怎么办? A:Windows 下用管理员身份打开 PowerShell 重试;如果是 Linux/macOS,用 nvm 装 Node 可避免权限问题。

Q:启动后一直连不上模型? A:90% 是 API Key 填错或模型名不匹配。先检查 Key 是否有效(到模型商控制台看有没有报错),再确认模型 ID 与提供商文档一致。

Q:微信扫码后没反应? A:先确认手机网络正常、微信是最新版;再确认桥接服务没有报错。部分网络环境需要给 OpenClaw 配置代理,见官方文档「Proxy」一节。

Q:回复全是英文,怎么让它说中文? A:在系统提示词里明确写「请始终用简体中文回答」,并在配置里把语言设为 zh-CN(如果提供该选项)。

Q:会不会很费钱? A:取决于对话量。个人轻度使用(每天几十条)用便宜模型每月成本很低;重度使用可接本地 Ollama 模型,几乎只有电费。

Q:Windows 上要一直开着终端吗? A:本地模式需要保持 OpenClaw 进程运行。想 7×24 在线,可部署到云服务器或用 PM2 做进程守护。

注:本文命令与配置项以 OpenClaw 官方文档为准,版本更新后个别命令可能有变化。

相关文章

相关文章
2026-07-14
AI Agent工具箱大全:2026年最全工具生态盘点
2026-08-17
2026 波士顿最佳 AI PDF 摘要工具:7 款适合学生、生物科技与 Kendall Square
2026-07-27
云GPU对比

本站文章由编辑人工撰写,收录的工具均经过实测或公开资料核验。文中链接指向工具官网或 GitHub 仓库,仅作信息参考,不构成付费推广。

💬 评论 (0)

暂无评论,来说两句吧~

登录后评论