OpenClaw是一款功能强大的终端式AI助手，支持多模型适配、多渠道接入，可本地部署也支持云端一键安装。
- 官方官网：openclaw.ai/
- GitHub仓库：github.com/openclaw/op…
- 部署方式：本地部署（本文核心）、云端一键安装（阿里云/火山引擎/mini max均提供）、Docker镜像安装（需自行下载镜像）
本文档为本地部署+飞书机器人接入的完整实操指南，适配macOS/Linux/Windows系统
OpenClaw运行依赖Node.js 24+ 和 Git，Node.js安装包自带npm，无需单独下载，以下为各系统适配的安装步骤，Windows操作需全程以管理员身份打开PowerShell。
方式1：官方下载（推荐新手）
官方地址：nodejs.org/
- 选择 LTS v24+ （稳定）版本，页面自动识别系统，直接下载对应安装包；
- 安装时默认选项即可，务必勾选Add to PATH，确保命令行可识别。
方式2：包管理器安装（推荐开发人员，macOS/Linux）
- macOS（需先安装Homebrew：）
国内镜像源加速（解决下载缓慢）
方式1：官方下载
官方地址：git-scm.com/
- 页面自动识别系统，Windows选64位版本，macOS/Linux选对应入口；
- 安装时务必勾选Add Git to PATH，新手保持默认选项即可。
方式2：包管理器安装（macOS/Linux）
打开命令行（Windows/PowerShell、macOS/Linux/终端），输入以下命令，能显示对应版本号即安装成功：
补充：Git安装后可配置全局用户信息（可选，避免部分git操作报错）
注意：macOS/Linux部分目录安装需要sudo权限，若出现权限错误，可在命令前加。
安装完成后自动进入交互式配置流程，按以下选项选择即可，部分配置可后续在Web UI/终端修改，配置项后附简单说明，方便理解选择原因：
配置核心为模型提供商配置，本文以免费的Qwen模型为例，提供 Web UI（可视化，推荐新手）和终端（配置文件，适合开发人员）两种方式
Qwen API Key获取地址：bailian.console.aliyun.com/cn-beijing/，后续配置需替换占位符。
1. 打开Web UI
打开后自动在浏览器弹出页面，若未弹出，手动访问本地地址即可。
2. 进入配置页面
左侧菜单栏依次选择： → → → 页面底部选择Raw模式（纯文本编辑配置）。
3. 配置（Qwen模型核心配置）
替换原有内容，将替换为自己的Qwen API Key：
4. 增加认证配置信息
5. 修改（默认模型与工作空间配置）
将替换为实际路径（macOS/Linux默认，Windows默认，目录不存在会自动创建）：
openclaw 安装
6. 配置命令黑名单（可选，禁止高风险命令）
添加在配置文件对应位置，防止机器人执行摄像头、录屏等高危操作：
7. 保存并生效配置
- 点击页面右上角Save保存配置；
- 保存完成后点击Update更新配置；
- 验证配置：终端执行，无报错即配置正确。
1. 打开配置文件
2. 完整配置模板
替换配置文件原有内容，需修改和，其他保持默认：
3. 保存并退出编辑器
- nano编辑器（macOS/Linux） ：按保存 → 按确认 → 按退出；
- 记事本（Windows） ：直接点击保存并关闭。
4. 验证配置并重启服务
支持Web UI 和 TUI（终端界面） 两种交互方式，可根据需求选择，核心功能一致。
- 核心功能：Chat对话、模型配置、渠道管理、插件管理；
- 关键页面：Chat（AI对话）、Settings（配置）、Plugins（插件）。
TUI 常用命令（输入后按回车执行）
状态正常标准：显示、，无任何错误提示。
完成OpenClaw基础配置后，接入飞书机器人实现飞书内AI对话，分为安装飞书插件、创建飞书应用、配置OpenClaw飞书参数、配置飞书机器人权限四步。
飞书开放平台入口：open.feishu.cn
提供3种安装方式，按顺序尝试，方式1失败则用方式2/3。
方式1：官方命令安装（推荐）
方式2：手动下载安装（方式1失败时）
方式3：OpenClaw自动安装
在TUI/Web UI的Chat界面发送以下内容，替换和（后续创建飞书应用后获取）：
OpenClaw会自动完成安装、配置、重启。
方式4：回到 openclaw config 自行选择 feishu 插件进行安装（新版支持，最便捷）
- 飞书开放平台登录后，点击右上角开发者后台；
- 点击创建企业自建应用，填写应用名称（如OpenClaw机器人）、应用描述（可选），点击创建；
3. 应用创建后，进入基础信息 → 凭证与基础信息，记录App ID和App Secret（后续配置需用）；
4. 关键补充：进入测试企业和人员，添加测试人员/测试群组（发布前仅测试对象可使用机器人，避免企业审核驳回）。
终端执行以下命令，将和替换为飞书应用的实际信息，命令逐行执行：（上述方式3和方式4不需要执行该参数配置， 方式3自主配置，方式4界面选择）
配置完成后重启网关：
回到飞书开发者后台的当前应用页面，按以下步骤配置，每一步均需保存：
- 添加机器人能力：左侧菜单栏，点击机器人卡片的添加；
- 完善机器人说明：机器人配置区域，点击「如何开始使用」旁的编辑按钮，添加简单说明（如“OpenClaw AI机器人，输入问题即可解答”）；
- 配置事件订阅：左侧菜单栏，订阅方式选择「使用长连接接收事件」并保存；
3. 添加接收消息事件：点击添加事件，搜索，添加该事件并确认开通对应权限；
- 开通核心权限：左侧菜单栏
-
- 「应用身份权限」：搜索，全部选中并开通；
- 「用户身份权限」：搜索，选中并开通；
- 创建版本并发布：点击页面顶部应用发布 → 版本管理与发布，创建新版本，填写更新说明后申请线上发布（企业自建应用发布后无需平台审核，直接生效）。
飞书机器人配置完成后，需完成配对授权才能实现消息响应，未授权时发送消息会提示权限错误。
在飞书向配置的机器人发送任意消息（如“测试”），机器人会回复包含配对码的提示，格式如下：
复制回复中的配对命令，替换为实际配对码，在终端执行：
配对成功：终端输出。
再次在飞书向机器人发送消息（如“你好”），机器人能正常响应即授权成功。
- 若仍提示权限问题，等待2-3分钟再试（飞书权限同步有延迟）；
- 群聊中需 @机器人 才能响应，单聊可直接发送消息。
补充：Web UI中会显示两个会话：（本地基础会话）、（飞书会话），可自由切换查看。
OpenClaw自带诊断工具，可自动修复大部分配置问题，优先执行以下命令：
状态正常标准
- 无（配置无效）错误；
- 显示、；
- 无（未知配置项）、（无效输入）提示。
常见问题排查
- 网关启动失败（端口18789占用）
2. 飞书机器人无响应（长连接未建立） ：重新安装飞书插件 → 重启网关 → 检查飞书事件订阅是否为「长连接模式」。 3. 模型调用失败：检查Qwen API Key是否正确 → 验证网络是否能访问 → 重启网关。
若需卸载，执行以下命令，仅杀死OpenClaw相关进程，不影响其他Node.js应用。
macOS/Linux 卸载
Windows 卸载（PowerShell管理员）
- Q：安装时提示curl/wget缺失？
A：macOS安装curl：；Linux安装：；Windows需安装Git Bash（自带curl）。 - Q：配置文件修改后不生效？
A：执行验证配置 → 执行重启网关。 - Q：飞书机器人发布后企业内无法使用？
A：飞书开发者后台「测试企业和人员」中添加企业所有成员 → 重新发布版本。 - Q：TUI/Web UI无法启动？
A：检查Node.js版本是否为v22+ → 执行 → 重启网关。
发布者：Ai探索者，转载请注明出处：https://javaforall.net/251970.html原文链接：https://javaforall.net
