乐于分享
好东西不私藏

《5分钟搭建你的专属AI助手:OpenClaw 部署完全指南》

《5分钟搭建你的专属AI助手:OpenClaw 部署完全指南》

前言

你是否有这样的需求——想让 AI 助手直接在微信、飞书、Telegram 里回复消息,就像跟朋友聊天一样自然?

今天介绍一个开源工具 OpenClaw,它是一个自托管的 AI 网关,可以连接任意聊天平台到 AI 模型,5 分钟即可搭建完成。

OpenClaw 是什么?

OpenClaw 本质上是一个本地 AI 网关服务,运行在你自己的电脑或服务器上。它扮演"翻译官"的角色,把微信、飞书、Telegram 等平台的消息转发给 AI 模型,再把 AI 的回复送回聊天界面。

核心特点:

自托管,数据完全在自己手上

支持 20+ 聊天平台(飞书、Telegram、WhatsApp、Discord 等)

开源免费,可自定个性化

支持多种大模型(Claude、GPT、MiniMax 等)

系统要求

项目 要求

Node.js 24.x(推荐)或 22.14+

操作系统 macOS / Linux / Windows(WSL2 推荐)

内存 建议 4GB+

网络 能够访问你所用模型的 API

快速安装(5分钟完成)

Windows 用户(PowerShell):

Copy

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

macOS / Linux / WSL2 用户:

Copy

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

安装脚本会自动检测系统环境、安装 Node.js(如需要)并启动引导配置。

初始化配置

安装完成后,运行引导向导:

Copy

openclaw onboard --install-daemon

向导会逐步提示你:

选择模型服务商 — 支持 OpenAI、Anthropic、MiniMax 等

填入 API Key — 获取方式见各平台文档

配置网关端口 — 默认 18789

设置访问密码 — 保护你的 Gateway 安全

启动网关并验证

Copy

openclaw gateway status

看到 Gateway listening on port 18789 即表示运行正常。

打开浏览器访问:

Copy

openclaw dashboard

这是 OpenClaw 的 Web 控制台,可以直接在这里跟 AI 对话。

连接飞书(适合国内用户)

相比 Telegram 和 WhatsApp,飞书是国内用户最友好的选择。

第一步:在飞书开放平台创建应用

打开 open.feishu.cn

创建企业自建应用,获得 App ID 和 App Secret

第二步:配置 OpenClaw

Copy

openclaw config set channels.feishu.appId 你的AppID

openclaw config set channels.feishu.appSecret 你的AppSecret

第三步:开启机器人能力

在飞书开放平台 → 应用能力 → 机器人 → 开启

第四步:配置事件订阅

进入「事件与回调」→ 订阅方式选择「使用长连接接收事件」→ 添加事件 im.message.receive_v1

完成后重启 Gateway:

Copy

openclaw gateway restart

在飞书里给机器人发一条消息,验证是否联通。

连接 Telegram(最简方案)

如果飞书配置太麻烦,Telegram 是最简单的接入方式:

在 Telegram 搜索 @BotFather,发送 /newbot

获得 Bot Token

配置:

Copy

openclaw config set channels.telegram.enabled true

openclaw config set channels.telegram.botToken 你的Token

openclaw gateway restart

进阶配置:让 AI 更好用

配置中文名字和角色(SOUL.md):

在 ~/.openclaw/workspace/SOUL.md 中定义 AI 的人格设定,比如:

Copy

名字:雷赛

风格:直接、高效、有点个性

配置内存记忆(MEMORY.md):

让 AI 跨会话记住重要信息,类似长期记忆功能。

定时任务(Cron):

可以设置定时提醒、新闻推送等自动化任务。

常见问题

Q:消息没有回复怎么排查?

Copy

openclaw logs --limit 100

查看网关日志,定位是认证错误还是消息未收到。

Q:飞书机器人显示白屏?

飞书版本过旧或应用未发布。尝试升级飞书、或在开放平台「版本管理与发布」中创建测试版本。

Q:API 调用被限速?

检查你使用的模型服务商的速率限制,MiniMax 等国内服务商通常有免费额度。

写在最后

OpenClaw 的价值在于把 AI 助手真正融入日常沟通工具——你不需要打开特定 App,直接在飞书里 @一下就能用,体验和发消息一样自然。

对于有技术能力的用户,它是搭建私人 AI 助理的利器;对于企业用户,配合飞书这样的平台,还能实现客服自动化、工作流编排等场景。

GitHub:https://github.com/openclaw/openclaw

官方文档:https://docs.openclaw.ai