OpenClaw 教程从零开始搭建你的私人 AI 助手完全指南否是 检测系统环境Node.js 22 \n已安装? 安装 nvm\ncurl nvm install script⬇️ nvm install 22✅ 版本检测通过 npm 全局安装 OpenClaw\ncurl -fsSL openclaw.ai/install.sh | bash 创建配置目录\n~/.openclaw/⚙️ 初始化配置\nopenclaw onboard 启动 Gateway 服务\nopenclaw gateway start✨ AI 助手就绪\n端口 18789你是不是也有过这样的想法搞一个属于自己的 AI 助手能在 Telegram 上跟你聊天、帮你查资料、甚至帮你写代码不是那种网页版的 ChatGPT而是真正跑在你自己服务器上、随时待命的私人助手。这篇 OpenClaw 教程就是干这个的。OpenClaw 是一个开源的 AI 助手框架你可以把它部署在自己的 VPS、树莓派、甚至笔记本上然后通过 Telegram、WhatsApp、Discord 等平台跟它对话。它支持 627 种 AI 模型配置灵活上手也不难。废话不多说跟着这篇 OpenClaw 教程一步步来。OpenClaw 教程第一步安装与环境准备Node.js 22一键安装脚本OpenClaw 教程系统要求与前置条件在开始之前确认你的环境满足以下条件操作系统Linux推荐 Ubuntu 22.04、macOS、WSL2Node.js22.0 或更高版本这是硬性要求内存最低 512MB推荐 1GB网络能访问外网需要拉取 AI 模型 API如果你还没装 Node.js 22可以用 nvm 快速搞定curl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh|bashsource~/.bashrc nvminstall22node-v# 确认输出 v22.x.xOpenClaw 教程提示为什么必须是 Node.js 22OpenClaw 用到了不少 Node.js 22 的新特性比如原生 WebSocket 支持和改进的 ESM 模块系统。低版本会直接报错别问我怎么知道的。OpenClaw 教程一键安装脚本详解环境准备好了安装 OpenClaw 只需要一行命令curl-fsSLhttps://openclaw.ai/install.sh|bash这个脚本会自动完成以下操作检测你的系统环境和 Node.js 版本通过 npm 全局安装 OpenClaw创建默认配置目录~/.openclaw/生成初始配置文件安装完成后运行引导命令来完成初始化openclaw onboard这个交互式引导会带你走完基础配置包括设置工作目录和选择默认模型。如果你喜欢手动配置像我一样也可以跳过引导直接编辑配置文件。OpenClaw 教程配置你的第一个 AI 模型API Key 配置通过 Crazyrouter 接入 627 模型OpenClaw 教程理解配置文件结构OpenClaw 的所有配置都在一个文件里~/.openclaw/openclaw.json注意虽然后缀是.json但它实际上支持JSON5格式——也就是说你可以写注释、用尾逗号、用单引号。对开发者来说简直是福音。一个最小可运行的配置长这样{ // OpenClaw 最小配置 agents: { defaults: { // 工作目录存放 SOUL.md 等人格文件 workspace: ~/.openclaw/workspace, // AI 模型配置 model: { primary: openai/gpt-4o, // 格式provider/model }, }, }, }OpenClaw 教程小贴士Workspace 文件说明工作目录下有几个关键文件它们定义了你的 AI 助手的灵魂文件作用SOUL.md助手的核心人格和行为准则AGENTS.md工作流程和会话规则USER.md关于你用户的信息TOOLS.md工具使用笔记和 API 密钥IDENTITY.md助手的身份信息名字、性格等你可以随意编辑这些文件来定制你的助手。比如在SOUL.md里写上说话要简洁别废话你的助手就会变得言简意赅。OpenClaw 教程通过 Crazyrouter 一站式接入 627 模型OpenClaw 内置了多个 AI Provideropenai、anthropic、google、openrouter、deepseek。你可以直接填对应的 API Key 来使用。但如果你不想管理一堆 API Key这里有个更省事的方案——用Crazyrouter作为统一网关。Crazyrouter 是一个 AI 模型路由服务一个 API Key 就能访问 627 种模型包括 GPT-4o、Claude 4、Gemini 2.5、DeepSeek R1 等等。配置方式{ agents: { defaults: { workspace: ~/.openclaw/workspace, model: { // 通过 Crazyrouter 使用 Claude primary: openai/anthropic/claude-sonnet-4-20250514, }, providers: { openai: { apiKey: sk-your-crazyrouter-key, baseURL: https://crazyrouter.com/v1, }, }, }, }, }OpenClaw 教程进阶多模型切换策略你还可以配置 fallback 模型当主模型不可用时自动切换{ agents: { defaults: { model: { primary: openai/anthropic/claude-sonnet-4-20250514, fallback: openai/gpt-4o, // 主模型挂了用这个 fast: openai/gpt-4o-mini, // 简单任务用便宜的 }, }, }, }这样配置后你的助手会根据任务复杂度和模型可用性自动选择最合适的模型。OpenClaw 教程连接聊天平台Telegram、WhatsApp、Discord 配置 AI Models OpenClaw Gateway聊天平台 Telegram Discord WhatsApp Signal Slack 微信Channel Adapter\n消息格式统一Session Router\n会话路由Memory System\n记忆管理GPT-4oClaude 4Gemini 2.5DeepSeek R1模型配好了接下来要让你的 AI 助手上线——连接到你常用的聊天平台。OpenClaw 支持 Telegram、WhatsApp、Discord 等主流平台这里分别说说怎么配。OpenClaw 教程Telegram Bot 配置最推荐Telegram 是 OpenClaw 最推荐的平台配置最简单功能也最全。第一步创建 Telegram Bot在 Telegram 里找到BotFather发送/newbot按提示设置名字拿到 Bot Token格式类似123456:ABC-DEF...第二步写入配置{ agents: { defaults: { workspace: ~/.openclaw/workspace, model: { primary: openai/anthropic/claude-sonnet-4-20250514, }, providers: { openai: { apiKey: sk-your-crazyrouter-key, baseURL: https://crazyrouter.com/v1, }, }, }, }, channels: { telegram: { token: 你的-bot-token, allowFrom: [你的Telegram用户名], // 安全限制只允许特定用户 }, }, }OpenClaw 教程安全提醒务必设置 allowFromallowFrom是白名单机制只有列表里的用户才能跟你的 Bot 对话。如果不设置任何人都能用你的 Bot和你的 API 额度。这个坑踩过一次就够了。OpenClaw 教程WhatsApp 与 Discord 配置WhatsApp 配置需要用到 WhatsApp Business API配置稍微复杂一些{ channels: { whatsapp: { // WhatsApp Business API 配置 allowFrom: [86138xxxx1234], // 允许的手机号 }, }, }Discord 配置需要先在 Discord Developer Portal 创建一个 Application 和 Bot{ channels: { discord: { token: 你的-discord-bot-token, allowFrom: [你的Discord用户ID], }, }, }每个平台的详细配置可以参考 OpenClaw 官方文档这里就不展开了。核心思路都一样拿到平台的 Token填进配置文件设好白名单。OpenClaw 教程发送你的第一条消息Control UI 使用OpenClaw 教程启动 Gateway 服务所有配置就绪后启动 OpenClaw Gatewayopenclaw gateway startGateway 会在默认端口18789上启动。你可以用以下命令检查状态openclaw gateway status看到running就说明一切正常。如果遇到端口冲突可以在配置文件里改端口。OpenClaw 教程通过 Control UI 管理你的助手┌─────────────────────────────────────────────────────────────┐ │ OpenClaw Dashboard (localhost:18789) │ ├─────────────┬───────────────┬───────────────┬───────────────┤ │ Chat │ ⚙️ Settings │ Logs │ System │ ├─────────────┼───────────────┼───────────────┼───────────────┤ │ │ │ │ │ │ 实时对话 │ 模型切换 │ 对话日志 │ Cron 任务 │ │ 多会话管理 │ ├ GPT-4o │ 错误追踪 │ ├ 定时列表 │ │ 历史记录 │ ├ Claude 4 │ Token 用量 │ ├ 执行历史 │ │ 上下文预览 │ └ Gemini 2.5 │ 响应时间 │ └ 手动触发 │ │ │ │ │ │ │ Session 管理│ Provider 配置 │ 实时流式输出 │ Memory 管理 │ │ ├ 活跃会话 │ ├ API Key │ ├ stdout │ ├ MEMORY.md │ │ ├ 会话切换 │ ├ Base URL │ └ stderr │ ├ 每日记忆 │ │ └ 会话清理 │ └ Fallback │ │ └ 搜索记忆 │ │ │ │ │ │ │ Node 设备 │ Channel 配置 │ 性能监控 │ Skill 管理 │ │ ├ 在线状态 │ ├ Telegram │ ├ CPU/内存 │ ├ 已安装 │ │ ├ 设备能力 │ ├ Discord │ └ 连接数 │ └ 可用技能 │ │ └ 配对管理 │ └ WhatsApp │ │ │ └─────────────┴───────────────┴───────────────┴───────────────┘OpenClaw 自带一个 Web 管理界面Control UI启动方式openclaw dashboard打开浏览器访问http://localhost:18789你会看到一个简洁的管理面板包括聊天界面直接在网页上跟你的 AI 助手对话配置管理可视化编辑配置文件日志查看实时查看对话日志和错误信息模型切换一键切换不同的 AI 模型OpenClaw 教程实战发送第一条消息现在打开你的 Telegram找到你刚创建的 Bot发一条消息试试你好你是谁如果一切配置正确你的 AI 助手会在几秒内回复你。恭喜你的私人 AI 助手正式上线了如果没有收到回复按以下顺序排查openclaw gateway status确认服务在运行检查配置文件里的 Bot Token 是否正确确认allowFrom里有你的用户名查看日志openclaw gateway的终端输出OpenClaw 教程常用 CLI 命令速查最后整理一下你会经常用到的命令# 服务管理openclaw gateway start# 启动服务openclaw gateway stop# 停止服务openclaw gateway restart# 重启服务openclaw gateway status# 查看状态# 初始化与管理openclaw onboard# 交互式引导配置openclaw dashboard# 打开 Web 管理界面总结与推荐走到这里你已经完成了这篇 OpenClaw 教程的全部内容从安装环境、配置模型、连接平台到发送第一条消息。整个过程其实就三步装好 OpenClaw → 填好配置 → 启动服务。关于 AI 模型的选择如果你不想折腾多个 API Key强烈推荐试试 Crazyrouter。一个 Key 搞定 627 模型支持 OpenAI、Anthropic、Google、DeepSeek 等所有主流厂商价格透明按量计费还有免费额度可以体验。对于个人开发者和小团队来说省去了管理多个账号的麻烦是搭配 OpenClaw 使用的最佳选择。有问题去 OpenClaw GitHub 提 Issue或者加入社区讨论。Happy hacking!