OpenClaw安装和接入飞书机器人分三大部分组织回答1先讲环境准备和OpenClaw基础安装分阿里云和本地Windows两种场景2再讲飞书机器人配置包括应用创建、通道添加、事件订阅3最后讲验证和配置AI模型。为了更直观在部署方式对比、配置项说明等地方用表格呈现。这是一份完整的OpenClaw安装及接入飞书机器人的教程。将涵盖从环境准备、OpenClaw部署含阿里云服务器和本地Windows两种方式、AI模型以阿里云百炼为例配置到最终在飞书开放平台创建并接入机器人的全流程。第一部分准备工作与核心认知在开始动手前我们需要先了解 OpenClaw 是什么并准备好必要的账号和工具。1.1 什么是 OpenClawOpenClaw昵称“小龙虾”曾用名 ClawdBot / Moltbot是一个开源的个人AI智能体框架。它本身不具备推理能力需要对接大语言模型如阿里云百炼、七牛云、OpenAI等的API。它的核心价值在于真正的执行能力能通过“技能”Skills直接操作电脑、调用插件 。多平台接入支持接入飞书、Telegram、WhatsApp 等聊天软件 。部署灵活可以部署在云端7×24小时运行或个人电脑本地 。1.2 环境与物料清单在部署前请确保你准备好了以下内容服务器/电脑方案A推荐阿里云轻量应用服务器2核4GB内存以上系统推荐 Ubuntu 22.04 或 OpenClaw 官方镜像。方案B本地 Windows 11 电脑内存建议 8GB 以上需安装 Node.js 和 Git。必备账号与凭证阿里云账号用于开通百炼大模型服务或其他模型提供商如七牛云并获取 API Key 。飞书企业账号用于登录飞书开放平台创建机器人 。基础工具终端工具Windows 需管理员权限的 PowerShellMac/Linux 用自带终端 。远程连接工具如使用云服务器需准备 Finalshell、Xshell 或使用阿里云 WebShell 。第二部分OpenClaw 基础环境部署OpenClaw 依赖 Node.js 运行。你可以根据自己的情况选择在云服务器或本地 Windows 上部署。2.1 方案 A阿里云服务器部署7x24小时运行推荐适合团队协作、需要长期稳定运行的场景。2.1.1 获取阿里云百炼 API Key用于AI大脑OpenClaw 需要一个大模型来“思考”我们以阿里云百炼平台的模型为例 。访问 阿里云百炼大模型控制台完成实名认证。在“API-KEY 管理”中点击创建 API-Key。复制生成的密钥格式如sk-...保存好备用。2.1.2 一键购买与部署新手最快方式阿里云提供了包含 OpenClaw 的轻量应用服务器镜像可以实现一键部署 。进入专题页访问阿里云 OpenClaw 一键部署专题页面点击【一键购买并部署】。选购服务器镜像选择OpenClaw(Moltbot)镜像。如果已有服务器可以重置系统选择此镜像。实例规格内存必须2GiB 及以上建议4GiB。地域如需联网搜索功能建议选择非中国大陆地域如美国弗吉尼亚或使用香港地域 。配置百炼 API购买完成后进入轻量应用服务器控制台找到你的实例。点击进入应用详情页。在“OpenClaw使用步骤”区域单击配置百炼API-Key的“执行命令”输入刚才保存的 API-Key 。放行端口在应用详情页点击端口放通的“执行命令”一键放行 18789OpenClaw 控制台等必要端口 。获取访问地址点击访问 Web UI 面板的“执行命令”获取访问地址。在本地浏览器打开该地址格式为http://服务器公网IP:18789即可看到 OpenClaw 控制台 。2.1.3 Docker 手动部署进阶稳定如果你更喜欢用 Docker 进行环境隔离可以通过 SSH 连接到服务器后执行以下命令 # 1. 拉取官方镜像dockerpull openclaw/openclaw:2026.3.8# 2. 创建数据目录mkdir-p/opt/openclaw/{config,skills,agents,logs,feishu-config}# 3. 启动容器dockerrun-d\--nameopenclaw\--restartalways\-p18789:18789\-v/opt/openclaw/config:/app/config\-v/opt/openclaw/skills:/app/skills\-v/opt/openclaw/feishu-config:/app/feishu-config\-eTZAsia/Shanghai\openclaw/openclaw:2026.3.8# 4. 进入容器进行初始化dockerexec-itopenclawbashopenclaw init--feishu2.2 方案 B本地 Windows 11 部署测试、隐私优先适合个人测试或数据不想上传云端的场景 。2.2.1 安装系统依赖安装 Node.js下载 Node.js 官网的 LTS 版22.x 或 24.x。安装时务必勾选“Add to PATH”。安装后打开 PowerShell输入node -v和npm -v验证版本 。安装 Git从 Git 官网下载安装包保持默认选项确保 “Git Bash Here” 和 “Add Git to PATH” 被勾选 。安装 Visual C RedistributableWin10/Win11 通常需要此运行库从微软官网下载安装 x64 版本 。2.2.2 配置 PowerShell 与 npm 镜像以管理员身份打开 PowerShell。解除脚本执行限制关键步骤Set-ExecutionPolicyRemoteSigned-Scope CurrentUserSet-ExecutionPolicy-ScopeProcess-ExecutionPolicy Bypass按Y确认 。配置 npm 国内镜像加速下载npm configsetregistry https://registry.npmmirror.com/2.2.3 一键安装 OpenClaw在 PowerShell 中执行官方 Windows 安装脚本iwr-useb https://openclaw.ai/install.ps1|iex等待脚本自动运行完成 。2.2.4 初始化与启动启动 Gateway 服务openclaw gatewaystart运行配置向导首次安装openclaw onboard--install-daemon此向导会引导你设置模型提供商可先跳过或临时选择后续会修改。打开控制面板openclaw dashboard浏览器会自动打开http://127.0.0.1:18789进入 OpenClaw 图形化管理界面 。第三部分配置 AI 模型以阿里云百炼为例无论你采用哪种部署方式安装完成后都需要告诉 OpenClaw 使用哪个大模型。你可以通过修改配置文件或在 Web UI 中完成。3.1 配置文件方式OpenClaw 的配置文件通常位于~/.openclaw/openclaw.jsonLinux/Mac或C:\Users\你的用户名\.openclaw\openclaw.jsonWindows。在配置文件的models.providers中添加阿里云百炼或七牛云等兼容OpenAI格式的配置 {models:{providers:{bailian:{baseUrl:https://dashscope.aliyuncs.com/compatible-mode/v1,apiKey:你的阿里云百炼API-KEY,api:openai-completions,models:[{id:qwen-plus,name:通义千问-Plus,contextWindow:128000,maxTokens:8192},{id:qwen-max,name:通义千问-Max,contextWindow:128000,maxTokens:8192}]}}}}注意apiKey也可以通过环境变量${BAILIAN_API_KEY}引用更安全 。3.2 使用 Onboarding 向导如果你不想手动编辑文件也可以在终端重新运行openclaw onboard命令在交互式菜单中选择 “Model/auth provider”然后选择 “阿里云百炼” 并粘贴你的 API Key 。第四部分接入飞书机器人核心步骤这是让 OpenClaw 进入飞书群聊的关键环节。4.1 在飞书开放平台创建应用访问飞书开放平台登录你的企业账号。点击**“创建应用”** -“企业自建应用”填写应用名称如“我的小龙虾助手”和描述 。创建完成后进入应用详情页点击左侧**“凭证与基础信息”**获取App ID和App Secret保存好后面要用。4.2 配置 OpenClaw 飞书通道在 OpenClaw 中添加飞书通道在你的 OpenClaw 服务器终端或本地 PowerShell中执行# 格式openclaw channels add --channel feishu --token 你的AppID:你的AppSecretopenclaw channelsadd--channelfeishu--tokencli_xxxxxxxx:你的AppSecret参考 QQ Bot 的添加逻辑 。获取事件订阅地址添加通道后OpenClaw 会生成一个用于接收飞书事件的 HTTP 地址通常是https://你的公网IP或域名:18789/api/v1/channels/feishu/webhook或类似格式。如果是本地部署需要使用内网穿透工具如 ngrok将本地地址暴露到公网。如果是云服务器请确保使用的是公网 IP并且防火墙以及阿里云安全组已放行18789端口 。4.3 配置飞书应用的事件订阅回到飞书开放平台的应用管理后台。点击左侧**“事件订阅”**。在“请求地址配置”中粘贴上一步获取的 OpenClaw 事件订阅地址 。点击**“加密策略”**后面的“编辑”添加事件。搜索并添加message相关的权限和事件如接收消息这是机器人能收到并回复消息的基础。添加完成后点击“保存”。4.4 配置权限与发布权限管理在左侧“权限管理”中添加机器人需要的权限。通常至少需要im:messageim:message:send_as_bot以机器人的身份发送消息im:chat获取群聊信息发布版本点击左侧“版本管理与发布”创建一个版本并提交审核需企业管理员审核。或者如果你是企业管理员可以直接点击“申请发布”然后在审核中通过 。4.5 将机器人添加到飞书群在飞书客户端打开你想让机器人工作的群聊。点击群设置 -“群机器人”-“添加机器人”。搜索你刚才创建的应用名称如“我的小龙虾助手”点击添加。第五部分验证与使用检查 OpenClaw 状态在服务器终端执行openclaw status或openclaw doctor确保 Gateway 正在运行且飞书通道状态正常 。在飞书群中互动在飞书群里直接 你的机器人发送一条消息比如“你好”。如果配置正确机器人会调用配置好的大模型进行思考并回复消息 。进阶技巧OpenClaw 支持多智能体你可以配置多个飞书机器人账号加入同一个群分别响应不同领域的问题如一个负责编程一个负责文案实现“一群多助手” 。常见问题排查提示openclaw: command not foundnpm 全局安装目录未添加到 PATH。执行npm prefix -g找到路径如/usr/local然后将/usr/local/bin添加到系统的 PATH 环境变量中 。飞书机器人无回复检查飞书开放平台的事件订阅地址是否验证通过。检查服务器防火墙和安全组是否放行了 18789 端口。查看 OpenClaw 日志openclaw gateway status或查看/var/log/openclaw/下的日志文件 。确认 API Key 是否有效余额是否充足。服务启动失败/内存不足OpenClaw 需要至少 2GB 可用内存建议 4GB。如果是低配服务器建议增加 Swap交换分区或升级配置 。通过以上步骤你应该已经成功将 OpenClaw 接入飞书拥有一个 24 小时在线的 AI 协作了。
OpenClaw安装和接入飞书机器人完整教程
OpenClaw安装和接入飞书机器人分三大部分组织回答1先讲环境准备和OpenClaw基础安装分阿里云和本地Windows两种场景2再讲飞书机器人配置包括应用创建、通道添加、事件订阅3最后讲验证和配置AI模型。为了更直观在部署方式对比、配置项说明等地方用表格呈现。这是一份完整的OpenClaw安装及接入飞书机器人的教程。将涵盖从环境准备、OpenClaw部署含阿里云服务器和本地Windows两种方式、AI模型以阿里云百炼为例配置到最终在飞书开放平台创建并接入机器人的全流程。第一部分准备工作与核心认知在开始动手前我们需要先了解 OpenClaw 是什么并准备好必要的账号和工具。1.1 什么是 OpenClawOpenClaw昵称“小龙虾”曾用名 ClawdBot / Moltbot是一个开源的个人AI智能体框架。它本身不具备推理能力需要对接大语言模型如阿里云百炼、七牛云、OpenAI等的API。它的核心价值在于真正的执行能力能通过“技能”Skills直接操作电脑、调用插件 。多平台接入支持接入飞书、Telegram、WhatsApp 等聊天软件 。部署灵活可以部署在云端7×24小时运行或个人电脑本地 。1.2 环境与物料清单在部署前请确保你准备好了以下内容服务器/电脑方案A推荐阿里云轻量应用服务器2核4GB内存以上系统推荐 Ubuntu 22.04 或 OpenClaw 官方镜像。方案B本地 Windows 11 电脑内存建议 8GB 以上需安装 Node.js 和 Git。必备账号与凭证阿里云账号用于开通百炼大模型服务或其他模型提供商如七牛云并获取 API Key 。飞书企业账号用于登录飞书开放平台创建机器人 。基础工具终端工具Windows 需管理员权限的 PowerShellMac/Linux 用自带终端 。远程连接工具如使用云服务器需准备 Finalshell、Xshell 或使用阿里云 WebShell 。第二部分OpenClaw 基础环境部署OpenClaw 依赖 Node.js 运行。你可以根据自己的情况选择在云服务器或本地 Windows 上部署。2.1 方案 A阿里云服务器部署7x24小时运行推荐适合团队协作、需要长期稳定运行的场景。2.1.1 获取阿里云百炼 API Key用于AI大脑OpenClaw 需要一个大模型来“思考”我们以阿里云百炼平台的模型为例 。访问 阿里云百炼大模型控制台完成实名认证。在“API-KEY 管理”中点击创建 API-Key。复制生成的密钥格式如sk-...保存好备用。2.1.2 一键购买与部署新手最快方式阿里云提供了包含 OpenClaw 的轻量应用服务器镜像可以实现一键部署 。进入专题页访问阿里云 OpenClaw 一键部署专题页面点击【一键购买并部署】。选购服务器镜像选择OpenClaw(Moltbot)镜像。如果已有服务器可以重置系统选择此镜像。实例规格内存必须2GiB 及以上建议4GiB。地域如需联网搜索功能建议选择非中国大陆地域如美国弗吉尼亚或使用香港地域 。配置百炼 API购买完成后进入轻量应用服务器控制台找到你的实例。点击进入应用详情页。在“OpenClaw使用步骤”区域单击配置百炼API-Key的“执行命令”输入刚才保存的 API-Key 。放行端口在应用详情页点击端口放通的“执行命令”一键放行 18789OpenClaw 控制台等必要端口 。获取访问地址点击访问 Web UI 面板的“执行命令”获取访问地址。在本地浏览器打开该地址格式为http://服务器公网IP:18789即可看到 OpenClaw 控制台 。2.1.3 Docker 手动部署进阶稳定如果你更喜欢用 Docker 进行环境隔离可以通过 SSH 连接到服务器后执行以下命令 # 1. 拉取官方镜像dockerpull openclaw/openclaw:2026.3.8# 2. 创建数据目录mkdir-p/opt/openclaw/{config,skills,agents,logs,feishu-config}# 3. 启动容器dockerrun-d\--nameopenclaw\--restartalways\-p18789:18789\-v/opt/openclaw/config:/app/config\-v/opt/openclaw/skills:/app/skills\-v/opt/openclaw/feishu-config:/app/feishu-config\-eTZAsia/Shanghai\openclaw/openclaw:2026.3.8# 4. 进入容器进行初始化dockerexec-itopenclawbashopenclaw init--feishu2.2 方案 B本地 Windows 11 部署测试、隐私优先适合个人测试或数据不想上传云端的场景 。2.2.1 安装系统依赖安装 Node.js下载 Node.js 官网的 LTS 版22.x 或 24.x。安装时务必勾选“Add to PATH”。安装后打开 PowerShell输入node -v和npm -v验证版本 。安装 Git从 Git 官网下载安装包保持默认选项确保 “Git Bash Here” 和 “Add Git to PATH” 被勾选 。安装 Visual C RedistributableWin10/Win11 通常需要此运行库从微软官网下载安装 x64 版本 。2.2.2 配置 PowerShell 与 npm 镜像以管理员身份打开 PowerShell。解除脚本执行限制关键步骤Set-ExecutionPolicyRemoteSigned-Scope CurrentUserSet-ExecutionPolicy-ScopeProcess-ExecutionPolicy Bypass按Y确认 。配置 npm 国内镜像加速下载npm configsetregistry https://registry.npmmirror.com/2.2.3 一键安装 OpenClaw在 PowerShell 中执行官方 Windows 安装脚本iwr-useb https://openclaw.ai/install.ps1|iex等待脚本自动运行完成 。2.2.4 初始化与启动启动 Gateway 服务openclaw gatewaystart运行配置向导首次安装openclaw onboard--install-daemon此向导会引导你设置模型提供商可先跳过或临时选择后续会修改。打开控制面板openclaw dashboard浏览器会自动打开http://127.0.0.1:18789进入 OpenClaw 图形化管理界面 。第三部分配置 AI 模型以阿里云百炼为例无论你采用哪种部署方式安装完成后都需要告诉 OpenClaw 使用哪个大模型。你可以通过修改配置文件或在 Web UI 中完成。3.1 配置文件方式OpenClaw 的配置文件通常位于~/.openclaw/openclaw.jsonLinux/Mac或C:\Users\你的用户名\.openclaw\openclaw.jsonWindows。在配置文件的models.providers中添加阿里云百炼或七牛云等兼容OpenAI格式的配置 {models:{providers:{bailian:{baseUrl:https://dashscope.aliyuncs.com/compatible-mode/v1,apiKey:你的阿里云百炼API-KEY,api:openai-completions,models:[{id:qwen-plus,name:通义千问-Plus,contextWindow:128000,maxTokens:8192},{id:qwen-max,name:通义千问-Max,contextWindow:128000,maxTokens:8192}]}}}}注意apiKey也可以通过环境变量${BAILIAN_API_KEY}引用更安全 。3.2 使用 Onboarding 向导如果你不想手动编辑文件也可以在终端重新运行openclaw onboard命令在交互式菜单中选择 “Model/auth provider”然后选择 “阿里云百炼” 并粘贴你的 API Key 。第四部分接入飞书机器人核心步骤这是让 OpenClaw 进入飞书群聊的关键环节。4.1 在飞书开放平台创建应用访问飞书开放平台登录你的企业账号。点击**“创建应用”** -“企业自建应用”填写应用名称如“我的小龙虾助手”和描述 。创建完成后进入应用详情页点击左侧**“凭证与基础信息”**获取App ID和App Secret保存好后面要用。4.2 配置 OpenClaw 飞书通道在 OpenClaw 中添加飞书通道在你的 OpenClaw 服务器终端或本地 PowerShell中执行# 格式openclaw channels add --channel feishu --token 你的AppID:你的AppSecretopenclaw channelsadd--channelfeishu--tokencli_xxxxxxxx:你的AppSecret参考 QQ Bot 的添加逻辑 。获取事件订阅地址添加通道后OpenClaw 会生成一个用于接收飞书事件的 HTTP 地址通常是https://你的公网IP或域名:18789/api/v1/channels/feishu/webhook或类似格式。如果是本地部署需要使用内网穿透工具如 ngrok将本地地址暴露到公网。如果是云服务器请确保使用的是公网 IP并且防火墙以及阿里云安全组已放行18789端口 。4.3 配置飞书应用的事件订阅回到飞书开放平台的应用管理后台。点击左侧**“事件订阅”**。在“请求地址配置”中粘贴上一步获取的 OpenClaw 事件订阅地址 。点击**“加密策略”**后面的“编辑”添加事件。搜索并添加message相关的权限和事件如接收消息这是机器人能收到并回复消息的基础。添加完成后点击“保存”。4.4 配置权限与发布权限管理在左侧“权限管理”中添加机器人需要的权限。通常至少需要im:messageim:message:send_as_bot以机器人的身份发送消息im:chat获取群聊信息发布版本点击左侧“版本管理与发布”创建一个版本并提交审核需企业管理员审核。或者如果你是企业管理员可以直接点击“申请发布”然后在审核中通过 。4.5 将机器人添加到飞书群在飞书客户端打开你想让机器人工作的群聊。点击群设置 -“群机器人”-“添加机器人”。搜索你刚才创建的应用名称如“我的小龙虾助手”点击添加。第五部分验证与使用检查 OpenClaw 状态在服务器终端执行openclaw status或openclaw doctor确保 Gateway 正在运行且飞书通道状态正常 。在飞书群中互动在飞书群里直接 你的机器人发送一条消息比如“你好”。如果配置正确机器人会调用配置好的大模型进行思考并回复消息 。进阶技巧OpenClaw 支持多智能体你可以配置多个飞书机器人账号加入同一个群分别响应不同领域的问题如一个负责编程一个负责文案实现“一群多助手” 。常见问题排查提示openclaw: command not foundnpm 全局安装目录未添加到 PATH。执行npm prefix -g找到路径如/usr/local然后将/usr/local/bin添加到系统的 PATH 环境变量中 。飞书机器人无回复检查飞书开放平台的事件订阅地址是否验证通过。检查服务器防火墙和安全组是否放行了 18789 端口。查看 OpenClaw 日志openclaw gateway status或查看/var/log/openclaw/下的日志文件 。确认 API Key 是否有效余额是否充足。服务启动失败/内存不足OpenClaw 需要至少 2GB 可用内存建议 4GB。如果是低配服务器建议增加 Swap交换分区或升级配置 。通过以上步骤你应该已经成功将 OpenClaw 接入飞书拥有一个 24 小时在线的 AI 协作了。
