OpenClaw 安装与配置指南(Windows & macOS)
介绍 OpenClaw 在 Windows 和 macOS 系统上的安装步骤及常见问题解决方案。内容包括环境配置(Node.js)、工具安装流程、飞书机器人集成配置(App ID、密钥、权限、事件回调)、以及 Brave 搜索 API 的接入方法。文中还涵盖了网关启动失败、中文路径问题等常见错误的排查与修复。

介绍 OpenClaw 在 Windows 和 macOS 系统上的安装步骤及常见问题解决方案。内容包括环境配置(Node.js)、工具安装流程、飞书机器人集成配置(App ID、密钥、权限、事件回调)、以及 Brave 搜索 API 的接入方法。文中还涵盖了网关启动失败、中文路径问题等常见错误的排查与修复。

如果已经安装可跳过
链接
打开终端(Terminal)或命令提示符(Command Prompt),依次输入以下命令:


打开终端运行
iwr -useb https://openclaw.ai/install.ps1 | iex






我使用的飞书

如果是 Windows 的话建议先跳过(因为下载的话会报错 Windows 系统的兼容性 Bug)
执行的 npm 在 Windows 上,实际上执行的程序叫 npm.cmd

windows 用户另外启动一个终端 运行以下命令
1.安装飞书插件
npm install @openclaw/feishu
2.启动飞书插件
openclaw plugins enable feishu
3.查看插件启动情况
openclaw plugins list

也可以跳过 后期都可以自行配置

可以随便选 建议选上后两个

选 install 或者 reinstall

如果你的 openclaw 下载路径有中文的话 比如你的用户名 网关会启动失败
解决方法
win + R 输入以下命令

进入管路 然后更改系统区域设置

勾选如图选项 随后重启电脑

之后运行以下命令重新过一遍上述步骤
openclaw onboard

测试能否正常对话

openclaw config




windows 安装还是会报错 (windows 下的 bug)

windows 下如何进行接下来的配置呢?
来到 web 管理界面的频道可以配置

所以 windows 用户可以跳过

进入以下链接
https://open.feishu.cn/app?lang=zh-CN
创建应用


随后一定要点击添加机器人按钮

点击左侧栏会有 app id 和密钥了

来到 openclawd 的 web 管理端然后 复制粘贴进去 id 和密钥 选择以下配置然后保存

最后一步选 continue

回到飞书开放平台 点击批量导入

{ "scopes": { "tenant": [ "aily:file:read", "aily:file:write", "application:application.app_message_stats.overview:readonly", "application:application.self_manage", "application:bot.menu:write", "cardkit:card:write", "contact:user.employee_id:readonly", "corehr:file:download", "docs:document.content:read", "event:ip_list", "im:chat", "im:chat.access_event.bot_p2p_chat:read", "im:chat.members:bot_access", "im:message", "im:message.group_at_msg:readonly", "im:message.group_msg", "im:message.p2p_msg:readonly", "im:message:readonly", "im:message:send_as_bot", "im:resource", "sheets:spreadsheet", "wiki:wiki:readonly" ],
具体可见 github 链接 https://github.com/AlexAnys/openclaw-feishu


原因分析 是因为 openclaw 配置完成之后没有重启
运行以下命令
openclaw gateway restart
重启之后再点击保存

im.message.receive_v1

保存


注意版本号格式 并且保存确认发布

飞书配置完成
你会收到以下消息 没有的话 直接搜索 openclaw

点击打开应用
你会收到以下消息

在终端中运行最后一条命令
openclaw pairing approve feishu 码
运行完之后再发消息 就能正常回复了


进入以下链接
没有账户可先注册 后登录


复制申请的 AK
打开终端
再次运行以下命令
openclaw config
这个页面选择 web tools


之后就可以配置 brave 的 AK 了
随后按照指示结束配置
重启 openclaw
openclaw gateway restart
此时就可以联网搜索了

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online