阅读需 10 分钟
在当今快速发展的技术浪潮中，效率与协作成为企业和个人成功的关键。OpenClaw，作为一款领先的智能开发伙伴，旨在革新我们的工作方式，尤其在提升团队协作效率和自动化工作流程方面展现出卓越的潜力。本指南将提供详尽的步骤，帮你轻松完成 OpenClaw 安装，涵盖从基础环境准备到高级配置，确保用户能够顺利地将 OpenClaw 整合到日常工作中，包括详细的 OpenClaw 部署教程。无论您是初次接触还是寻求更深入的 OpenClaw 教程，这篇 OpenClaw 教程 将是您不可或缺的参考。
什么是 OpenClaw？—— 深入理解其核心价值
首先，我们来解答“OpenClaw 是啥”这个核心问题。OpenClaw 不仅仅是一个工具，它是一个强大的智能代理框架，通过与主流协作平台如 Lark 的深度集成，能够以用户的身份直接执行任务。想象一下，您的 AI 伙伴可以自动处理 Lark 内的文档、消息、日程，甚至进行复杂的代码操作，这就是 OpenClaw 所带来的未来工作模式。它能够显著提升个人及团队的效率，释放人力资源去关注更具创造性的工作。想要获取更多信息，请访问 OpenClaw 官网。
谁适合用 OpenClaw？
如果您仅仅满足于基础的 AI 对话，市面上的网页聊天产品已然足够。然而，若您渴望 AI 助手能够真正地“付诸行动”，那么传统 AI 对话工具已无法满足日益增长的自动化需求。若您的愿景是让 AI 成为真正的“执行者”，而不仅仅是“对话者”，OpenClaw 将是您不可或缺的工具。它能够：
- 构建常驻 AI 助手： 在本机或服务器上部署，提供持续的智能服务。
- 实现无界调用： 通过 Web、Slack、Telegram 等多平台接口，随时随地触发 AI 能力。
- 赋能自主行动： 让 AI 具备搜索、浏览、执行命令和自动化处理任务的完整链路。
- 整合 AI 生态： 统一接入自有模型或中转 API，打造高度定制化的 AI 管理中心。OpenClaw 甚至支持构建 OpenClaw 多 agent 系统，以实现更复杂的协作任务。
OpenClaw 的价值远超普通 AI 演示，它被业界誉为“基础设施型 AI 助手”，为您的智能工作流提供坚实支撑。那么，OpenClaw 可以干什么呢？它可以是您的代码助手，帮助您检查代码、生成测试用例；它也可以是您的知识管理系统，帮助您整理和检索信息。通过与 Lark 的集成，它甚至能够直接执行您的指令，例如在 Lark 中发送消息、创建待办事项。OpenClaw 本地部署 也为您提供了更强的控制权和定制性。
开始前的准备工作
在开始 OpenClaw 部署之前，确保您的系统满足以下先决条件至关重要。在按照 OpenClaw 教程安装前，请先做好这些准备：
- Node.js 版本： OpenClaw 最推荐用 Node 24。当然，如果您还在用 Node 22 LTS （22.16+） ，这也完全没问题，它也支持。
- 操作系统： OpenClaw 支持 macOS、Linux 和 Windows。
- Windows 用户注意： 强烈建议在 WSL2 （Windows Subsystem for Linux 2） 环境下运行 OpenClaw，这样体验会更流畅。
- 云主机提醒： 如果您在 VPS 或云主机上安装，尽量别用“一键安装”这种第三方镜像。最好选一个纯净的操作系统（比如 Ubuntu LTS），然后手动安装 OpenClaw，这样能保证系统更稳定。
安装并配置 OpenClaw（Linux/macOS、Windows）
💡 提示：若你已完成 OpenClaw 的安装与配置，可直接跳转至将 OpenClaw 接入 Lark 章节。
- 遵循官方指南并运行其中一个安装命令：
- Linux/macOS: curl -fsSL https://openclaw.ai/install.sh | bash
- Windows: iwr -useb https://openclaw.ai/install.ps1 | iex
- 按照提示完成 OpenClaw 配置。例如，您可以参考 ModelArk 编码计划集成说明。
- 打开 OpenClaw 仪表盘 URL。如果成功加载，则安装完成。
- 在仪表盘聊天页面，发送一条测试提示，以验证助手是否能正常响应。
将 OpenClaw 引入 Lark
2026.4.24 重要更新：OpenClaw Lark 插件中一键安装 Lark Cli
Lark cli 安装方式：
给 OpenClaw Lark 机器人 发送以下内容即可：
请按照该文档帮我安装 Lark cli：https://open.feishu.cn/document/mcp_open_tools/feishu-cli/set-up-lark-cli-for-ai-agents-in-openclaw_hermes.md
为什么我这么推荐把 OpenClaw 和 Lark 集成在一起？对我而言，这不只是让机器人在聊天里回句话，而是想搭建一个更默契、更智能的工作流程。现在工作环境变化快，团队每天要切换好多应用，如果把 AI 的洞察直接嵌入到 Lark 这样的统一平台里，确实能让协作和生产效率都上一个台阶。
把 OpenClaw 和 Lark 无缝连接起来，就能让 Lark 这个协作工具发挥出更大的潜力。而且，官方现在已经推出了 OpenClaw Lark 插件，授权之后，OpenClaw 可以直接读写文档、搜信息、查看日历安排，还能结合 Lark 群聊的上下文来理解需求。接下来我们也会出一份详细的操作指南，一步步教你怎么把 OpenClaw 的智能功能用起来，让团队效率再往上冲一冲。
支持的 Lark 功能
代表用户发送消息需要额外的 Lark 权限 im:message.send_as_user。某些组织可能会出于安全策略而限制或禁用此权限。
现在，让我们深入了解一下操作流程。
安装 Lark 插件
- 在命令行界面中运行以下命令（如果失败，请尝试在开头添加 sudo）：
npx -y @larksuite/openclaw-lark install
- 在设置过程中，选择创建新机器人或使用与 OpenClaw 关联的现有机器人。
🦞 如果在关联现有机器人时提示应用 ID 或应用密钥无效，您可以手动输入正确的凭证。
- 如果您想创建新的机器人，请使用 Lark 应用扫描二维码，然后点击创建。
- 创建完成后，点击打开机器人，然后发送任意消息开始聊天。
🦞
- 若要批量授予 OpenClaw 访问您授权资源的权限，请发送/feishu auth。
- 为帮助 OpenClaw 学习新功能，请发送：Review the newly installed Lark plugin and list its capabilities。
- 要验证插件是否正常工作，请发送/feishu start。如果返回版本信息，则安装成功。
升级 Lark 插件
- 使用 openclaw -v 检查您的 OpenClaw 版本。Lark 插件所需的最低版本：
- Linux / macOS：2026.2.26 或更高版本
- Windows: 2026.3.2 或更高版本
如果您使用的是较低版本，请使用以下命令升级 OpenClaw：npm install -g openclaw。
- 运行以下命令将 Lark 插件升级到最新版本。如果失败，请尝试在开头添加 sudo。
npx -y @larksuite/openclaw-lark update
高级配置
启用流式输出
- 若要切换到流式输出，请运行以下命令。对于本地部署，请在设备上输入；对于云部署，请在聊天中输入。
openclaw config set channels.feishu.streaming true
- 若要禁用流式输出，请运行以下命令：
openclaw config set channels.feishu.streaming false
- 若要在流卡上显示更多信息，请运行以下命令：
openclaw config set channels.feishu.footer.elapsed true # Show elapsed time
openclaw config set channels.feishu.footer.status true # Show status
启用多任务处理和独立线程上下文
机器人可以获取独立上下文，并针对主题组中的每个帖子或聊天组中的消息线程并行执行多个任务。
- 要启用此功能，请运行以下命令：
openclaw config set channels.feishu.threadSession true
- 若要禁用此功能，请运行以下命令：
openclaw config set channels.feishu.threadSession false
修改飞书机器人在群内的回复方式
目前插件支持的默认方式是机器人被拉进群后，只有 at 机器人时才可回复。
模式1：在群内机器人仅响应应用所有者（主人）@机器人的消息，不响应其他人发给机器人的消息 （已作为3.17及以上版本安装时的默认策略，推荐配置）
配置方法
{
"channels": {
"feishu": {
"enabled": true,
"appId": "cli_YourAppID",
"appSecret": "YourAppSecret",
"requireMention": true,
"groupPolicy": "allowlist",
"groupAllowFrom": ["ou_XXXX"],
"groups": { "*": { "enabled": true } }
}
}
}
将 groupPolicy 设置为 "allowlist"（白名单），并通过 groupAllowFrom 指定允许触发机器人的用户，配置你本人 openid 信息。你可以直接咨询小龙虾你的 openid 。
再在 groups 中设置 requireMention: true，要求消息必须 @ 到机器人后才会回复。
模式 2：只有 @机器人 才回复，可响应群内任何人发送的消息
配置方法
openclaw config set channels.feishu.requireMention true --json # restart to take effect
sh /workspace/projects/scripts/restart.sh
完整配置示例
{"channels": {"feishu": {"enabled": true,"appId": "cli_yourAppID","appSecret": "yourAppSecret","requireMention": true,"groupPolicy": "open"}}}
模式 3：不用 @，所有消息都回复
⚠️ 警告：这个模式在大群里容易刷屏，谨慎使用！
需要额外在开发者后台申请应用身份权限：获取群组中所有消息（敏感权限）im:message.group_msg 。
配置方法
openclaw config set channels.feishu.requireMention false --json
sh /workspace/projects/scripts/restart.sh
完整配置示例
{"channels": {"feishu": {"enabled": true,"appId": "cli_yourAppID","appSecret": "yourAppSecret","requireMention": false,"groupPolicy": "open"}}}
模式 4：只有指定群 @机器人才回复（高级）
效果
- 大部分群：不用 @ 也能回复（或者完全不回复）
- 特定群：必须 @ 才回复
- 适合：不同群不同规则，比如工作群严格一点，闲聊群随意一点
配置方法
第一步：获取群 ID
可通过以下任意方式获取目标群 ID：
- 让机器人加入群后，发送任意消息，然后在日志里找群 ID，或让机器人回复群 ID。
- 群成员可以通过点击右上角的群菜单选项进入群设置页面，查看群 ID。
第二步：配置特定群规则
# Set the default behavior: no @mention required for all groups
openclaw config set channels.feishu.requireMention open --json
# Require @mention for a specific group (replace the example ID with your actual Group ID)
openclaw config set channels.feishu.groups.oc_xxxxxxxx.requireMention true --json
# Restart to apply changes
sh /workspace/projects/scripts/restart.sh
完整配置示例
{"channels": {"feishu": {"enabled": true,"appId": "cli_yourAppID","appSecret": "yourAppSecret","requireMention": "open","groupPolicy": "open","groups": {"oc_axxxxxxxa": {"requireMention": true},"oc_bxxxxxxxx": {"requireMention": true}}}}}
为多个代理配置多个 Lark 机器人
快速入门提示：
- 在 open.larksuite.com 一键创建新的 Lark 机器人。
- 告诉机器人你想要什么样的新代理以及它应该使用哪个 Lark 账户，提供本指南，并要求它完成设置。
常用诊断命令和修复方法
在与 OpenClaw 的聊天中发送这些命令：
- /feishu start：确认安装是否成功。
- /feishu doctor：检查配置是否正确。
- /feishu auth：批量授予权限。
该插件嵌入了常见问题的解决方案，因此你可以先向机器人本身寻求帮助。如果它无法提供解决方案，请运行以下命令自行诊断并解决问题：
npx /openclaw-lark doctor
运行 fix 命令尝试自动修复：
npx @larksuite/openclaw-lark doctor --fix
如果问题仍然存在，请在反馈群中报告，并提供以下信息：
- 版本信息：运行以下命令，并将输出结果包含在您的报告中。
npx /openclaw-lark info
- 详细配置：使用--all 命令获取更多详细信息。
npx /openclaw-lark info --all
安全警告
随着 AI 能力日新月异，越来越多的团队开始尝试将智能助手集成到日常协作工具中，比如把 OpenClaw 接入 Lark。但在享受便利之前，有一件事我们必须认真对待——数据安全。
🔴 核心风险
OpenClaw Lark 插件通过官方 API 与你的 Lark 账号对接，可访问包括消息、文档、日历、联系人等在内的数据。一旦插件被恶意利用或系统出现漏洞，这些数据都存在泄露的可能。尽管我们已经在代码和架构层面实施了安全加固，但必须坦诚地告诉大家：大语言模型本质上是概率系统，其行为难以 100%预测，因此我们无法承诺“零风险”。任何涉及敏感信息的集成，都应建立在充分了解和审慎评估的基础上。
⚠️ 警告
如果你在多用户环境下使用这个机器人，或者用的是企业 Lark 账户，可能存在数据安全和隐私方面的风险。请务必严格遵守你们组织的相关政策和规定，防止出现数据泄露、越权访问或隐私侵权等问题。
📌 其他风险
- AI 没那么完美，也会“脑补”：它偶尔会理解错你的意思，甚至编出一些看似合理、实则不对的信息。
- 有些操作是没法撤销的：比如 AI 替你发出去的消息，就再也收不回来了。
- 建议做法：凡是涉及到发消息、改文档、写内容这类关键操作，最好养成“先预览、再确认”的习惯。千万别让 AI 在没有人工监督的情况下“全自动驾驶”。
💡 OpenClaw 使用建议
可以先从个人账户试起，等我们的安全和隔离机制更完善了，再考虑接入公司环境。
OpenClaw 和 Lark 的强强联合
OpenClaw 与 Lark 的深度整合，绝非只是让 AI 机器人简单回复消息这么简单，它能帮助您打造一个更加高效、智能的工作体系。在当今数字化办公环境中，各类应用已经成为工作必备，而将 AI 能力直接融入 Lark 这样的协同办公平台，必将显著提升团队的工作效率和协作水平。
我们可以把 OpenClaw 比作团队的智能管家，它能在后台默默处理各类信息。当与 Lark 实现无缝对接后，AI 生成的分析结果就能即时呈现在团队沟通、项目管理和文档共享的统一平台上。这样既避免了 AI 工具成为"信息孤岛"，又能确保所有有价值的分析成果都能被及时共享和落实。
这种整合具体能为团队带来哪些效率提升呢？
- 智能分析直达团队沟通：OpenClaw 擅长处理复杂数据，与 Lark 对接后，AI 生成的深度分析可以直接推送到相关群聊或频道。比如当 OpenClaw 分析客户反馈时发现重复出现的问题，它会自动生成问题摘要和解决方案建议，并立即推送到客服团队的 Lark 群聊中，方便大家第一时间讨论并采取行动。
- 自动化工作流：当 Lark 的自动化工具遇上 OpenClaw，工作效率将实现质的飞跃。举个例子：OpenClaw 处理市场数据并检测到竞争对手定价的重大变化。通过 Lark 中预先配置的自动化，这一检测结果可以自动触发一系列事件：向销售团队的聊天群组发送警报，在项目管理看板中为营销团队创建一项任务以审查定价策略，并在相关的 Lark 云文档中发布更新。这种智能化的响应机制，让团队能够快速应对市场变化。
将 OpenClaw 引入 Lark 生态系统，不仅是为团队增加了一个工具，更是在构建一个智能化的协作环境。在这里，AI 的智慧将全方位赋能团队，提升决策质量和工作效率。
结论
将 OpenClaw 部署，特别是把它和 Lark 这种强大的协作平台整合起来，是提升团队 AI 能力的关键第一步。我们已经介绍了各种安装方法，确保每个用户都能找到清晰的路径。另外，详细的 OpenClaw 和 Lark 连接指南也展示了怎么把这个智能工具直接融入团队的日常沟通和工作流程。
在正确设置上花点功夫，绝对是物超所值。OpenClaw 不再只是一个技术工具，它会变成团队追求效率和洞察力的核心成员。跟着这些步骤走，您不仅仅是在安装一个软件，更是在为建立一个更统一、更智能的工作空间打基础，让 AI 的贡献能无缝地融入到您的团队协作中。
常见问题（FAQs）
OpenClaw 安装要做哪些准备工作？
OpenClaw安装前，需要做好以下准备工作：
- Node.js 版本： 推荐使用 Node 24，但 Node 22 LTS (22.16+) 也支持。
- 操作系统： 支持 macOS、Linux 和 Windows。Windows 用户强烈建议在 WSL2 环境下运行。
- 云主机： 如果在 VPS 或云主机上安装，建议选择纯净的操作系统（如 Ubuntu LTS），手动安装 OpenClaw，避免使用第三方一键安装镜像。
- Git： 需安装 Git。
- Lark 应用配置： 如果要与 Lark 集成，需要在 Lark 开发者后台创建自定义应用，并配置相应的权限和功能。
我可以在 Windows/Mac/Linux 上安装 OpenClaw 吗？
是的，OpenClaw （又称龙虾 ai）旨在实现跨平台兼容性。您可以在 macOS（原生）、Windows（理想情况下通过 WSL 实现稳健环境，或原生）和 Linux 上安装它。本文涵盖了这些环境中每一种的安装过程。
如何让 OpenClaw 运行我的第一次聊天？
以 Lark 上的使用为例，成功安装 OpenClaw 并配置其与 Lark 的集成（如“为 Lark 配置 OpenClaw”部分所述）后，您可以通过向 Lark 中的 OpenClaw 机器人发送测试消息来启动您的第一次聊天。机器人将提供一个配对代码，您可以在终端中使用该代码批准连接，从而开始与它互动。
OpenClaw 是免费使用的吗？
OpenClaw 通常指代免费使用并通常允许社区贡献的开源项目或组件。但是，特定实现或托管服务的确切许可和任何相关成本将取决于项目的官方文档。
我需要 GPU 才能运行 OpenClaw 吗？
虽然 OpenClaw 通常可以在 CPU 上运行，但强大的 GPU（图形处理单元）可以显著加速性能，尤其是对于涉及大型语言模型、复杂数据处理或实时 AI 交互的任务。对于基本用途，CPU 可能足够，但建议使用专用 GPU 以获得最佳速度和效率。
如何完成 OpenClaw 卸载？
卸载 OpenClaw 主要有两种方法。如果您的电脑上仍然安装了 OpenClaw 的命令行工具（CLI），最简单的方式是直接运行内置的卸载命令 openclaw uninstall。如果您需要自动化卸载，可以添加 --all --yes --non-interactive 参数。
如果 CLI 已经不在了，但 Gateway 网关服务仍在运行，您就需要手动移除服务。具体操作会根据您的操作系统有所不同：macOS 用户需要通过 launchctl 移除服务文件；Linux 用户使用 systemctl 来禁用并删除服务单元；而 Windows 用户则需要通过 schtasks 命令删除计划任务。无论哪种情况，别忘了删除相关的状态文件、配置以及您可能安装的 macOS 应用程序。如果您是从源码安装的，需先卸载 Gateway 服务，再删除源码目录。如果您需要详细步骤和代码，请访问官网关于卸载的说明。
如果我的安装失败怎么办？
如果您的安装失败，请首先查看终端或日志中的错误消息。常见原因包括未满足的先决条件（例如 Node.js 版本不正确）、权限问题或网络问题。请重新检查本指南的故障排除部分，查阅 OpenClaw 的官方文档，并考虑向 OpenClaw 社区、OpenClaw 中文社区或支持渠道寻求帮助。
🙋 关于使用 OpenClaw 与 Lark 的具体问题
如何申请所需权限以解决“权限不足”问题？
- 在 Lark 开发者控制台中，点击权限与范围在左侧导航栏中，然后点击批量导入/导出范围。
- 在导入标签中，清理导入标签中的内容，然后粘贴以下内容：
{
"scopes": {
"tenant": [
"contact:contact.base:readonly",
"docx:document:readonly",
"im:chat:read",
"im:chat:update",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message.pins:read",
"im:message.pins:write_only",
"im:message.reactions:read",
"im:message.reactions:write_only",
"im:message:readonly",
"im:message:recall",
"im:message:send_as_bot",
"im:message:send_multi_users",
"im:message:send_sys_msg",
"im:message:update",
"im:resource",
"application:application:self_manage",
"cardkit:card:write",
"cardkit:card:read",
"contact:user.basic_profile:readonly"
],
"user": [
"contact:user.employee_id:readonly",
"offline_access","base:app:copy",
"base:field:create",
"base:field:delete",
"base:field:read",
"base:field:update",
"base:record:create",
"base:record:delete",
"base:record:retrieve",
"base:record:update",
"base:table:create",
"base:table:delete",
"base:table:read",
"base:table:update",
"base:view:read",
"base:view:write_only",
"base:app:create",
"base:app:update",
"base:app:read",
"sheets:spreadsheet.meta:read",
"sheets:spreadsheet:read",
"sheets:spreadsheet:create",
"sheets:spreadsheet:write_only",
"docs:document:export",
"docs:document.media:upload",
"board:whiteboard:node:create",
"board:whiteboard:node:read",
"calendar:calendar:read",
"calendar:calendar.event:create",
"calendar:calendar.event:delete",
"calendar:calendar.event:read",
"calendar:calendar.event:reply",
"calendar:calendar.event:update",
"calendar:calendar.free_busy:read",
"contact:contact.base:readonly",
"contact:user.base:readonly",
"contact:user:search",
"docs:document.comment:create",
"docs:document.comment:read",
"docs:document.comment:update",
"docs:document.media:download",
"docs:document:copy",
"docx:document:create",
"docx:document:readonly",
"docx:document:write_only",
"drive:drive.metadata:readonly",
"drive:file:download",
"drive:file:upload",
"im:chat.members:read",
"im:chat:read",
"im:message",
"im:message.group_msg:get_as_user",
"im:message.p2p_msg:get_as_user",
"im:message:readonly",
"search:docs:read",
"search:message",
"space:document:delete",
"space:document:move",
"space:document:retrieve",
"task:comment:read",
"task:comment:write",
"task:task:read",
"task:task:write",
"task:task:writeonly",
"task:tasklist:read",
"task:tasklist:write",
"wiki:node:copy",
"wiki:node:create",
"wiki:node:move",
"wiki:node:read",
"wiki:node:retrieve",
"wiki:space:read",
"wiki:space:retrieve",
"wiki:space:write_only",
"contact:user.basic_profile:readonly"
]
}
}
- 点击下一步，查看新范围，然后点击添加。
- 确保租户令牌作用域的可访问数据范围为默认值“与应用可用性相同”，并点击确认。
如果我没有 OpenClaw，如何部署 Lark 插件？
运行此插件需要 OpenClaw。请选择适合您需求的部署选项：
- 对于本地部署，使用 TRAE SOLO 等编码代理来协助安装。
- 对于云部署，可尝试 ModelArk，它支持一键设置，还能协助调试。
运行插件时提示“找不到模块 xxx”，我该怎么办？
- 原因：插件依赖项未安装，可能是由于安装中断或权限问题。
- 解决方案：导航到插件目录并运行 npm install。
无法使用 OpenClaw 3.2 调用工具
在 OpenClaw 3.2 中，新代理的工具权限默认是禁用的。要解决这个问题，请打开您的 openclaw.json 文件，并使用以下代码片段进行更新：
{
"tools": {
"profile": "full",
"sessions": {
"visibility": "all"
}
}
}
官方 Lark 插件与 OpenClaw 捆绑的飞书插件有何区别？
相关阅读
Table of contents
想了解 Lark 吗？
所有工具尽在一处
节省时间，提高效率
节省高达 70% 的软件成本
Table of contents
想了解 Lark 吗？
所有工具尽在一处
节省时间，提高效率
节省高达 70% 的软件成本
