环境配置
如果已经安装可跳过
本文介绍 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 用户可以跳过

进入以下链接
创建应用


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

点击左侧栏会有 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" ], "user": [ "aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read" ] } }
具体可见 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