OpenClaw 5分钟快速上手：本地网关部署全流程指南

很多人听说过"AI网关"这个概念，但一想到要本地部署，就头皮发麻——环境变量、Node.js版本、配置文件，一堆技术名词直接劝退。其实只要搞清楚整体架构，5分钟跑起来完全不是吹牛。今天就用这篇教程，把OpenClaw的本地部署流程拆开揉碎讲一遍，保证你看完就能上手。

先搞懂OpenClaw是什么

OpenClaw本质上是一个本地AI网关——它扮演的角色是把各种AI模型（如Claude、GPT等）和你的各种通讯渠道（Telegram、WhatsApp、Discord等）连接起来的中枢。你不需要在每个平台单独配置机器人，OpenClaw帮你统一管理对话历史、插件、技能和访问权限。

换句话说：装好OpenClaw，你就有了一个完全私有、可本地运行、可自定义的AI助手大脑。你的聊天记录、配置、工作区数据都在自己机器上，不经过任何第三方服务器。

安装前的准备：Node.js环境

OpenClaw基于Node.js运行，所以第一步必须确认你的机器上装有Node.js。官方推荐Node.js 24及以上版本。

打开终端，输入以下命令检查当前版本：

node --version

如果显示的版本号低于24，或者根本没有安装Node.js，你需要先安装它。推荐使用版本管理工具来安装Node.js，这样以后切换版本也更方便。 macOS和Linux用户可以用nvm（Node Version Manager）来管理多个Node版本，Windows用户则可以考虑nvs或者直接下载官方安装包。

安装好Node.js 24+之后，接下来就可以正式安装OpenClaw了。

一键安装：Linux和macOS用户的福音

如果你是Linux或macOS用户，安装OpenClaw只需要一条命令——对，就是这么简单粗暴：

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

这行命令的含义是：从openclaw.ai下载官方安装脚本，然后交给bash执行。安装脚本会自动检测你的操作系统、创建必要的目录结构、把openclaw这个命令行工具安装到系统路径里。

安装过程中如果提示需要输入密码（比如要把程序复制到/usr/local/bin这种系统目录），正常输入即可。安装完成后，你可以用以下命令验证是否安装成功：

openclaw --version

看到版本号输出，就说明安装成功了。

Windows用户：PowerShell安装方式

Windows用户没有bash环境，但OpenClaw同样支持Windows，安装方式稍微不同。打开PowerShell（注意不是CMD，是PowerShell），执行：

irm https://openclaw.ai/install.ps1 | iex

irm是PowerShell 7+内置的命令，作用相当于curl。iex则是执行远程脚本。整条命令的效果和Linux/macOS的一键安装完全一样，安装程序会自动完成所有配置。

安装后的第一步：初始化配置

OpenClaw装好后，你还需要完成一个初始化流程。这个流程会引导你完成认证、配置第一个AI模型、设置访问权限等关键步骤。在终端输入：

openclaw onboard --install-daemon

这里有两个关键动作：

  1. onboard：启动交互式初始化向导，过程中会要求你输入AI模型的API Key（如OpenAI、Anthropic等），这些凭证会被安全存储，用于后续调用AI能力。

  2. --install-daemon：把OpenClaw网关注册为系统守护进程。这样即使你关闭终端窗口，OpenClaw也会在后台持续运行，随时响应消息。

初始化向导会一步步引导你完成配置，整个过程大约需要2-3分钟，大部分时间是在输入API Key。如果你已经知道要用哪些模型的Key，直接准备好会更快。

验证网关是否正常运行

初始化完成后，你需要确认OpenClaw网关已经在后台跑起来了。输入以下命令：

openclaw gateway status

这条命令会返回网关的当前状态，包括是否在线、监听的端口、已连接的频道数量等信息。如果一切正常，你会看到类似"Gateway is running"的输出。

如果状态显示"stopped"或报错，请检查一下初始化过程中是否有步骤遗漏，或者查看日志文件排查问题。日志文件通常在~/.openclaw/logs/目录下。

打开控制台：可视化界面

对于不喜欢敲命令的同学，OpenClaw还提供了一个Web控制台，可以直接在浏览器里管理配置、查看对话记录、监控网关状态。启动控制台命令：

openclaw dashboard

执行后，OpenClaw会在本地启动一个Web服务器（默认端口通常是18789），并自动打开浏览器标签页。你会看到一个图形化界面，左边是导航栏，右边是内容区域，操作逻辑和常见的Web后台管理界面差不多。

这个控制台对于调试配置、查看实时日志、管理已连接的频道都特别有用。建议第一次部署时打开看看，对整体架构会有更直观的感受。

连接即时通讯频道：让AI通过聊天软件和你对话

部署完网关只是第一步，真正让OpenClaw变得好用的是——它能连接各种即时通讯平台，让你直接在Telegram、WhatsApp、Discord里和AI对话。这才是真正的"私人助手"体验。

Telegram

Telegram是目前对接OpenClaw最流畅的平台之一。你需要在Telegram里创建一个机器人（Bot），获取Bot Token，然后在OpenClaw里配置这个Token。

配置方法很简单，通过CLI命令即可完成：

openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot-token "你的bot-token"

配置完成后，重启网关（openclaw gateway restart），然后在Telegram里给这个Bot发消息，你的AI助手就会回应了。

WhatsApp

WhatsApp的配置稍微复杂一些，因为它不支持Bot Token验证，需要通过WhatsApp Web的方式进行关联。原理是让OpenClaw扫描一个QR码，把你的WhatsApp账号作为"转发器"——收到消息后转发给OpenClaw处理，再把回复发回来。

这个方案的优点是不需要WhatsApp官方API（那种要钱），缺点是你的手机需要保持在线才能让WhatsApp频道正常工作。

Discord

Discord适合喜欢社区氛围的用户。你需要在Discord开发者平台创建一个Application，然后把它配置为机器人，再把Bot Token填入OpenClaw。Discord支持频道和线程，可以把AI助手做成多人共用的服务。

配置频道的核心参数

无论你选择哪个平台，有几个通用配置是绕不开的：

dmPolicy：控制谁可以直接给AI发消息。选项通常包括：

  • open：任何人都可以私聊
  • approved：只有白名单用户可以
  • closed：完全关闭私聊

这个参数直接关系到安全性，建议根据使用场景谨慎设置。如果是个人使用，approved模式最合适——只有你自己能调用AI，其他人发了也没反应。

配置文件在哪里

OpenClaw的所有配置最终都保存在~/.openclaw/openclaw.json这个文件里（~代表你的用户目录）。这是一个JSON5格式的文件，支持注释，这在配置文件里非常难得——你可以给自己的每项配置写中文备注。

日常修改配置有三种方式：

  1. 交互式向导：运行openclaw onboard，适合第一次配置
  2. CLI命令：如openclaw config set <key> <value>，适合自动化脚本
  3. 直接编辑文件：用任意文本编辑器打开~/.openclaw/openclaw.json，适合批量修改

常见问题速查

安装脚本报错怎么办？

检查是否安装了curl/wget，以及网络是否正常。有些企业网络环境会屏蔽外部脚本下载，可以尝试先手动下载脚本内容查看。

Node版本不满足要求？

用nvm安装Node 24：nvm install 24 && nvm use 24。Windows用户建议直接下载LTS版本的Node 24安装包。

API Key怎么填才安全？

不要直接把Key写进公开的脚本或文档里。推荐通过环境变量传递，或者在初始化向导中输入——这些方式都会把Key加密存储，不会明文出现在配置文件里。

网关启动后没有任何反应？

先查日志：openclaw gateway logs，大多数启动失败的原因（端口被占用、配置文件格式错误、Key无效）都会记录在日志里。

进阶方向

跑通基础功能后，你可以继续探索：

  • 技能（Skills）：OpenClaw支持插件化的技能系统，可以给AI添加天气查询、股票行情、自动化交易等各种能力
  • 工作区（Workspace）：自定义提示词、知识库、长期记忆，让AI更懂你的需求
  • 多模型组合：配置多个AI模型作为备选，主模型不可用时自动切换
  • 自动化工作流：配合cron任务，实现定时提醒、自动报告生成等高级功能

总结

总结一下今天的内容：OpenClaw的安装其实就是一条命令，后续的初始化向导会帮你搞定大部分配置。网关跑起来之后，你可以用openclaw gateway status验证状态，用openclaw dashboard打开可视化控制台。最后，连接Telegram/WhatsApp/Discord这些频道，让AI真正进入你的日常通讯工具。

整个流程熟练了之后，5分钟真的够用。难的从来不是安装这一步，而是搞清楚这些配置之间的关系——看完这篇文章，你应该已经比90%的人更懂OpenClaw了。动手试试吧。