夜雨聆风
安装openclaw
这是一篇详细的 OpenClaw 安装指南，手把手教你完成安装。如果你不想折腾，可以直接翻到文章末尾添加博主微信，我们提供付费安装服务。
效果预览
安装成功后，系统会接入飞书机器人。在命令行启动时，你会看到飞书相关的连接提示。之后有任何需求，直接在飞书里发消息，控制OpenClaw来为你工作。
openclaw gateway #启动命令
打开网页的效果
打开飞书成功的效果
OpenClaw +飞书安装教程如下
OpenClaw Windows 首先配置前置环境
一、前置环境安装
1. Git 安装（拉取源码必备）
Git 是常用的版本控制工具，Windows 系统下详细安装步骤如下：
下载安装包
访问 Git 官方下载页面：https://git-scm.com/download/win，页面会自动识别当前 Windows 系统位数（64位/32位），直接点击对应版本的安装包下载即可。
运行安装程序
找到下载完成的 .exe 格式安装包，双击启动安装向导，按以下指引操作：
建议勾选**「Use Git and optional Unix tools from the Command Prompt」**，可直接在系统CMD命令行中使用Git命令，操作更便捷；
右键菜单选项勾选**「Git Bash Here」**，后续可在任意文件夹空白处右键，快速打开Git专属终端；
其余安装配置保持默认即可，无需额外修改，一路点击「Next」直至安装完成。
验证安装结果
按下快捷键 Win+R，输入 cmd并回车，打开系统命令提示符，输入以下命令：
git--version若命令行输出类似 git version 2.43.0.windows.1 的版本号信息，即代表Git安装成功，可正常使用。
2. Node.js 安装（项目运行核心依赖）
OpenClaw 项目基于 Node.js 开发运行，需安装 16.x 及以上 LTS 长期支持版本，保障项目正常编译、启动，Windows 系统安装步骤如下：
下载安装包
访问 Node.js 中文官网下载页：https://nodejs.org/zh-cn/download/，选择**「Windows 安装包（.msi）」**（优先选64位版本），点击下载对应安装包。
运行安装程序
双击下载好的 .msi 格式安装包，启动安装向导，核心配置需注意：
必须勾选「Add Node.js to PATH」，该选项会自动将Node.js添加到系统环境变量，无需手动配置，是项目正常运行的关键；
其余安装路径、组件选项保持默认，持续点击「Next」完成全部安装流程。
验证安装结果
重新打开系统CMD命令提示符（避免环境变量未生效），依次输入以下两条命令，分别验证Node.js和npm包管理器：
node-v# 验证Node.js版本，正常输出如 v20.10.0npm-v# 验证npm版本，正常输出如 10.2.3若两条命令均能正常输出版本号，说明Node.js安装配置完成，可满足OpenClaw项目运行需求。
安装openclaw
github链接：https://github.com/openclaw/openclaw，不需要下载代码，可以当文档看
npm install -g openclaw@latestopenclaw onboard --install-daemon这里会有一个选择，大概意思是OpenClaw 处于测试阶段，默认仅个人使用，可操作系统文件，开启工具后有安全风险。这里如果担心可以使用虚拟机的方式。虚拟机安装看这里vmware官网免费下载安装教程
国内可以选择Volcano Engine（火山引擎），Qwen（千问）、Moonshot AI(Kimi)、MiniMax等，我用的火山的deepseek3.2，因为便宜些，选择相应的平台，然后获取apikey，去相应平台注册获取即可。具体方式可以看文章最后，整理了各个平台注册方式以及当前的模型价格。
其他的skills、chennels等可以先跳过，后面如果想重新配置，可运行命令
openclaw configure启动
openclaw gateway --port 18789 --verbose打开网页http://127.0.0.1:18789/chat?token=这里的token可以去openclaw.json找到
openclaw安装位置，默认会安装到
C:\Users\电脑用户名\.openclaw
这里有个openclaw.json，里面存储着你得一些配置，token在这里存储
网页正常打开
配置飞书
运行命令，配置飞书
openclaw configure选择channels
选择飞书进行安装
在配置飞书时，直接安装可能会报错，[openclaw] Failed to start CLI: Error: spawn EINVAL这里我的报错了，这里用别的方法安装，访问github，https://github.com/m1heng/clawdbot-feishu使用命令
openclaw plugins install @m1heng-clawd/feishu这个也可能报错， spawn EINVAL如果openclaw plugins install失败，使用下面命令尝试
# Option A (recommended): download latest package tarballnpm pack @m1heng-clawd/feishuopenclaw plugins install ./m1heng-clawd-feishu-<version>.tgz这个命令可以查看飞书插件版本，npm pack @m1heng-clawd/feishu
下面的version记得更换上面输出的版本，例如openclaw plugins install ./m1heng-clawd-feishu-0.1.15.tgz
如果这个命令还是报错的话，在.openclaw\extensions\feishu目录下运行npm install,然后重启openclaw。npm install有可能会一直在加载中。可以尝试更换yarn，运行下面命令安装yarn
npm install -g yarn在.openclaw\extensions\feishu目录下运行
yarn install上面完成后，下面来进入飞书配置1、在飞书开放平台上创建自研应用2、配置插件3、启用所需权限（见下文）4、配置事件订阅（见下文）⚠️重要的
5、发布应用
1、开发者后台创建应用https://open.feishu.cn/app
2、配置插件这里有两个参数
通过命令配置
openclaw config set channels.feishu.appId "cli_xxxxx"openclaw config set channels.feishu.appSecret "your_app_secret"openclaw config set channels.feishu.enabled true3、开通权限
具体权限开通，也可访问这里链接https://github.com/m1heng/clawdbot-feishu开通权限
所需权限
| 允许 | 范围 | 描述 |
|---|---|---|
im:message | 消息传递 | 发送和接收消息 |
im:message.p2p_msg:readonly | DM | 阅读机器人发送的私信 |
im:message.group_at_msg:readonly | 团体 | 在群组中接收 @提及 消息 |
im:message:send_as_bot | 发送 | 以机器人身份发送消息 |
im:resource | 媒体 | 上传和下载图片/文件 |
工具权限只读（最低要求）：
| 允许 | 工具 | 描述 |
|---|---|---|
docx:document:readonly | feishu_doc | 阅读文档 |
drive:drive:readonly | feishu_drive | 列出文件夹，获取文件信息 |
wiki:wiki:readonly | feishu_wiki | 列出空间、列出节点、获取节点信息、搜索 |
bitable:app:readonly | feishu_bitable | 读取位记录和字段 |
task:task:read | feishu_task_get | 获取任务详情 |
task:tasklist:read | feishu_tasklist_get，feishu_tasklist_list | 获取/列出任务列表 |
task:comment:read | feishu_task_comment_list，feishu_task_comment_get | 列出/获取任务评论 |
task:attachment:read | feishu_task_attachment_list，feishu_task_attachment_get | 列出/获取任务附件 |
im:chat.announcement:read | feishu_chat | 阅读群组公告 |
im:chat:readonly | feishu_chat | 获取聊天信息，查看机器人成员资格 |
| 允许 | 范围 | 描述 |
|---|---|---|
contact:user.base:readonly | 用户信息 | 获取基本用户信息（用于解析发件人显示名称以进行说话人归属） |
im:message.group_msg | 团体 | 阅读所有群组消息（敏感信息）。当您想要requireMention: false处理非@群组消息时，此项为必填项。 |
im:message:readonly | 读 | 获取消息历史记录 |
im:message:update | 编辑 | 更新/编辑已发送消息 |
im:message:recall | 记起 | 撤回已发送的消息 |
im:message.reactions:read | 反应 | 查看消息反应 |
读写（可选，用于创建/编辑/删除操作）：
| 允许 | 工具 | 描述 |
|---|---|---|
docx:document | feishu_doc | 创建/编辑文档 |
docx:document.block:convert | feishu_doc | Markdown 到代码块的转换（写入/追加/创建和写入操作需要；也用于其他操作feishu_drive.import_document） |
drive:drive | feishu_doc，feishu_drive | 将图片上传到文档、创建文件夹、移动/删除文件 |
wiki:wiki | feishu_wiki | 创建/移动/重命名维基节点 |
bitable:app | feishu_bitable | 创建/更新/删除可分割记录并管理字段 |
task:task:write | feishu_task_create，，，feishu_task_subtask_createfeishu_task_updatefeishu_task_delete | 创建/更新/删除任务 |
task:tasklist:write | feishu_tasklist_create，，，，，，，feishu_tasklist_updatefeishu_tasklist_deletefeishu_tasklist_add_membersfeishu_tasklist_remove_membersfeishu_task_add_tasklistfeishu_task_remove_tasklist | 创建/更新/删除任务列表并管理成员资格 |
task:comment:write | feishu_task_comment_create，，feishu_task_comment_updatefeishu_task_comment_delete | 创建/更新/删除任务评论 |
task:attachment:write | feishu_task_attachment_upload，feishu_task_attachment_delete | 上传/删除任务附件 |
im:message.urgent | feishu_urgent | 通过应用内发送紧急（震动）通知。使用sms及其phone变体（im:message.urgent:sms，im:message.urgent:phone）进行短信和语音通话。 |
im:chat.announcement | feishu_chat | 撰写/更新群组公告 |
im:chat | feishu_chat | 创建和删除群聊 |
im:chat.members | feishu_chat | 将成员添加到群聊中 |
如果权限找不到，可以在这里搜索
4、配置事件订阅这里配置事件订阅需重新启动openclaw，启动后，然后再点击下面保存按钮。
5、发布应用，首先添加应用能力，可以选择机器人，在飞书的工作台可以找到你创建的机器人
场景版本发布
发布成功
在工作台可以看到创建的机器人
第一次运行可能遇到下面情况
OpenClaw: access not configured.Your Feishu user id: ou_fb2bb2d0bc3bddd76a07c4Pairing code: FJQDDAsk the bot owner to approve with:openclaw pairing approve feishu FJQDD在命令行窗口运行，注意这里FJQDD要换成你的
openclaw pairing approve feishu FJQDD
国内AI大模型平台注册&API Key获取（适配OpenClaw）
OpenClaw项目可对接国内主流AI大模型，火山引擎、Kimi、MiniMax，千问等，下方整理官方注册链接、API Key完整获取流程，步骤清晰、易操作。
1. 火山引擎
官方注册入口
火山引擎官网：https://www.volcengine.com/
火山方舟（AI模型服务入口）：https://www.volcengine.com/ark
API Key获取步骤
注册登录：访问火山引擎官网，用手机号完成注册、登录，进入控制台；
实名认证：进入个人中心完成实名认证（个人/企业均可，AI接口调用必填），认证审核极速通过；
开通DeepSeek模型：进入火山方舟控制台，找到DeepSeek3.2，点击立即开通并完成授权；
创建API Key：接入点创建完成后，进入API调用页面，选择创建API密钥，自定义密钥名称，点击确认生成；
保存密钥：生成的API Key仅展示一次，务必复制妥善保存，后续在OpenClaw项目中直接配置使用。
价格，百万token，输入2块钱，输出3块钱，我选的这个，因为这个便宜些
2. Kimi 智能助手（月之暗面）
官方注册入口
Kimi 开放平台：https://platform.moonshot.cn/
API Key获取步骤
访问Kimi开放平台，用手机号注册并登录账号；
进入控制台，完成个人实名认证，开通API调用权限；
左侧菜单栏找到API密钥，点击新建密钥，自定义密钥备注；
生成密钥后，立即复制保存，谨防泄露，后续可在该页面管理密钥权限、查看调用额度。这里一定要注意价格，kimi-k2.5百万token，输入4块钱，输出21块钱，当然也有优点响应速度快
3. Minimax（适配OpenClaw，常用M2.5模型）
官方注册入口
Minimax开放平台：https://www.minimaxi.com/
Minimax开发者控制台：https://platform.minimaxi.com/
API Key获取步骤
注册登录：访问Minimax开放平台，使用手机号完成注册、登录，进入开发者控制台；
实名认证：进入个人中心完成个人实名认证，开通API调用权限，审核快速通过；
创建API密钥：在控制台左侧菜单栏找到API密钥选项，点击新建密钥，自定义密钥名称/备注，确认生成；
保存密钥信息：生成的API Key（含AK/SK）仅展示一次，务必完整复制妥善保存，区分API Key与密钥信息，避免混淆；
模型选择：OpenClaw适配常用Minimax-M2.5模型，开通对应模型服务后，即可配置调用。注意价格
如果这篇教程帮到了你，节省了你的时间，欢迎请博主喝杯咖啡 ☕
你的支持是我持续输出高质量技术内容的动力。
微信：aiaihh6
