OpenClaw 教程：从零开始搭建你的私人 AI 助手完全指南

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

你是不是也有过这样的想法：搞一个属于自己的 AI 助手，能在 Telegram 上跟你聊天、帮你查资料、甚至帮你写代码？不是那种网页版的 ChatGPT，而是真正跑在你自己服务器上、随时待命的私人助手。

这篇 OpenClaw 教程就是干这个的。OpenClaw 是一个开源的 AI 助手框架，你可以把它部署在自己的 VPS、树莓派、甚至笔记本上，然后通过 Telegram、WhatsApp、Discord 等平台跟它对话。它支持 627+ 种 AI 模型，配置灵活，上手也不难。

废话不多说，跟着这篇 OpenClaw 教程一步步来。

OpenClaw 教程：系统要求与前置条件

在开始之前，确认你的环境满足以下条件：

操作系统：Linux（推荐 Ubuntu 22.04+）、macOS、WSL2
Node.js：22.0 或更高版本（这是硬性要求）
内存：最低 512MB，推荐 1GB+
网络：能访问外网（需要拉取 AI 模型 API）

如果你还没装 Node.js 22+，可以用 nvm 快速搞定：

OpenClaw 教程提示：为什么必须是 Node.js 22+？

OpenClaw 用到了不少 Node.js 22 的新特性，比如原生 WebSocket 支持和改进的 ESM 模块系统。低版本会直接报错，别问我怎么知道的。

OpenClaw 教程：一键安装脚本详解

环境准备好了，安装 OpenClaw 只需要一行命令：

这个脚本会自动完成以下操作：

检测你的系统环境和 Node.js 版本
通过 npm 全局安装 OpenClaw
创建默认配置目录
生成初始配置文件

安装完成后，运行引导命令来完成初始化：

这个交互式引导会带你走完基础配置，包括设置工作目录和选择默认模型。如果你喜欢手动配置（像我一样），也可以跳过引导，直接编辑配置文件。

OpenClaw 教程：理解配置文件结构

OpenClaw 的所有配置都在一个文件里：

注意，虽然后缀是，但它实际上支持 JSON5 格式——也就是说你可以写注释、用尾逗号、用单引号。对开发者来说简直是福音。

一个最小可运行的配置长这样：

OpenClaw 教程小贴士：Workspace 文件说明

工作目录下有几个关键文件，它们定义了你的 AI 助手的“灵魂”：

文件作用助手的核心人格和行为准则工作流程和会话规则关于你（用户）的信息工具使用笔记和 API 密钥助手的身份信息（名字、性格等）

你可以随意编辑这些文件来定制你的助手。比如在里写上“说话要简洁，别废话”，你的助手就会变得言简意赅。

OpenClaw 教程：通过 Crazyrouter 一站式接入 627+ 模型

OpenClaw 内置了多个 AI Provider：、、、、。你可以直接填对应的 API Key 来使用。

但如果你不想管理一堆 API Key，这里有个更省事的方案——用 Crazyrouter 作为统一网关。

Crazyrouter 是一个 AI 模型路由服务，一个 API Key 就能访问 627+ 种模型，包括 GPT-4o、Claude 4、Gemini 2.5、DeepSeek R1 等等。配置方式：

OpenClaw 教程进阶：多模型切换策略

你还可以配置 fallback 模型，当主模型不可用时自动切换：

这样配置后，你的助手会根据任务复杂度和模型可用性自动选择最合适的模型。

模型配好了，接下来要让你的 AI 助手“上线”——连接到你常用的聊天平台。OpenClaw 支持 Telegram、WhatsApp、Discord 等主流平台，这里分别说说怎么配。

OpenClaw 教程：Telegram Bot 配置（最推荐）

Telegram 是 OpenClaw 最推荐的平台，配置最简单，功能也最全。

第一步：创建 Telegram Bot

在 Telegram 里找到
发送，按提示设置名字
拿到 Bot Token（格式类似）

第二步：写入配置

OpenClaw 教程安全提醒：务必设置 allowFrom

是白名单机制，只有列表里的用户才能跟你的 Bot 对话。如果不设置，任何人都能用你的 Bot（和你的 API 额度）。这个坑踩过一次就够了。

OpenClaw 教程：WhatsApp 与 Discord 配置

WhatsApp 配置需要用到 WhatsApp Business API，配置稍微复杂一些：

Discord 配置需要先在 Discord Developer Portal 创建一个 Application 和 Bot：

每个平台的详细配置可以参考 OpenClaw 官方文档，这里就不展开了。核心思路都一样：拿到平台的 Token，填进配置文件，设好白名单。

OpenClaw 教程：启动 Gateway 服务

所有配置就绪后，启动 OpenClaw Gateway：

Gateway 会在默认端口 18789 上启动。你可以用以下命令检查状态：

看到就说明一切正常。如果遇到端口冲突，可以在配置文件里改端口。

OpenClaw 教程：通过 Control UI 管理你的助手

OpenClaw 自带一个 Web 管理界面（Control UI），启动方式：

打开浏览器访问，你会看到一个简洁的管理面板，包括：

聊天界面：直接在网页上跟你的 AI 助手对话
配置管理：可视化编辑配置文件
日志查看：实时查看对话日志和错误信息
模型切换：一键切换不同的 AI 模型

OpenClaw 教程实战：发送第一条消息

现在，打开你的 Telegram，找到你刚创建的 Bot，发一条消息试试：

如果一切配置正确，你的 AI 助手会在几秒内回复你。恭喜，你的私人 AI 助手正式上线了！

如果没有收到回复，按以下顺序排查：

确认服务在运行
检查配置文件里的 Bot Token 是否正确
确认里有你的用户名
查看日志：的终端输出

OpenClaw 教程：常用 CLI 命令速查

最后整理一下你会经常用到的命令：

走到这里，你已经完成了这篇 OpenClaw 教程的全部内容：从安装环境、配置模型、连接平台到发送第一条消息。整个过程其实就三步：装好 OpenClaw → 填好配置 → 启动服务。

关于 AI 模型的选择，如果你不想折腾多个 API Key，强烈推荐试试 Crazyrouter。一个 Key 搞定 627+ 模型，支持 OpenAI、Anthropic、Google、DeepSeek 等所有主流厂商，价格透明，按量计费，还有免费额度可以体验。对于个人开发者和小团队来说，省去了管理多个账号的麻烦，是搭配 OpenClaw 使用的**选择。

有问题？去 OpenClaw GitHub 提 Issue，或者加入社区讨论。

Happy hacking! 🚀