前言：本教程将手把手教你如何安装和配置 OpenClaw，并将其接入飞书。我们将利用 OpenCode 这个强大的 AI 助手来辅助安装，确保过程丝滑流畅。

---

0. OpenClaw：你的全能AI管家

什么是 OpenClaw？

OpenClaw 是一个开源的 AI 智能体（Agent）平台。如果不理解“智能体”这个词，你可以把它想象成一个“全能数字管家”。

• 它不仅能听懂你说的话（通过接入大模型）；

• 还能帮你干活（通过调用各种工具和 API）；

• 甚至能主动思考，帮你规划任务。

它能用来做什么？（使用场景）

1. 自动化运维：比如你有一台服务器，OpenClaw 可以帮你盯着它，一旦 CPU 飙升或者磁盘满了，立刻发消息通知你，甚至自动尝试清理垃圾文件。

2. 信息收集与整理：每天早上自动去各个新闻网站抓取你感兴趣的行业动态，整理成一份简报发到你的飞书/钉钉上。

3. 智能客服/助手：接入飞书或微信，变成一个 24 小时在线的智能助手，帮团队回答常见问题，查询内部数据。

4. 数据分析：给它一份 Excel 表格，让它帮你分析数据趋势，生成图表。

简单来说，OpenClaw 就是连接“大模型大脑”和“现实世界工具”的桥梁。

---

1. 前置知识：关键词解释

在开始之前，我们需要先了解几个核心概念，这将帮助你更好地理解接下来的操作。

1.1 终端 (Terminal)

终端是你直接与计算机对话的窗口。你可以把它想象成计算机的“后台控制室”。在这里，我们不使用鼠标点点点，而是通过输入一行行命令来指挥电脑干活。

• macOS / Linux: 叫 Terminal (终端) 或 iTerm2。

• Windows: 叫 CMD (命令提示符) 或 PowerShell。

1.2 Node.js

Node.js 是一个让 JavaScript 代码能运行在服务器端的环境。

• 比喻: 如果说 OpenClaw 是跑在路上的“汽车”，那么 Node.js 就是驱动它跑起来的“发动机”。没有发动机，车子是动不了的。

• 安装方法: 访问 Node.js 官网，下载 LTS (长期支持版) 并安装即可。

1.3 npm (Node Package Manager)

npm 是随 Node.js 一起安装的包管理工具。

• 比喻: 它是代码世界的**“应用商店” (App Store)**。我们可以通过它一键下载、安装和管理各种工具（比如 OpenClaw 和 OpenCode）。

• 安装方法: 安装完 Node.js 后，npm 就自动安装好了，无需单独安装。

---

2. 安装 OpenCode (你的 AI 助手)

磨刀不误砍柴工。OpenCode 是一个开源的 AI 代理，它不仅能帮你写代码，还能帮你解决安装过程中的各种疑难杂症。它内置了免费的大模型，是你折腾 AI 的得力助手。

记住一句话：遇事不决找 OpenCode。

• 官网地址：OpenCode | 开源 AI 编程代理

2.1 安装命令

亲测最稳定的是使用 npm 安装方式。打开终端，输入以下命令：

npm i -g opencode-ai

2.2 常见问题解决

安装过程通常非常丝滑。但如果你的网络环境导致下载卡顿，可能是因为 npm 源在海外。此时需要切换到国内镜像源：

npm config set registry https://registry.npmmirror.com/

提示：如果提示 Node.js 版本过低（需要 22+），直接在终端输入 opencode 唤起它，告诉它：“帮我升级 Node.js 到最新版”，它会自动帮你搞定。

---

3. 安装 OpenClaw

有了 OpenCode 的加持，安装 OpenClaw 就更简单了。我们继续使用 npm 进行安装。

3.1 安装命令

在终端执行：

npm install -g openclaw@latest

3.2 初始化与启动

安装完成后，运行以下命令进行初始化：

openclaw onboard --install-daemon

关键步骤：初始化过程中会让你选择大模型，根据提示选择即可，channel选择飞书，其他配置可以暂时skip。

---

4. 配置飞书 (Feishu) 集成

飞书是一个企业级的沟通工具，我们将使用飞书作为 OpenClaw 的交互界面。

整个飞书的安装交给opencode就好,一步步根据提示来即可。

飞书的配置参考如下网址，非常详细

• 官方详细文档：Feishu - OpenClaw

⚠️ 重要提示

无论是本地电脑还是云主机，在飞书开放平台的“事件订阅”配置中，请务必选择 长连接 模式。这能避免复杂的内网穿透配置，最简单省事。

---

5. 配置 API Key (以 MiniMax 为例)

为了让 OpenClaw 拥有“大脑”，我们需要配置大模型的 API Key。这里以 MiniMax 为例。

5.1 获取 API Key

1. 登录官网：访问 MiniMax 并登录。

2. 充值/订阅：

   • 余额充值：适合偶尔尝鲜。

   • 订阅 CodePlan：适合长期高频使用。

3. 创建密钥：进入“账户管理” -> “接口密钥”，点击创建新的 API Key。

注意：复制生成的 API Key 并妥善保存。出于安全考虑，平台只会显示一次，关掉窗口就看不到了（除非重新生成）。

5.2 替换 API Key

我们将使用 OpenCode 来帮我们快速替换 Key。

1. 进入 OpenCode：在终端输入 opencode 并回车。

2. 下达指令：在交互界面中输入以下指令（将 xxxxx 替换为你的真实 Key）：

   帮我替换 minimax 的 apikey 为: xxxxx

3. 等待完成：OpenCode 会自动找到配置文件并完成修改。

---

🎉 恭喜！你已经完成了 OpenClaw 的安装和配置，现在去飞书里和它聊天吧！