OpenClaw 部署指南：开源 AI 助手接入飞书、微信、Telegram，多模型自由切换

ChatGPT 和 Claude 各自关在自己的网页与 App 里，想让 AI 出现在微信、飞书或 Telegram 的聊天列表里，过去得自己写代码对接一堆 API。开源项目 OpenClaw 解决的就是这件事：它跑在自己的电脑或服务器上，一头连接聊天软件，一头连接各家大模型，配置完成后就是一个常驻在线、带记忆的私人 AI 助手。本文梳理它的架构、渠道支持的实际情况，以及官方脚本与中文一键脚本两条部署路径。

OpenClaw 的定位与架构

把 OpenClaw 理解成装在自己设备上的 AI 网关比较贴切。它的核心是一个叫 Gateway 的常驻服务，负责管理会话、记忆、工具调用和渠道连接；聊天平台与 AI 模型都以插件形式接入，换模型不需要改动其他配置。模型一侧支持 Anthropic Claude、OpenAI、Google Gemini 这类托管接口，也支持通过 Ollama 调用跑在本地的开源模型（Llama、DeepSeek 等）；聊天一侧覆盖 Telegram、WhatsApp、Discord、Slack、Signal、iMessage、Microsoft Teams 等二十多个平台，另有 macOS、iOS、Android、Windows、Linux 的原生应用。项目早期名为 Clawdbot，不少教程和界面截图里还保留着旧名。

图：OpenClaw 在聊天渠道和 AI 模型之间充当网关，本体运行在用户自己的设备上

项目以 MIT 协议开源，由独立非营利组织 OpenClaw Foundation 维护，没有付费版本、托管服务和代币，会话状态、记忆与 API 凭证都留在用户自己的硬件上，也因此成了 GitHub 上热度最高的开源项目之一。与普通聊天机器人相比，它有三处实际差异：

跨平台持久记忆：会话状态持久化存储，在 Telegram 上聊到一半的技术问题，换到飞书接着问，上下文还在，长期项目交给它跟进不会断片。
主动推送与定时任务：可以设定时任务，每天早上推送新闻摘要；接上服务器监控后，出告警时它会主动发消息提醒。
技能系统：用 Markdown 文件定义自定义能力，配合命令执行、文件读写和联网浏览，能替人做事而不只是答题。

渠道支持的实际情况

国内用户最关心微信和飞书，这两个渠道在 OpenClaw 里的地位并不相同。飞书是官方插件，文档提供完整的配置指引，并且走飞书开放平台的 WebSocket 长连接模式接收事件，不需要公网回调地址，家里一台普通电脑就能接上。微信则通过外部插件 openclaw-weixin 接入，不在官方维护范围内；企业微信（WeCom）同样是外部插件。个人微信号接机器人一直存在账号风险，官方和插件作者都不为此兜底。在国内合规接入这件事上，飞书是最省心的选择，个人微信号方案只适合清楚并接受风险的用户。

官方安装路径

OpenClaw 官方提供跨平台安装脚本，macOS、Linux 和 WSL2 下一条命令完成，缺 Node.js 运行时会自动装好：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows 在 PowerShell 里执行：

iwr -useb https://openclaw.ai/install.ps1 | iex

自己管理 Node.js 环境的用户可以直接装 npm 包，要求 Node 24.16 或 26.1 以上，官方推荐 Node 26：

npm install -g openclaw@latest --allow-scripts=openclaw

装完运行引导向导，它会核验模型访问、创建工作区并配置好 Gateway；后两条命令分别用于查看服务状态和打开控制台界面：

openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard

官方文档站 docs.openclaw.ai 提供简体中文版，渠道接入、Docker 与 Nix 部署都有对应章节，遇到问题以它为准。

中文一键脚本与桌面版

社区开发者维护的 OpenClawInstaller 是另一条路径。需要说明的是，部分中文介绍把它称作”官方一键脚本”，它实际是第三方项目，与 OpenClaw 官方没有隶属关系。它的价值在于全中文的交互式配置菜单，一条命令启动：

curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/install.sh | bash

图：OpenClawInstaller 的中文配置菜单，标题沿用了项目旧名 ClawdBot（来源：项目文档）

脚本依次完成环境检测、OpenClaw 安装、模型与身份配置引导、API 连通性测试和服务启动。模型菜单覆盖 Claude、OpenAI、Gemini、OpenRouter、Groq、Mistral 和本地 Ollama；Claude 与 OpenAI 均支持自定义 API 地址，可以直接填 OneAPI、NewAPI 这类国内中转服务。用 OpenAI 中转时要先确认服务支持 v1/responses 接口，只支持传统 chat/completions 的老中转跑不起来。

图：AI 模型配置菜单，托管接口与本地模型都在列（来源：项目文档）

同一作者还开发了桌面版 OpenClaw Manager，基于 Tauri 构建，支持 Windows、macOS 和 Linux，提供服务状态仪表盘和可视化的模型、渠道配置，偏好图形界面的用户可以从它入手。

两条路径的取舍：能读英文文档、环境干净的用户直接走官方安装脚本更稳妥，版本跟进最及时；中文脚本胜在菜单友好、预置了国内中转接入，但执行陌生仓库的脚本前最好先下载下来看一遍内容，它标注的 Node 22+ 环境要求也已落后于官方当前版本，冲突时以官方文档为准。

部署前的安全边界

OpenClaw 能执行系统命令、读写文件、访问网络，这是它能干活的原因，也是部署时最该收紧的地方。三条建议在动手前先看一遍：

接入即时通讯平台优先走官方开放能力（机器人、应用、Webhook），少碰逆向协议类方案，降低账号与业务风险；
模型服务与回调地址要保证稳定的网络连通，企业场景建议在网关层统一做鉴权、限流和监控；
启用自动化或命令执行能力时，放进独立容器或独立主机隔离运行，收紧文件与网络权限，并给 API Key 设置额度上限。

适合谁

这套方案的价值在”常驻”：一台不关机的服务器、NAS 或闲置电脑，让 AI 助手全天在线、记得住事、能主动找人。需求只是偶尔在网页上问问题的话，部署它属于多余；已经习惯在聊天软件里安排工作、又愿意花一个下午做配置的用户，收益最明显。动手前想弄清它内部如何运转，可以先读站内的 OpenClaw 架构拆解；偏轻量的替代方案可以看零代码用 Claude Code 搭 Telegram 智能助手；想理解这类自建助手的通用设计思路，自建 AI 聊天助手实战里拆过架构与模型选型。