OpenClaw 是一款可部署在本地、能适配各类软件的 AI 管家工具，区别于常规问答式 AI，它可后台持续运行、主动完成任务，还能按需安装各类技能。

现阶段在飞书端的适配性最佳，也是官方推荐的使用场景。

本文从工具认知 → 安装准备 → 部署接入 → 实用场景四个维度，手把手教你零踩坑使用 OpenClaw 🦞

一、先搞懂：OpenClaw 核心特性与适用人群

1️⃣ 核心特性

和常规问答 AI（如 ChatGPT、豆包等）的”图书馆式”交互不同，OpenClaw 是管家式 AI，核心特性有三点：

• 🔄 后台持续运行：无需实时操作，可自主完成设定任务并主动提醒；
• 📂 无缝适配软件：可在飞书等常用办公软件内直接交互，无需额外安装 APP；
• 🧩 支持技能拓展：可像安装 APP 一样为其添加各类技能，适配不同工作生活需求。

2️⃣ 适用人群

OpenClaw 目前处于技术早期迭代阶段，更适合喜欢尝鲜、愿意折腾新工具、能接受产品部分功能待完善的用户。若仅因跟风产生焦虑，可等待产品成熟后再尝试，无需急于上手。

二、安装前的 3 大核心准备（10 分钟搞定）

正式部署前需完成硬件准备、API Key 申请、AI 答疑助手搭建三步，为后续操作扫清障碍。

🖥️ 1. 硬件准备：选对设备，规避风险

OpenClaw 有本地设备和云服务器两种运行方式，无需购置高端新设备，旧设备即可满足需求，核心原则是与主力工作机物理隔离：

⚠️ 硬件使用三大核心原则：

1. 优先使用闲置旧设备或专属新设备，与主力机彻底隔离；
2. 切勿给 OpenClaw 开放绝密资料的访问权限；
3. 若仅有一台电脑，需先完整备份所有重要资料，再进行部署。

🔑 2. 密钥准备：申请 API Key

API Key 是 OpenClaw 调用 AI 大模型的”身份凭证”，类似银行卡账号。

• 计费逻辑：常规使用每月十几到几十元，高频使用最多几百元；多数平台注册即送免费额度；
• 推荐申请平台：优先选择 Minimax（M2.0/M2.5 模型，开源模型排名靠前，适配性最佳），也可选择 Kimi、智谱等。

⚠️ 关键提醒：API Key 属于隐私信息，切勿发送到群聊、朋友圈等公共平台。

🤖 3. 答疑准备：搭建 AI 报错助手

通过豆包桌面端搭建专属 AI 答疑助手：

• 截图提问：将报错界面截图发送给豆包，直接询问问题原因；
• 共享屏幕：选择”整个屏幕”，豆包可实时识别屏幕内容，手把手指导操作。

三、安装基础工具

OpenClaw 是用 Node.js 写的，需要先给电脑装一个「翻译器」。

1️⃣ 检查有没有「翻译器」

node -v

如果输出 v20.12.0 这类版本号（版本号要大于 22），说明已经有了 ✅

2️⃣ 安装 Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3️⃣ 安装 Node.js

brew install node

四、安装 OpenClaw

1️⃣ 执行安装命令

npm install -g openclaw@latest

出现权限问题就加上 sudo：

sudo npm install -g openclaw@latest

2️⃣ 验证安装成功

openclaw --version

输出类似 2026.3.2 的版本号，说明安装成功 🎉

五、运行引导向导

openclaw setup

跟着提示一步步选：

1. 选择初始化模式：建议选手动选择
2. 输入 API Key：粘贴你的 API Key
3. 选择接入平台：目标是飞书，先跳过
4. 选择前端访问方式：推荐选择 Web UI

启动 Web UI 测试

在浏览器输入：http://127.0.0.1:18789

输入「你好」，如果 AI 能正常回复，说明本地部署成功 ✅

六、创建飞书应用

1️⃣ 登录飞书开放平台

打开 飞书开放平台，选择个人账号登录。

2️⃣ 创建企业自建应用

点击「创建应用」→「企业自建应用」→ 填写名称（如「AI 管家」）→ 创建。

先发布一个 0.0.1 测试版本。

3️⃣ 获取关键凭证

在「凭证与基础信息」里找到 App ID 和 App Secret，复制保存。

七、配置权限与认证

1️⃣ 开通飞书权限

在应用后台「权限管理」开通：

• ✅ 接收消息、发送消息
• ✅ 读取、写入通讯录
• ✅ 操作日历、待办
• ✅ 上传、下载文件

2️⃣ 双端握手认证

在飞书向机器人发送「你好」，将获取的配对码填入终端完成认证。

八、实用场景

⚠️ 关键提醒

API Key 与飞书凭证属于绝密信息，切勿公开泄露！