前言介绍2026年你的“数字员工”入职指南你是否设想过这样一个场景在2026年的今天你的飞书不再仅仅是一个打卡和开会的工具而是一个拥有“超级大脑”的智能中枢。当你深夜灵感迸发时它能陪你头脑风暴当你被繁琐的数据报表淹没时它能一键生成分析摘要甚至当你需要管理密码、监控博客更新时它都能像一位得力的私人助理般默默搞定。这一切不再是科幻电影里的桥段而是触手可及的现实。为什么是OpenClaw在AI Agent智能体爆发的2026年OpenClaw无疑是GitHub上最耀眼的明星之一。它被誉为“AI界的npm”以其极高的可扩展性和本地化部署的隐私安全性迅速席卷全球开发者社区。不同于普通的聊天机器人OpenClaw 是一个“行动式智能体”。它不仅能陪你聊天更能通过安装各种Skills技能来接管你的工作流。它就像一只无所不能的“赛博龙虾”潜伏在你的电脑后台随时准备响应你的召唤。️告别环境混乱拥抱极致纯净对于开发者而言部署环境往往是一场噩梦。不同项目依赖不同版本的 Node.js全局安装导致的版本冲突让人抓狂。本教程将带你从源头解决问题。我们将引入nvm这一神器在 Windows 环境下构建一个隔离、纯净且高效的 Node.js 运行环境锁定 v22 版本。这不仅能确保 OpenClaw 的稳定运行更是每一位专业开发者应当掌握的“环境管理艺术”。连接强大的中文大模型我们将通过Kimi (Moonshot AI)的 API 为 OpenClaw 注入灵魂。Kimi 凭借其对长文本的卓越处理能力和中文语境下的精准理解将成为你机器人的核心大脑。配合飞书强大的生态连接能力你将拥有一个 24 小时在线、懂业务、能干活的全天候 AI 伙伴。准备好了吗接下来的内容我们将通过保姆级的图文步骤带你从零开始亲手搭建这套属于未来的个人 AI 基础设施。让我们开始吧一、Node.js 下载安装这里我建议安装 nvm 去管理你的不同版本的 Node.js1.1 下载安装nvmnvm是什么?nvm(Node Version Manager)是一个用于管理Node.js版本的命令行工具。它允许开发者在同一台机器上安装和切换多个版本的Node.js以便于在不同的项目中使用不同的Node.js版本。在工作中我们可能同时在进行2个或者多个不同的项目开发每个项目的需求不同进而不同项目必须依赖不同版本的NodeJS运行环境这种情况下对于维护多个版本的node将会是一件非常麻烦的事情。nvm就是为解决这个问题而产生的他可以方便的在同一台设备上进行多个node版本之间切换。具体安装文章【2026 最新】手把手教你彻底卸载 Node.js 用 nvm 管理多版本告别环境混乱nvm保姆级安装配置使用教程Windows版_卸载node最新版本-CSDN博客1.2 安装需要版本的Node.js具体 Node.js 版本要大于 22Node.jsv22.xv22.10.0 LTS必须是大版本 221.2.1 检查当前Node.js的版本当你安装好 nvm 后win R 输入 cmd 打开 终端输入下述指令可以查看你所有下载安装的的Node.js版本如图所示前面有星星的是你当前的Node.js版本我的当前的版本是 22nvm ls1.2.2 没有22版本的看这里下载安装如果大家没有22版本按照下述指令来下载安装22版本的Node.js。nvm install 22接着使用下述指令切换到当前版本的Node.jsnvm use 22查看当前版本nvm ls二、Git 下载安装具体安装教程看这篇文章【2026 最新】下载安装 Git 详细教程 Windows_git下载-CSDN博客三、OpenClaw 下载安装点击 Win 在搜索栏搜索 PowerShell选择用管理员方式运行为了避免PowerShell默认策略太严格导致安装报错输入下述指令它允许你在自己的账户下运行自己编写的或在本机创建的脚本同时阻止未经数字签名的、从互联网下载的脚本运行从而在便利性和安全性之间取得一个平衡。Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser之后在后面输入 Y表示同意这一次修改接着回车3.1 开始安装安装命令iwr -useb https://openclaw.ai/install.ps1 | iex安装过程中会跳出是否允许公共网络访问Node.js这里点击允许即可等待一段时间下方出现红色字体 OpenCla 2026 即安装成功。不要关闭当前紧接着向下翻开始配置OpenClaw3.2 开始配置OpenClaw 默认设计为“个人专属使用”即仅你本人操作这里提示是为了确保你是不是个人用这里直接点击键盘上的左方向键选择Yes接着回车确认。接下来下述直接回车保持默认的QuickStart模式。这一步选择 OpenClaw 大模型厂商用键盘的上下键切换如果你有创建过某个服务商的API密钥可以直接使用这里我推荐Kimi因为Kimi会免费送新用户15块钱的额度。上述终端页面先不要关闭我们先去配置你需要的AI模型厂商的密钥如果有密钥的可以跳过 3.3 创建Kimi大模型密钥 这一步。3.3 创建Kimi大模型密钥进入Kimi后台进行登录Moonshot AI 开放平台 - Kimi K2.5 大模型 API 服务账户总览可以看到你的账户余额创建API key密钥在 API key 管理页面右上角点击新建 API key复制你的密钥这里一定要妥善管理好你的密钥不要让别人知道不然最后烧的就是你的token。3.4 配置大模型回到PowerShell向下选择Kimi模型接着回车这里因为我们是在Kimi网站创建的密钥所以这里选择.cn后缀的接着回车。接着选择现在复制密钥回车将你刚才创建好的密钥粘贴到这里来然后回车接着选择模型这里我就保持默认的模型 kimi-2.5然后回车这里是要选择你要和OpenClaw对话的方式因为这里涉及一些后续配置先跳过。这一部分是在让你配置“网络搜索”工具允许你创建的 AI 代理Agent具备实时上网搜索信息的能力。如果你是初次尝试且没有上述搜索引擎的账号建议直接选择Skip for now跳过先体验本地的基础功能。后续需要联网搜索时可以随时重新运行配置向导来添加。这里我选择跳过。接下来就是选择Skills就是你的小龙虾需要掌握的技能如果你有清晰的需求这里可以看看有没有需要配置的每个技能的后面内都有各自的应用场景解释。这里左右键选择Yes就会进入选择Skills页面常见技能技能名称图标功能描述/用途1password密码管理工具用于安全存储和检索密码。blogwatcher博客监控工具可能用于跟踪特定博客的更新或内容。camsnap摄像头相关工具可能用于拍照、截图或视频监控。clawhubOpenClaw 的官方插件库或社区市场。eightctl智能床如 Eight Sleep控制相关。gemini✨与 Google Gemini 模型或相关服务集成的工具。gifgrepGIF 图片搜索或处理工具。githubGitHub 集成工具用于管理仓库、提交代码、查看 Issues 等。gog可能与 GOG 游戏平台相关用于管理游戏库或购买记录。goplaces地理位置或地图相关工具可能用于地点查询或导航。himalaya电子邮件客户端工具用于收发和管理邮件。mcporter与 Minecraft 服务器管理或数据传输有关。nano-banana-pro是一个特定的轻量级工具或服务。nano-pdfPDF 文件处理工具用于阅读、编辑或转换 PDF。obsidianObsidian 笔记软件集成工具用于与你的本地笔记库交互。openai-whisperOpenAI 的 Whisper 语音识别模型集成用于语音转文字。openhuePhilips Hue 智能灯泡控制工具用于调节灯光颜色、亮度等。oracle与 Oracle 数据库或云服务相关。ordercli订单管理工具可能用于处理电商订单或物流信息。sag与音频处理或特定服务相关。songsee音乐或音频识别工具可能用于识别歌曲或处理音频文件。sonoscliSonos 智能音响控制工具用于播放音乐、调节音量等。如果没有需要配置的Skills直接上键选择Skip for now 接着空格 回车即可。接着会让你选择配置一系列密钥如果你都没有配置的话直接选择No回车即可我这里全选的No。对应的 API Key服务/功能说明建议操作GOOGLE_PLACES_API_KEY谷歌地点服务用于查询地点、地图信息等。若无谷歌云账号选No。GEMINI_API_KEYGoogle Gemini 模型服务用于调用 Gemini 生成内容。若无 Google AI Studio 账号选No。NOTION_API_KEYNotion 笔记服务用于读写 Notion 数据库/页面。若无 Notion 集成令牌选No。OPENAI_API_KEYOpenAI 图像生成服务如 DALL·E用于生成图片。若无 OpenAI 账号选No。OPENAI_API_KEYOpenAI 语音识别服务Whisper用于语音转文字。若无 OpenAI 账号选No。ELEVENLABS_API_KEYElevenLabs 语音合成服务用于生成自然语音。若无 ElevenLabs 账号选No。“自动化钩子Hooks”是一种自动化规则。它允许你设定当 AI 代理执行某些特定指令如/new、/reset时自动触发一些预设的动作。这里我们也可以直接选择Skip for now接着空格 回车跳过即可。接着程序会自启动网关我们可以看到一个命令窗口被自动打开了这个窗口先不要关它等待一会回到之前的PowerShell窗口这里会提示你再哪里启动打开小龙虾这里我推荐使用Web UI 网页图形页面更加直观好操作。上述回车后会自动打开网页在这里我们就可以和我们的小龙虾对话了。四、将OpenClaw和飞书连接4.1 创建飞书机器人官网飞书开放平台点击右上角的登录按钮进行登录登录成功后点击后上角的开发者后台点击创建企业自建应用填写你的应用名称和应用描述添加机器人功能点击左侧权限管理里面页面里面的开通权限右侧输入框内输入下述im:全选当前权限点击确认开通权限接着点击上面黄色方框内的创建版本填写相关内容后向下翻点击保存即可。4.2 连接飞书机器人回到 PowerShell 输入openclaw config回车再次进行配置选择 Local 本地运行回车选择 Channels 配置通讯方式回车选择 Configure/link添加新的消息渠道回车一路向下找到飞书选择回车这里需要安装飞书插件直接回车即可等待一会安装成功后我们需要 飞书应用的App Secret点击 Enter App Secret (Stores the credential directly in OpenClaw config)接着回车我们来到飞书开发者后台点击左侧的凭证与基础信息复制右侧的App Secret凭证与基础信息 - OpenClaw【Windows】 - 开发者后台然后粘贴密钥回车复制App ID粘贴然后回车选择| WebSocket (default) 通讯方式回车我们是在国内飞书创建的直接回车这里选择是否允许在群聊里使用机器人这里选择第二个Open - respond in all groups (requires mention)意思为所有群里都可以使用机器人但是必须机器人。接着向下翻选择Finished完成配置然后这一步询问要不要现在配置私聊访问策略也就是谁可以在飞书私聊里用OpenClaw机器人我们选择Yes然后回车如果只是自己测试使用策略可以先选择Open如果是正式环境建议选择Pairing我这里选择Open然后回车Pairing (recommended) — 配对模式推荐含义这是最安全的模式。只有在你主动添加该用户为好友即完成配对后AI 才会响应他们的私信。适用场景个人使用或小范围团队内部使用。你只想和信任的人交流。Allowlist (specific users only) — 白名单模式仅限特定用户含义只有在你预先设置的“白名单”里的用户才能发送私信给 AI。其他用户的消息会被忽略。适用场景你需要严格控制谁能与 AI 交流比如只允许特定的管理员或团队成员操作。Open (public inbound DMs) — 开放模式公开接收含义任何人都可以通过飞书搜索到你的机器人并发送私信AI 都会回复。适用场景公开的服务号、客服机器人或公开问答机器人。但要注意这可能会收到垃圾信息或骚扰。Disabled (ignore DMs) — 禁用模式忽略私信含义AI 完全不会处理任何私信消息即使有人发消息过来也不会回复。适用场景你只打算通过群组Groups或其他渠道使用 AI不打算在私信里和它交互。选择最后的continue回车这样你就配置好了你的OpenClaw接着在 PowerShell 输入openclaw gateway进行回车如果出现下述报错无需理会是因为你的OpenClaw 网关已经在运行了进程 ID 为 29076因此无法再次启动。PS C:\WINDOWS\system32 openclaw gateway OpenClaw 2026.3.13 (61d171a)Eid al-Fitr: Celebration mode: queues cleared, tasks completed, and good vibes committed to main with clean history.20:17:29 [plugins] plugins.allow is empty; discovered non-bundled plugins may auto-load: feishu (F:\Chengxusheji\Nvm\nvm\node_cache\node_modules\openclaw\extensions\feishu\index.ts). Set plugins.allow to explicit trusted ids.20:17:35 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes20:17:35 [plugins] feishu_chat: Registered feishu_chat tool20:17:35 [plugins] feishu_wiki: Registered feishu_wiki tool20:17:35 [plugins] feishu_drive: Registered feishu_drive tool20:17:35 [plugins] feishu_bitable: Registered bitable tools20:17:35 Gateway failed to start: gateway already running (pid 29076); lock timeout after 5000msIf the gateway is supervised, stop it with: openclaw gateway stop20:17:35 Gateway service appears registered. Stop it first.20:17:35 Tip: openclaw gateway stop20:17:35 Or: schtasks /End /TN OpenClaw GatewayPS C:\WINDOWS\system32然后再飞书自建应用界面点击左侧的事件与回调修改订阅方式选择长连接保存保存成功后点击右下角的添加事件搜索接受消息勾选之后选择添加回到权限管理点击开通权限搜索通讯录将获取通讯录基本信息勾选上点击确认要想要生效需要再次点击上方的创建版本输入信息后下滑下方后点击保存发布成功后即可配置成功。五、测试对话打开手机版飞书APP打开应用这样就可以和你的小龙虾OpenClaw对话啦六、常见问题6.1 问题一飞书应用未显示如果App开发者小助手里面内没有打开应用显示说明没有配置好机器人建议检查4.1 创建飞书机器人这一步。6.2 问题二OpenClaw回复无响应如果在询问你的小龙虾没有回复建议检查你是否打开小龙虾网关又没有下述页面如果没有建议在PowerShell管理员运行模式下输入下述命令关闭重启打开openclaw gateway stop openclaw gateway restart七、关闭暂停OpenClaw7.1 只是关闭暂停当你不想去使用你的OpenClaw想要关闭暂停它可以在终端输入下述指令然后回车打开终端Terminal 或 CMD/PowerShell。输入以下命令并回车openclaw gateway stop效果这会停止后台的 LaunchAgent 或系统服务Web 界面和聊天功能将暂时无法使用。补充如果你想重启它可以使用openclaw gateway restart。场景分类适用情况操作目的1. 临时释放电脑资源需要运行大型游戏、渲染视频或感觉电脑变卡时释放被占用的内存和 CPU让电脑运行更流畅忙完后可随时启动2. 暂时不需要 AI 响应周末/假期休息或开会/专注工作时不想被打扰切断 AI 的“耳朵”和“嘴巴”使其进入“冬眠”状态不再响应指令但保留配置3. 修改配置前的准备需要更换 API Key、修改模型参数或调整技能包时防止修改文件时后台程序仍在读取旧配置导致冲突或修改不生效4. 排查故障重启大法AI 反应迟钝、不回复消息、报错或似乎“卡死”时相当于给 AI 做一次“重启”通常能解决大部分连接或运行的小毛病7.2 如何彻底关闭“开机自启”如果你只是不想让它每次开机都自动运行而不是想卸载它可以执行以下操作命令bashopenclaw gateway install --no-auto-start八、彻底卸载OpenClaw1. 打开终端TerminalWindows 用户按Win R键输入cmd按回车或者在开始菜单搜索“命令提示符”或“PowerShell”。Mac 用户按Command 空格输入Terminal或“终端”按回车。2. 执行核心卸载命令在终端窗口中复制并粘贴以下命令然后按回车键openclaw uninstall --all --yes命令解释uninstall告诉程序执行卸载。--all彻底删除模式包括网关服务、本地数据库、配置文件等所有数据。--yes全程自动确认不需要你手动输入Y确认。3. 删除命令行工具CLI执行完上一步后OpenClaw 的主体已经删除了但可能还剩下一个“外壳”命令行工具。为了彻底清除请继续执行以下命令npm uninstall -g openclaw(如果你当初是用 pnpm 或 bun 安装的请将npm替换为pnpm remove -g或bun remove -g)。
【2026最新】手把手教你部署安装OpenClaw：Node.js 22+Git+Kimi模型+飞书机器人全链路配置指南 超详细附避坑详解（Windows 版）
发布时间：2026/7/30 1:38:41
前言介绍2026年你的“数字员工”入职指南你是否设想过这样一个场景在2026年的今天你的飞书不再仅仅是一个打卡和开会的工具而是一个拥有“超级大脑”的智能中枢。当你深夜灵感迸发时它能陪你头脑风暴当你被繁琐的数据报表淹没时它能一键生成分析摘要甚至当你需要管理密码、监控博客更新时它都能像一位得力的私人助理般默默搞定。这一切不再是科幻电影里的桥段而是触手可及的现实。为什么是OpenClaw在AI Agent智能体爆发的2026年OpenClaw无疑是GitHub上最耀眼的明星之一。它被誉为“AI界的npm”以其极高的可扩展性和本地化部署的隐私安全性迅速席卷全球开发者社区。不同于普通的聊天机器人OpenClaw 是一个“行动式智能体”。它不仅能陪你聊天更能通过安装各种Skills技能来接管你的工作流。它就像一只无所不能的“赛博龙虾”潜伏在你的电脑后台随时准备响应你的召唤。️告别环境混乱拥抱极致纯净对于开发者而言部署环境往往是一场噩梦。不同项目依赖不同版本的 Node.js全局安装导致的版本冲突让人抓狂。本教程将带你从源头解决问题。我们将引入nvm这一神器在 Windows 环境下构建一个隔离、纯净且高效的 Node.js 运行环境锁定 v22 版本。这不仅能确保 OpenClaw 的稳定运行更是每一位专业开发者应当掌握的“环境管理艺术”。连接强大的中文大模型我们将通过Kimi (Moonshot AI)的 API 为 OpenClaw 注入灵魂。Kimi 凭借其对长文本的卓越处理能力和中文语境下的精准理解将成为你机器人的核心大脑。配合飞书强大的生态连接能力你将拥有一个 24 小时在线、懂业务、能干活的全天候 AI 伙伴。准备好了吗接下来的内容我们将通过保姆级的图文步骤带你从零开始亲手搭建这套属于未来的个人 AI 基础设施。让我们开始吧一、Node.js 下载安装这里我建议安装 nvm 去管理你的不同版本的 Node.js1.1 下载安装nvmnvm是什么?nvm(Node Version Manager)是一个用于管理Node.js版本的命令行工具。它允许开发者在同一台机器上安装和切换多个版本的Node.js以便于在不同的项目中使用不同的Node.js版本。在工作中我们可能同时在进行2个或者多个不同的项目开发每个项目的需求不同进而不同项目必须依赖不同版本的NodeJS运行环境这种情况下对于维护多个版本的node将会是一件非常麻烦的事情。nvm就是为解决这个问题而产生的他可以方便的在同一台设备上进行多个node版本之间切换。具体安装文章【2026 最新】手把手教你彻底卸载 Node.js 用 nvm 管理多版本告别环境混乱nvm保姆级安装配置使用教程Windows版_卸载node最新版本-CSDN博客1.2 安装需要版本的Node.js具体 Node.js 版本要大于 22Node.jsv22.xv22.10.0 LTS必须是大版本 221.2.1 检查当前Node.js的版本当你安装好 nvm 后win R 输入 cmd 打开 终端输入下述指令可以查看你所有下载安装的的Node.js版本如图所示前面有星星的是你当前的Node.js版本我的当前的版本是 22nvm ls1.2.2 没有22版本的看这里下载安装如果大家没有22版本按照下述指令来下载安装22版本的Node.js。nvm install 22接着使用下述指令切换到当前版本的Node.jsnvm use 22查看当前版本nvm ls二、Git 下载安装具体安装教程看这篇文章【2026 最新】下载安装 Git 详细教程 Windows_git下载-CSDN博客三、OpenClaw 下载安装点击 Win 在搜索栏搜索 PowerShell选择用管理员方式运行为了避免PowerShell默认策略太严格导致安装报错输入下述指令它允许你在自己的账户下运行自己编写的或在本机创建的脚本同时阻止未经数字签名的、从互联网下载的脚本运行从而在便利性和安全性之间取得一个平衡。Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser之后在后面输入 Y表示同意这一次修改接着回车3.1 开始安装安装命令iwr -useb https://openclaw.ai/install.ps1 | iex安装过程中会跳出是否允许公共网络访问Node.js这里点击允许即可等待一段时间下方出现红色字体 OpenCla 2026 即安装成功。不要关闭当前紧接着向下翻开始配置OpenClaw3.2 开始配置OpenClaw 默认设计为“个人专属使用”即仅你本人操作这里提示是为了确保你是不是个人用这里直接点击键盘上的左方向键选择Yes接着回车确认。接下来下述直接回车保持默认的QuickStart模式。这一步选择 OpenClaw 大模型厂商用键盘的上下键切换如果你有创建过某个服务商的API密钥可以直接使用这里我推荐Kimi因为Kimi会免费送新用户15块钱的额度。上述终端页面先不要关闭我们先去配置你需要的AI模型厂商的密钥如果有密钥的可以跳过 3.3 创建Kimi大模型密钥 这一步。3.3 创建Kimi大模型密钥进入Kimi后台进行登录Moonshot AI 开放平台 - Kimi K2.5 大模型 API 服务账户总览可以看到你的账户余额创建API key密钥在 API key 管理页面右上角点击新建 API key复制你的密钥这里一定要妥善管理好你的密钥不要让别人知道不然最后烧的就是你的token。3.4 配置大模型回到PowerShell向下选择Kimi模型接着回车这里因为我们是在Kimi网站创建的密钥所以这里选择.cn后缀的接着回车。接着选择现在复制密钥回车将你刚才创建好的密钥粘贴到这里来然后回车接着选择模型这里我就保持默认的模型 kimi-2.5然后回车这里是要选择你要和OpenClaw对话的方式因为这里涉及一些后续配置先跳过。这一部分是在让你配置“网络搜索”工具允许你创建的 AI 代理Agent具备实时上网搜索信息的能力。如果你是初次尝试且没有上述搜索引擎的账号建议直接选择Skip for now跳过先体验本地的基础功能。后续需要联网搜索时可以随时重新运行配置向导来添加。这里我选择跳过。接下来就是选择Skills就是你的小龙虾需要掌握的技能如果你有清晰的需求这里可以看看有没有需要配置的每个技能的后面内都有各自的应用场景解释。这里左右键选择Yes就会进入选择Skills页面常见技能技能名称图标功能描述/用途1password密码管理工具用于安全存储和检索密码。blogwatcher博客监控工具可能用于跟踪特定博客的更新或内容。camsnap摄像头相关工具可能用于拍照、截图或视频监控。clawhubOpenClaw 的官方插件库或社区市场。eightctl智能床如 Eight Sleep控制相关。gemini✨与 Google Gemini 模型或相关服务集成的工具。gifgrepGIF 图片搜索或处理工具。githubGitHub 集成工具用于管理仓库、提交代码、查看 Issues 等。gog可能与 GOG 游戏平台相关用于管理游戏库或购买记录。goplaces地理位置或地图相关工具可能用于地点查询或导航。himalaya电子邮件客户端工具用于收发和管理邮件。mcporter与 Minecraft 服务器管理或数据传输有关。nano-banana-pro是一个特定的轻量级工具或服务。nano-pdfPDF 文件处理工具用于阅读、编辑或转换 PDF。obsidianObsidian 笔记软件集成工具用于与你的本地笔记库交互。openai-whisperOpenAI 的 Whisper 语音识别模型集成用于语音转文字。openhuePhilips Hue 智能灯泡控制工具用于调节灯光颜色、亮度等。oracle与 Oracle 数据库或云服务相关。ordercli订单管理工具可能用于处理电商订单或物流信息。sag与音频处理或特定服务相关。songsee音乐或音频识别工具可能用于识别歌曲或处理音频文件。sonoscliSonos 智能音响控制工具用于播放音乐、调节音量等。如果没有需要配置的Skills直接上键选择Skip for now 接着空格 回车即可。接着会让你选择配置一系列密钥如果你都没有配置的话直接选择No回车即可我这里全选的No。对应的 API Key服务/功能说明建议操作GOOGLE_PLACES_API_KEY谷歌地点服务用于查询地点、地图信息等。若无谷歌云账号选No。GEMINI_API_KEYGoogle Gemini 模型服务用于调用 Gemini 生成内容。若无 Google AI Studio 账号选No。NOTION_API_KEYNotion 笔记服务用于读写 Notion 数据库/页面。若无 Notion 集成令牌选No。OPENAI_API_KEYOpenAI 图像生成服务如 DALL·E用于生成图片。若无 OpenAI 账号选No。OPENAI_API_KEYOpenAI 语音识别服务Whisper用于语音转文字。若无 OpenAI 账号选No。ELEVENLABS_API_KEYElevenLabs 语音合成服务用于生成自然语音。若无 ElevenLabs 账号选No。“自动化钩子Hooks”是一种自动化规则。它允许你设定当 AI 代理执行某些特定指令如/new、/reset时自动触发一些预设的动作。这里我们也可以直接选择Skip for now接着空格 回车跳过即可。接着程序会自启动网关我们可以看到一个命令窗口被自动打开了这个窗口先不要关它等待一会回到之前的PowerShell窗口这里会提示你再哪里启动打开小龙虾这里我推荐使用Web UI 网页图形页面更加直观好操作。上述回车后会自动打开网页在这里我们就可以和我们的小龙虾对话了。四、将OpenClaw和飞书连接4.1 创建飞书机器人官网飞书开放平台点击右上角的登录按钮进行登录登录成功后点击后上角的开发者后台点击创建企业自建应用填写你的应用名称和应用描述添加机器人功能点击左侧权限管理里面页面里面的开通权限右侧输入框内输入下述im:全选当前权限点击确认开通权限接着点击上面黄色方框内的创建版本填写相关内容后向下翻点击保存即可。4.2 连接飞书机器人回到 PowerShell 输入openclaw config回车再次进行配置选择 Local 本地运行回车选择 Channels 配置通讯方式回车选择 Configure/link添加新的消息渠道回车一路向下找到飞书选择回车这里需要安装飞书插件直接回车即可等待一会安装成功后我们需要 飞书应用的App Secret点击 Enter App Secret (Stores the credential directly in OpenClaw config)接着回车我们来到飞书开发者后台点击左侧的凭证与基础信息复制右侧的App Secret凭证与基础信息 - OpenClaw【Windows】 - 开发者后台然后粘贴密钥回车复制App ID粘贴然后回车选择| WebSocket (default) 通讯方式回车我们是在国内飞书创建的直接回车这里选择是否允许在群聊里使用机器人这里选择第二个Open - respond in all groups (requires mention)意思为所有群里都可以使用机器人但是必须机器人。接着向下翻选择Finished完成配置然后这一步询问要不要现在配置私聊访问策略也就是谁可以在飞书私聊里用OpenClaw机器人我们选择Yes然后回车如果只是自己测试使用策略可以先选择Open如果是正式环境建议选择Pairing我这里选择Open然后回车Pairing (recommended) — 配对模式推荐含义这是最安全的模式。只有在你主动添加该用户为好友即完成配对后AI 才会响应他们的私信。适用场景个人使用或小范围团队内部使用。你只想和信任的人交流。Allowlist (specific users only) — 白名单模式仅限特定用户含义只有在你预先设置的“白名单”里的用户才能发送私信给 AI。其他用户的消息会被忽略。适用场景你需要严格控制谁能与 AI 交流比如只允许特定的管理员或团队成员操作。Open (public inbound DMs) — 开放模式公开接收含义任何人都可以通过飞书搜索到你的机器人并发送私信AI 都会回复。适用场景公开的服务号、客服机器人或公开问答机器人。但要注意这可能会收到垃圾信息或骚扰。Disabled (ignore DMs) — 禁用模式忽略私信含义AI 完全不会处理任何私信消息即使有人发消息过来也不会回复。适用场景你只打算通过群组Groups或其他渠道使用 AI不打算在私信里和它交互。选择最后的continue回车这样你就配置好了你的OpenClaw接着在 PowerShell 输入openclaw gateway进行回车如果出现下述报错无需理会是因为你的OpenClaw 网关已经在运行了进程 ID 为 29076因此无法再次启动。PS C:\WINDOWS\system32 openclaw gateway OpenClaw 2026.3.13 (61d171a)Eid al-Fitr: Celebration mode: queues cleared, tasks completed, and good vibes committed to main with clean history.20:17:29 [plugins] plugins.allow is empty; discovered non-bundled plugins may auto-load: feishu (F:\Chengxusheji\Nvm\nvm\node_cache\node_modules\openclaw\extensions\feishu\index.ts). Set plugins.allow to explicit trusted ids.20:17:35 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes20:17:35 [plugins] feishu_chat: Registered feishu_chat tool20:17:35 [plugins] feishu_wiki: Registered feishu_wiki tool20:17:35 [plugins] feishu_drive: Registered feishu_drive tool20:17:35 [plugins] feishu_bitable: Registered bitable tools20:17:35 Gateway failed to start: gateway already running (pid 29076); lock timeout after 5000msIf the gateway is supervised, stop it with: openclaw gateway stop20:17:35 Gateway service appears registered. Stop it first.20:17:35 Tip: openclaw gateway stop20:17:35 Or: schtasks /End /TN OpenClaw GatewayPS C:\WINDOWS\system32然后再飞书自建应用界面点击左侧的事件与回调修改订阅方式选择长连接保存保存成功后点击右下角的添加事件搜索接受消息勾选之后选择添加回到权限管理点击开通权限搜索通讯录将获取通讯录基本信息勾选上点击确认要想要生效需要再次点击上方的创建版本输入信息后下滑下方后点击保存发布成功后即可配置成功。五、测试对话打开手机版飞书APP打开应用这样就可以和你的小龙虾OpenClaw对话啦六、常见问题6.1 问题一飞书应用未显示如果App开发者小助手里面内没有打开应用显示说明没有配置好机器人建议检查4.1 创建飞书机器人这一步。6.2 问题二OpenClaw回复无响应如果在询问你的小龙虾没有回复建议检查你是否打开小龙虾网关又没有下述页面如果没有建议在PowerShell管理员运行模式下输入下述命令关闭重启打开openclaw gateway stop openclaw gateway restart七、关闭暂停OpenClaw7.1 只是关闭暂停当你不想去使用你的OpenClaw想要关闭暂停它可以在终端输入下述指令然后回车打开终端Terminal 或 CMD/PowerShell。输入以下命令并回车openclaw gateway stop效果这会停止后台的 LaunchAgent 或系统服务Web 界面和聊天功能将暂时无法使用。补充如果你想重启它可以使用openclaw gateway restart。场景分类适用情况操作目的1. 临时释放电脑资源需要运行大型游戏、渲染视频或感觉电脑变卡时释放被占用的内存和 CPU让电脑运行更流畅忙完后可随时启动2. 暂时不需要 AI 响应周末/假期休息或开会/专注工作时不想被打扰切断 AI 的“耳朵”和“嘴巴”使其进入“冬眠”状态不再响应指令但保留配置3. 修改配置前的准备需要更换 API Key、修改模型参数或调整技能包时防止修改文件时后台程序仍在读取旧配置导致冲突或修改不生效4. 排查故障重启大法AI 反应迟钝、不回复消息、报错或似乎“卡死”时相当于给 AI 做一次“重启”通常能解决大部分连接或运行的小毛病7.2 如何彻底关闭“开机自启”如果你只是不想让它每次开机都自动运行而不是想卸载它可以执行以下操作命令bashopenclaw gateway install --no-auto-start八、彻底卸载OpenClaw1. 打开终端TerminalWindows 用户按Win R键输入cmd按回车或者在开始菜单搜索“命令提示符”或“PowerShell”。Mac 用户按Command 空格输入Terminal或“终端”按回车。2. 执行核心卸载命令在终端窗口中复制并粘贴以下命令然后按回车键openclaw uninstall --all --yes命令解释uninstall告诉程序执行卸载。--all彻底删除模式包括网关服务、本地数据库、配置文件等所有数据。--yes全程自动确认不需要你手动输入Y确认。3. 删除命令行工具CLI执行完上一步后OpenClaw 的主体已经删除了但可能还剩下一个“外壳”命令行工具。为了彻底清除请继续执行以下命令npm uninstall -g openclaw(如果你当初是用 pnpm 或 bun 安装的请将npm替换为pnpm remove -g或bun remove -g)。
