OpenClaw 飞书部署完整指南：5分钟搭建你的个人AI助理
先叠个甲，深夜更文没整理样式，如果需要更加详细的一些的步骤，可以直接查看原文，但是原文有坑，走不通的时候记得回来看看我的这部分🐶
目录
-
一、OpenClaw 是什么
-
二、部署方式选择
-
三、云端部署教程（火山引擎 ArkClaw）
-
四、本地部署教程（macOS）
-
五、验证部署成功
-
六、常用指令速查表
-
七、常见问题
-
八、推荐使用场景
一、OpenClaw 是什么
OpenClaw是一款开源的个人AI Agent系统，可以运行在你的个人电脑或服务器上。通过飞书官方插件，你可以直接在飞书中用自然语言指令让它完成各类办公任务：
读取群聊和文档信息
自动撰写、修改文档
代发消息、约日程
创建和管理多维表格
跨端远程执行复杂任务
💡 重要提示：现阶段切勿使用公司/企业飞书账号接入！请务必优先使用个人账号进行体验和测试，避免数据安全风险。
二、部署方式选择
部署方式: 云端部署（推荐新手）
优点: 操作简单，24小时在线，性能稳定，无需本地电脑常开 缺点: 产生少量服务器费用，数据存储在云端 适用人群: 普通用户、团队协作场景
本地部署
开发者、对数据安全要求极高的用户
**三、云端部署教程（火山引擎 ArkClaw） **
Step 1：开通 ArkClaw 服务
访问飞书专属活动页：szacq.cn/YbpHK/
选择套餐订阅：
Lite套餐：首月￥9.9，适合个人或轻量化开发场景
Pro套餐：首月￥49.9，更高调用次数，适合企业或重度使用用户
完成注册实名认证后购买
进入体验中心 szacq.cn/YwSno/ ，点击"立即创建"，等待1-2分钟完成实例创建
Step 2：创建飞书企业自建应用
这一步是让OpenClaw获得飞书权限的关键：
登陆飞书开放平台，创建企业自建应用
填写基础信息（名称、描述可自定义，图标可暂时不传）
在能力列表中找到"机器人"能力，点击"添加"
批量导入权限（最关键步骤）：
左侧菜单进入"权限管理 > 批量导入/导出权限"
清空输入框，复制粘贴以下JSON内容，点击"确定新增权限"
获取应用凭证：
左侧菜单进入"凭证与基础信息"
复制保存 App ID（格式如cli_xxxxxxxxxxxx）和 App Secret（长字符串，注意保密！）
Step 3：配置 ArkClaw 消息渠道
进入ArkClaw控制台，点击"消息渠道"
将上一步获取的App ID和App Secret粘贴进去，点击"确定"
等待飞书渠道配置成功
Step 4：订阅事件与发布应用
回到飞书开放平台，进入"事件与回调"配置
事件配置 > 订阅方式 > 选择"使用长链接接受事件"，点击保存
添加"接收消息"事件
回调配置 > 搜索并添加"卡片回传交互"，确认添加
点击"创建版本"，填写版本号（如1.0.0）和版本描述，点击确定
点击版本右侧的"发布"按钮，等待管理员审批（个人账号审批通常即时完成）
Step 5：完成配对与授权
在飞书消息中找到"开发者小助手"推送的应用，点击"打开应用"
给机器人发送任意消息，会收到配对信息
在ArkClaw系统后台执行配对命令（替换为实际收到的配对码）：openclaw pairing approve feishu 权限码 --notify
发送/feishu auth指令，完成批量权限授权
*Step 6：推荐配置（可选但建议） *
开启流式输出和信息展示，获得更好的使用体验：
开启流式输出（打字机效果）
openclaw config set channels.feishu.streaming true
开启请求耗时显示
openclaw config set channels.feishu.footer.elapsed true
开启状态信息显示
openclaw config set channels.feishu.footer.status true
配置修改后需要重启网关生效。
**四、本地部署教程（macOS） **
前置环境准备
安装Node.js：访问nodejs.org，下载22.x LTS版本并安装
安装Homebrew：下载官方安装包运行
安装Git：执行命令brew install git
Step 1：安装 OpenClaw
打开终端执行：
npm i -g openclaw
如果出现权限错误，使用：
sudo npm i -g openclaw
验证安装成功：
openclaw --version
*Step 2：创建飞书应用（同云端部署Step 2） *
与云端部署的飞书应用创建步骤完全一致，完成后获取App ID和App Secret。
Step 3：安装飞书官方插件
依次执行以下命令：
设置npm源
npm config set registry registry.npmjs.org
下载安装脚本
curl -o /tmp/feishu-openclaw-plugin-onboard-cli.tgz sf3-cn.feishucdn.com/obj/open-pl…
安装插件
npm install /tmp/feishu-openclaw-plugin-onboard-cli.tgz -g
清理安装包
rm /tmp/feishu-openclaw-plugin-onboard-cli.tgz
运行安装向导，按提示输入App ID和App Secret
feishu-plugin-onboard install
遇到问题可运行诊断工具：
feishu-plugin-onboard doctor --fix
Step 4：配置大模型
运行配置向导选择并接入AI模型：
openclaw config
按照提示选择：Local > Model > 选择你的模型厂商 > 输入API Key
推荐模型：
火山引擎 Ark：szacq.cn/YbpHK/ 首月9.9元起
MinMax M2：minimaxi.com
Step 5：启动网关服务
安装网关服务
openclaw gateway install
启动网关
openclaw gateway start
检查运行状态
openclaw gateway status
⚠️ 注意：运行网关的终端窗口不可关闭，后续操作需新建终端窗口。
Step 6：完成配对与授权
在飞书中找到创建的机器人，发送任意消息获取配对码
在终端执行配对命令（替换为实际收到的权限码）：openclaw pairing approve feishu 权限码 --notify
发送/feishu auth完成权限授权
五、验证部署成功
给飞书机器人发送以下指令测试功能：
你好 - 测试基础回复能力
/feishu start - 确认安装状态
/feishu doctor - 检查配置是否正常
帮我创建一个文档 - 测试文档操作能力
如果都能正常响应，说明部署成功！
六、常用指令
openclaw gateway start
启动网关服务
openclaw gateway stop
停止网关服务
openclaw gateway restart
重启网关（修改配置后必须执行）
openclaw dashboard
打开可视化管理后台
openclaw doctor
自动诊断系统问题
openclaw health
查看实时运行状态
/feishu auth
批量完成飞书权限授权
/feishu doctor
检查飞书插件运行状态
七、常见问题
Q：流式输出怎么开启/关闭？
开启
openclaw config set channels.feishu.streaming true
关闭
openclaw config set channels.feishu.streaming false
重启生效
openclaw gateway restart
Q：如何设置机器人回复规则？
只有@机器人时才回复（推荐群聊使用）
openclaw config set channels.feishu.requireMention true --json
所有消息都回复（私聊使用，群聊慎用）
openclaw config set channels.feishu.requireMention false --json
Q：ArkClaw使用成本高吗？
火山引擎Coding Plan Lite套餐首月仅9.9元，限频不限量，基本可以实现tokens自由，日常使用成本极低。
八、推荐使用场景
个人效率提升
📅 智能早报：自动汇总天气、日程、新闻和未读邮件
📧 邮件处理：自动提取邮件中的会议和任务信息，生成日程
📁 文件管理：自动分类归档本地和云文档，支持知识问答
📱 远程办公：手机飞书发指令，电脑/服务器自动执行任务
团队协作
基于OpenClaw的多Agent架构，可以搭建专业化分工的AI团队：
AI大总管：总协调、任务分发、进度跟踪
AI资讯助理：行业资讯收集、定时推送、趋势分析
AI内容助理：文案创作、文档生成、会议纪要
AI代码助理：技术支持、代码审查、方案设计
AI任务助理：任务跟踪、提醒催办、状态同步
参考资源
官方文档：openclaw.ai
飞书社区教程：原文链接
部署过程遇到问题，建议先运行openclaw doctor诊断，大部分问题都能自动修复。
