乐于分享
好东西不私藏
当前位置：夜雨聆风 > 技术教程 > 软件教程 > OpenClaw 从入门到精通:入门篇

OpenClaw 从入门到精通:入门篇

当前时间： 2026-04-25 13:54:17 更新时间： 2026-04-25 分类：软件教程 评论(0)

OpenClaw 从入门到精通:入门篇

OpenClaw 从入门到精通：入门篇

本教程面向零基础用户，全程采用问答形式展开。

01. 为什么需要私有部署的 AI Agent？

Q: 我直接在 ChatGPT 或 Claude 网页上聊不就行了吗？为什么还要自己部署 AI？

好问题。两者的核心区别在于：你的 AI 跑在谁的控制之下。

网页版 AI 私有部署 AI Agent
数据存储 服务商服务器 你自己的服务器
能否读写本地文件 ❌ 不能 ✅ 可以
能否执行 shell 命令 ❌ 不能 ✅ 可以
能否定时自动执行任务 ❌ 不能 ✅ 可以
能否接入飞书/钉钉直接聊天 ❌ 不能 ✅ 可以
团队多人共享 ❌ 各自独立账号 ✅ 共用一个 AI

简单说：网页版 AI 是一个「在线工具」，用完就走；私有部署 AI Agent 是一个「驻场的私人助理」，能操作你的系统、记住你的习惯、在你常用的软件里随时响应。

02. 什么是 OpenClaw？

Q: OpenClaw 是什么？

OpenClaw 是一个开源的私有部署 AI Agent 平台。你可以把它理解为一个「跑在你服务器上的私人 AI 助手」——有记忆、能推理、能调用工具、能接入飞书/钉钉/Telegram 等聊天软件。

它由三个核心概念组成：

Gateway（网关）

所有消息的必经之地。类似于餐厅前台——顾客下单、接单、核验、派送都经过它。Gateway 是 OpenClaw 的核心引擎。

Channel（频道）

AI 和用户聊天的入口。每个聊天平台对应一个 Channel。飞书是 Channel，钉钉、Telegram、Discord 都是 Channel。你接入了哪个平台，AI 就在哪个平台跟你聊。

Agent（代理）

真正执行任务的人。Gateway 收到消息后，交给 Agent 处理。不同的 Agent 擅长不同的事——有的专攻写代码，有的专攻数据分析，有的负责日程管理。

一句话总结： Gateway 是核心引擎，Channel 是聊天入口，Agent 是任务执行者。

03. 怎么安装？

Q: 我用的是云服务器，Linux 系统，安装复不复杂？

不复杂，两步搞定。

Q: 第一步要做什么？

安装 Node.js 22。OpenClaw 基于 Node.js 运行，需要先装运行环境：

# 国内服务器用这个镜像
curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash
source ~/.bashrc

# 国外服务器用这个
# curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

nvm install 22
node -v

最后一行 node -v 应该输出 v22.x.x，说明 Node.js 装好了。

Q: 第二步呢？

安装 OpenClaw：

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

装完之后验证：

openclaw --version

能看到版本号（如 OpenClaw 2026.4.23），说明安装成功。

⚠️ 内存提醒： 如果你的云服务器只有 2G 内存，安装新版本可能会报 OOM（内存不足）。先加 swap：

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

04. 第一次怎么启动？

Q: 装好了，现在怎么让它跑起来？

运行 openclaw onboard，这是交互式引导配置工具，会一步步问你问题 [New in v2026.4.22+]：

openclaw onboard

💡 v2026.4.22+ 改进： 新版引导会自动检测缺失的插件并提示安装，不再需要手动补装。

引导流程如下：

  1. 风险提示 — 输入 yes 确认
  2. 选择模式 — 选 QuickStart（快速开始）
  3. 选择模型 — 选 Qwen（通义千问，免费额度够用），选完后会给你一个链接，用浏览器打开并登录阿里云账号授权
  4. Channel 渠道 — 先选 Skip（跳过，后续章节专门讲飞书和钉钉接入）
  5. Skills 技能 — 选 No
  6. Hooks — 选 No
  7. 终端界面 — 选 TUI

Q: 引导完了怎么验证服务是否正常？

在 TUI 里直接问 AI：

服务跑起来了吗？帮我检查一下状态

AI 会告诉你服务状态。看到 Runtime: running 和 Connectivity probe: ok 就说明一切正常。

Q: 现在怎么跟 AI 聊天？

直接输入你的问题，按回车，AI 就会回复。比如：

你好
帮我看看服务器还有多少内存

这就是 TUI 模式（Text User Interface，文本界面）——像跟同事聊天一样跟 AI 对话。

按 Ctrl+C 可以退出 TUI。

💡 v2026.4.22+ 新功能：本地嵌入 TUI 模式

现在你可以在没有 Gateway 的情况下运行 TUI，插件审批门禁依然生效。适合快速测试或网络不稳定的环境。

05. TUI 有哪些基础命令？

Q: 既然是对话，为什么还要学命令？

虽然可以直接聊天，但有些操作用命令更高效。而且 AI 可能不知道你具体想干什么，这时候就需要用命令来明确指示。

Q: 最常用的命令有哪些？

三个最常用的：

/new — 开一个新对话

如果聊了很多轮，上下文太长了，直接在 TUI 里说：

/new

或者跟 AI 说：

开一个新对话

AI 会开启全新会话，之前聊的暂时不带入新对话。

/reset — 重置当前会话 [New in v2026.4+]

比 /new 更彻底，把当前会话的所有内容擦掉重来。直接说：

/reset

或者：

重置当前会话

大多数时候用 /new 就够了。

/status — 查看当前状态 [New in v2026.4+]

会显示当前模型、Token 用量、会话 ID、Gateway 连接状态等信息。在 TUI 里说：

/status

或者：

帮我看看状态

/help — 查看所有命令

忘记命令时随时问 AI：

有什么命令可以用？

/models — 查看和添加模型 [New in v2026.4.22+]

查看已添加的模型，或者在 TUI 里直接说：

帮我添加一个 Qwen 模型

AI 会引导你完成模型添加，无需重启 Gateway。

Q: 对话历史存在哪里？

默认存在 ~/.openclaw/workspace/ 目录下，每个会话是一个独立文件，重启后还在。如果配置了 Memory 功能（进阶篇会讲）， OpenClaw 还会在 /new 时自动把对话摘要存入长期记忆。

06. 怎么接入飞书？

Q: 前面都是终端里聊，太极客了。有没有办法让我在飞书里直接跟 AI 对话？

有。OpenClaw 支持接入多种 IM 平台，飞书是其中之一。现在用官方插件接入了扫码授权，整个流程非常方便。

Q: 第一步做什么？

安装飞书官方插件：

openclaw plugins install @openclaw/feishu

Q: 安装完之后呢？

安装完成后，终端会自动弹出一个二维码，用飞书扫码授权。

扫码后会让你选择：

  • 创建新应用 — 自动在飞书开放平台创建一个新应用
  • 关联已存在的应用 — 关联你之前在飞书开放平台创建过的应用

选哪个都行，后续配置会自动完成。

Q: 扫码之后还需要手动配置吗？

不需要。扫码授权后，OpenClaw 会自动完成以下配置：

  • 自动写入 appId 和 AppSecret
  • 自动开启机器人能力
  • 自动配置消息接收模式为 WebSocket 长连接
  • 自动开通消息权限

你不需要手动在飞书开放平台做任何操作。

Q: 配置完了怎么让飞书连接生效？

在 TUI 里直接让 AI 帮你重启网关：

帮我重启网关

或者手动敲命令：

openclaw gateway restart

Q: 重启完了怎么在飞书里找到 AI？

在飞书里搜索你的应用名称，给它发一条消息。

它不会直接回复，而是发给你一个配对码。

Q: 收到配对码之后怎么办？

在 TUI 里直接让 AI 帮你处理配对：

帮我处理飞书配对

AI 会引导你完成配对流程。或者手动敲命令查看配对请求：

openclaw pairing list feishu

然后执行：

openclaw pairing approve feishu <配对码>

Q: 配对完了呢？

在飞书里再发一条消息，机器人就会正常回复你了 🎉

Q: 私聊模式有几种？怎么选择？

默认是 pairing（配对模式），安全可控。如果想改成谁都能直接聊，在 TUI 里说：

把飞书私聊改成开放模式

AI 会帮你修改配置并重启网关。

💡 dmPolicy 三种模式 [New in v2026.4+]

模式 含义 适用场景
pairing 用户先发消息，机器人回一个码，用户确认后才建立连接 公开群聊、安全要求高的私聊
allowlist 只有白名单用户可以私聊 限制特定人员使用
open 谁都可以直接聊 团队内部、无需管控的场景

07. 总结和下一步

Q: 到这里入门篇就结束了，简单回顾一下？

  1. OpenClaw 是一个可私有部署的 AI Agent 平台，接入 IM 后可以在飞书/钉钉里直接跟 AI 对话
  2. 安装只需两步：装 Node.js 22 → 运行安装脚本
  3. openclaw onboard [New in v2026.4.22+] 完成初始配置，自动安装缺失插件
  4. TUI 里可以直接说话，也可以用命令：/new、/reset [New in v2026.4+]、/status [New in v2026.4+]、/models [New in v2026.4.22+]
  5. 飞书接入流程：装官方插件 → 扫码授权 → AI 帮你重启网关 → 配对（5步搞定）

Q: 4.22 和 4.23 版本有哪些值得关注的新功能？

功能 版本 说明
openclaw onboard 自动安装插件 v2026.4.22+ 引导时自动检测并安装缺失插件
/models add v2026.4.22+ 在 TUI 里直接添加新模型，无需重启 Gateway
本地嵌入 TUI 模式 v2026.4.22+ 无 Gateway 也能跑 TUI，插件审批门禁仍生效
图片生成 v2026.4.23+ 通过 OpenAI Codex/OpenRouter 支持图片生成
记忆嵌入上下文大小可配置 v2026.4.23+ memorySearch.local.contextSize 可调整

Q: 下一步学什么？

  • 飞书进阶配置：多账号、群组策略
  • 接入钉钉
  • Memory 记忆系统
  • Skills 技能包

微信号：ysf99918
欢迎添加微信，备注「OpenClaw」，拉你进技术交流群