OpenClaw 中文安装教程:5分钟自部署私人AI助手,支持微信/QQ
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 用哪个模型。首次启动时按引导操作:
- 在终端输入
openclaw启动 - 按提示选择模型提供商(Anthropic / OpenAI 兼容 / 本地 Ollama)
- 粘贴你的 API Key
- 确认后,OpenClaw 会在后台起一个本地服务(默认端口以官方文档为准)
验证是否跑通:在终端里直接跟它说一句话,比如「你好,介绍一下你自己」,能正常回复就说明模型通道 OK,可以进入下一步接聊天平台。
四、接入微信 / QQ(核心步骤)
通用逻辑:OpenClaw 通过「桥接器(bridge)」连接各平台。手机端微信、QQ 目前走的是扫码登录方式,需要保持手机在线。
接入微信:
- 在 OpenClaw 里执行启用微信桥接的命令(
openclaw bridge add wechat,具体以官方文档为准) - 终端会生成一个二维码
- 用微信小号扫码(建议不要用主号,避免风控风险)
- 扫码成功后,别人给你这个小号发消息,OpenClaw 就会自动回复
接入 QQ:
- 执行
openclaw bridge add qq - 同样用 QQ 小号扫码登录
- 登录成功后,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 官方文档为准,版本更新后个别命令可能有变化。
相关文章
本站文章由编辑人工撰写,收录的工具均经过实测或公开资料核验。文中链接指向工具官网或 GitHub 仓库,仅作信息参考,不构成付费推广。
