30分钟完成OpenClaw+飞书搭建AI私人助理,附保姆级教程

什么是 OpenClaw？

想象一下这样的场景：你正在开会，有人发来一堆文件需要整理；或者深夜你想处理今天的邮件，但实在太困了……如果有一个能真正"动手"的 AI 助手，替你完成这些操作，会怎样？

OpenClaw 就是这样的存在。它不是一个只能陪聊的聊天机器人，而是一个能真正在你的电脑上执行操作的 AI Agent。你只需要用自然语言告诉它要做什么，它就能自动操作你的电脑：

• 📧 邮件处理：帮你分类、归档、退订广告邮件
• 📁 文件管理：自动整理下载文件夹，重命名、分类
• 🐛 代码调试：在你的项目中查找 Bug、运行测试
• 📅 日程安排：自动预约会议、添加日历提醒
• 🌙 夜间任务：你睡觉时，它继续干活

核心特性

项目发展历程

OpenClaw 的诞生，始于一个简单的想法：让 AI 不只是对话，而是真正成为生产力工具。

📅 进化时间线

🏗️ 技术架构演进

OpenClaw 采用了创新的 Gateway + Agent 架构：

• Gateway：本地服务网关，负责与 LLM 通信、执行系统操作
• Channels：多渠道适配器，统一接入各类 IM 工具
• Skills：功能插件系统，用户可自建或安装社区技能
• Hooks：事件钩子机制，实现自动化工作流编排

这种设计让 OpenClaw 既轻量又强大，一台普通笔记本即可运行，同时又具备企业级扩展能力。

准备工作

系统要求

• 操作系统：macOS（推荐）、Linux
• Node.js：v22+（必须是 arm64 架构）
• 内存：建议 8GB 以上
• 网络：需要访问 LLM API（智谱、OpenAI 等）

Step 1：安装 Node.js 环境

OpenClaw 依赖 Node.js 运行，且必须是 arm64 架构的 v24 版本。这一点至关重要，x86 版本会导致核心依赖 node-llama-cpp 安装失败。

⚠️ M1/M2/M3 Mac 用户注意：这是最容易踩的坑！请务必确认架构为 arm64。

1.1 安装 nvm（Node 版本管理器）

nvm 可以让你在一台电脑上管理多个 Node 版本，切换起来非常方便。

# 使用 Homebrew 安装 nvmbrew install nvm# 验证安装成功nvm -v

1.2 安装 Node.js v22（arm64）

# 查看所有可安装的 Node 版本nvm ls-remote# 安装 Node.js v22（会自动选择 arm64 架构）nvm install 22# 设置 v22 为默认版本nvm alias default 22# 立即使用 v22nvm use 22# 验证版本node -v

1.3 验证架构（重要！）

# 检查当前 Node 架构，必须输出 arm64node -p "process.arch"

如果输出 arm64，恭喜你，可以继续下一步！

如果输出 x64 或其他，需要先卸载现有 Node，然后重新安装 arm64 版本：

# 卸载当前版本nvm uninstall 22# 清理缓存后重新安装nvm cache cleannvm install 22

Step 2：安装 OpenClaw

一条命令即可完成全局安装：

# 安装最新版本npm install -g openclaw@latest# 验证安装成功openclaw --version

看到版本号输出，说明安装成功！✅

Step 3：初始化配置

OpenClaw 提供了友好的交互式配置向导，一条命令启动：

openclaw onboard --install-daemon

3.1 安全确认

向导首先会展示安全警告，告知你 OpenClaw 需要文件访问和命令执行权限。这是正常的，因为 AI 助手需要这些能力来替你完成工作。

选择 Yes 继续。

3.2 选择配置模式

推荐选择 QuickStart，这是最省心的配置方式。

3.3 配置 LLM API

OpenClaw 需要连接大模型才能工作。支持多家服务商：

我使用的是智谱 API，注册即可免费获取额度：

🚀 立即拼团薅羊毛：智谱 GLM Coding 订阅链接直达，20 + 编程工具无缝支持，越拼越划算，建议大家直接选择MAX模型，避免高峰期间被限流→👉www.bigmodel.cn/glm-coding?…

3.4 配置渠道、Skills 和 Hooks

以下选项建议先跳过，后续按需配置：

• Channels：聊天渠道（飞书、钉钉等）
• Skills：功能技能插件
• Hooks：自动化工作流钩子

操作技巧：按空格键选中/取消，回车键确认。

3.5 安装 Gateway 服务

向导会自动将 OpenClaw 注册为 macOS 后台服务（LaunchAgent）：

完成后会显示控制面板访问地址：

📝 复制并保存这个地址，包含认证 Token，后续访问需要。

3.6 验证安装

# 检查 Gateway 运行状态openclaw gateway status

3.7 访问 Web 控制台

直接打开安装时提供的链接：http://127.0.0.1:18789/?token=xxx

如果链接丢失，可通过以下方式获取：

# 方法一：获取完整访问链接openclaw dashboard --no-open# 方法二：仅获取 Tokenopenclaw config get gateway.auth.token# 方法三：重新生成 Tokenopenclaw doctor --generate-gateway-token

3.8 测试对话

打开控制台后，直接在输入框发送消息测试：

如果 AI 能正常回复，说明基础配置成功！🎉

Step 4：对接飞书，打造企业级 AI 助理

飞书是目前最顺滑的 OpenClaw 接入方式。虽然配置步骤稍多，但一次配置后，你就能在飞书中拥有一个能真正「干活」的 AI 助手！

💡 为什么推荐飞书？

• 企业级安全保障
• 支持富文本、文件、图片等多种消息格式
• 可在公司内部分享给团队使用
• 移动端体验极佳

4.1 创建飞书应用

1. 打开 👉飞书开放平台，登录账号
2. 点击「创建企业自建应用」

4.2 启用机器人能力

在应用创建页面，点击「机器人」右侧的「添加」按钮：

添加后左侧会出现「机器人」菜单。

4.3 配置权限

进入机器人菜单，申请必要的权限。建议的基础权限：

🔗 完整权限参考：👉clawdbot-feishu 项目文档

4.4 配置事件订阅

进入「事件与回调」页面：

1. 订阅方式：选择「长连接」（Event Long Polling）
2. 添加事件：至少添加 im:message.receive_v1（接收消息）

4.5 获取凭证

进入「凭证与基础信息」页面，复制以下信息（妥善保管）：

• App ID（应用凭证）
• App Secret（应用密钥）

4.6 发布应用版本

在「版本管理与发布」页面，创建新版本并发布：

4.7 在 OpenClaw 中配置飞书

回到 OpenClaw 的 Web 控制台，发送以下指令（替换为你自己的 App ID 和 Secret）：

我要用 https://github.com/m1heng/clawdbot-feishu 这个项目将飞书集成进来，我的 appId 是"cli_xxxxxxxxxxxxx"，我的 appSecret 是"xxxxxxxxxxxxxx"，而且我使用的是国内版飞书，现在请帮我集成进来吧。

4.8 验证配置

OpenClaw 会自动重启服务使配置生效。验证命令：

openclaw gateway

看到飞书 channel 显示为「connected」即表示成功：

4.9 开始对话！

打开飞书客户端或 App，搜索你的应用名称，开始和 AI 助手聊天吧！

如果配置失败的话也没有关系，直接在本地的网站问就行。

写在最后

OpenClaw 代表了个人 AI 助理的未来趋势——从"聊天工具"进化为"执行工具"。虽然目前的配置过程对小白用户有一定门槛，但一旦完成设置，你将拥有一个 24/7 待命的超级助手。

⚠️ 安全风险提示

OpenClaw 是一个强大的工具，但请务必注意安全。近期有安全报告显示，大量 Gateway 实例因配置不当暴露于公网，存在严重安全风险。

🔒 安全最佳实践

📋 安全检查清单

• Gateway 仅监听 127.0.0.1，未暴露到公网
• 已设置强认证 Token
• 不在办公电脑上部署
• 不处理公司敏感数据
• 安装第三方 Skills 前已审核代码
• 定期更新到最新版本

重要提醒：如需远程访问，请使用安全隧道（如 Cloudflare Tunnel），而非直接开放端口。

相关链接：

• OpenClaw GitHub: https://github.com/m1heng/openclaw
• 飞书集成项目: https://github.com/m1heng/clawdbot-feishu
• 智谱 AI 开放平台: https://open.bigmodel.cn/