OpenClaw 安装教程:5 分钟搭建你的私人 AI 助手

用微信/Telegram/飞书随时随地与 AI 对话，数据全在自己手上——OpenClaw 让这件事变得无比简单。

一、OpenClaw 是什么？

OpenClaw 是一个自托管的 AI 网关（Gateway），核心能力是：

把你常用的聊天软件（Telegram、WhatsApp、Discord、飞书等）与 AI 编程助手打通，让你在手机上发条消息，就能得到 AI 的即时响应。

┌─────────────────────────────────────────────────────────────┐│                    OpenClaw 架构图                           ││                                                             ││  手机/电脑                    你的服务器/电脑                  ││                                                             ││  [Telegram]  ──┐                                            ││  [WhatsApp]  ──┤             ┌──────────────┐               ││  [Discord]   ──┼──────────►  │   Gateway    │──► AI Agent  ││  [飞书/Lark] ──┤             │  (OpenClaw)  │               ││  [iMessage]  ──┘             └──────────────┘               ││                                    │                        ││                              Web 控制台 / CLI                │└─────────────────────────────────────────────────────────────┘

核心特点

二、安装前准备

环境要求

┌──────────────────────────────────────────────────┐│  必需                                            ││  ✓ Node.js 24（推荐）或 Node.js 22.14+           ││  ✓ 至少一个 AI 模型 API Key                      ││    （Anthropic / OpenAI / Google 等）            ││                                                  ││  Windows 用户额外说明                             ││  ✓ 原生 Windows 或 WSL2 均可                     ││  ✓ 推荐使用 WSL2（更稳定，功能更完整）             │└──────────────────────────────────────────────────┘

检查 Node.js 版本

node--version# 输出应为 v22.x.x 或 v24.x.x

如果尚未安装 Node.js，前往 nodejs.org 下载安装。

支持的 AI 模型提供商（部分）

三、安装 OpenClaw

macOS / Linux（一键安装）

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

Windows（PowerShell）

iwr-usebhttps://openclaw.ai/install.ps1|iex

或通过 npm 安装

npm install -g openclaw@latest

安装完成后验证：

openclaw --version

四、快速启动（5 分钟完成）

整个流程分为 5 步：

Step 1         Step 2         Step 3         Step 4         Step 5安装 OpenClaw ──► 运行引导 ──► 验证网关 ──► 打开控制台 ──► 发送第一条消息    ✓             ~2 分钟        ✓              ✓              🎉

Step 1：安装（已完成）

见上一节。

Step 2：运行引导向导

openclaw onboard --install-daemon

向导会引导你：

• 选择 AI 模型提供商

• 输入 API Key

• 配置 Gateway 基本参数

• 安装系统服务（开机自启）

Step 3：验证 Gateway 运行状态

openclaw gateway status

正常输出示例：

● openclaw-gateway   Status: running   Port:   18789   Uptime: 12s

Step 4：打开 Web 控制台

openclaw dashboard

浏览器会自动打开 http://127.0.0.1:18789/

Step 5：发送第一条消息

在控制台聊天框里输入任意内容，收到 AI 回复，说明安装成功！🎉

五、接入聊天渠道

OpenClaw 支持多种渠道，以下是主要渠道的配置方式：

渠道支持一览

渠道配置一：Telegram（推荐新手）

第一步：创建 Bot

1. 打开 Telegram，搜索 @BotFather

2. 发送 /newbot，按提示填写 Bot 名称

3. 复制获得的 Bot Token（格式：123456:ABC-xxx）

第二步：配置 OpenClaw

openclaw channels add# 选择 Telegram，粘贴 Bot Token

或直接编辑配置文件 ~/.openclaw/openclaw.json：

{  channels: {    telegram: {      enabled: true,      botToken: "你的BotToken",      dmPolicy: "pairing",    },  },}

第三步：启动并授权

openclaw gateway restartopenclaw pairing list telegramopenclaw pairing approve telegram <配对码>

完成！现在可以在 Telegram 里和你的 Bot 对话了。

渠道配置二：飞书（企业用户推荐）

第一步：创建飞书应用

1. 访问 https://open.feishu.cn/app2. 点击「创建企业自建应用」3. 填写应用名称和描述4. 从「凭证与基础信息」复制 App ID 和 App Secret

第二步：配置权限

在「权限管理」中开启以下核心权限：

im:message          （消息读写）im:message:send_as_bot  （Bot 发送消息）im:chat:read        （获取群信息）im:resource         （资源文件）

第三步：配置 OpenClaw

openclaw channels add# 选择 Feishu，输入 App ID 和 App Secret

第四步：配置事件订阅

在飞书开放平台 → 事件订阅：

1. 选择「使用长连接接收事件」（WebSocket 模式）

2. 添加事件：im.message.receive_v1

第五步：发布应用

在「版本管理与发布」创建版本，提交审核发布。

六、Gateway 常用命令

# 查看状态openclaw gateway status# 启动openclaw gateway start# 停止openclaw gateway stop# 重启openclaw gateway restart# 实时日志openclaw logs --follow# 打开控制台openclaw dashboard# 查看所有渠道openclaw channels list# 添加渠道openclaw channels add# 诊断问题openclaw doctor

七、配置文件说明

配置文件路径：~/.openclaw/openclaw.json

基础配置示例：

{  // AI 模型提供商配置  providers: {    anthropic: {      apiKey: "sk-ant-xxx",    },  },  // 默认使用的模型  agent: {    model: "anthropic/claude-sonnet-4-5",  },  // 渠道配置  channels: {    telegram: {      enabled: true,      botToken: "xxx",      dmPolicy: "pairing",       // pairing / allowlist / open    },    feishu: {      enabled: true,      accounts: {        main: {          appId: "cli_xxx",          appSecret: "xxx",        },      },    },  },}

八、功能全景

OpenClaw 能力地图│├── 📱 多渠道接入│   ├── Telegram / WhatsApp / Discord / 飞书│   └── iMessage / Mattermost / Matrix（插件）│├── 🤖 AI 能力│   ├── 35+ 模型提供商│   ├── 多智能体路由（隔离 Session）│   └── 流式输出 + 长文本分段│├── 🛠 工具集│   ├── 浏览器自动化│   ├── 代码执行（沙箱）│   ├── 网页搜索│   └── 文档读写（飞书云文档等）│├── 📅 自动化│   ├── Cron 定时任务│   ├── 心跳检测│   └── Skills / Plugins 扩展│└── 📱 移动端节点    ├── iOS / Android 配对    ├── Canvas 展示    └── 摄像头 / 语音支持

九、常见问题

Q：Gateway 启动失败，端口被占用？

# 检查端口占用lsof -i :18789# 或修改配置文件中的端口

Q：Telegram Bot 没有响应？

openclaw logs --follow# 检查是否有 pairing 等待审批openclaw pairing list telegram

Q：如何更新 OpenClaw？

npm install -g openclaw@latestopenclaw gateway restart

Q：支持哪些操作系统？

十、资源链接

小结

OpenClaw 三步走：

1. npm install -g openclaw@latest   # 安装2. openclaw onboard --install-daemon # 引导配置3. openclaw dashboard               # 打开控制台，开聊！

从安装到第一条 AI 回复，全程不超过 5 分钟。数据在你手上，AI 在你掌心。

本文基于 OpenClaw 官方文档整理，2026 年 3 月。官方文档：docs.openclaw.ai