️ 环境准备与接入飞书机器人指南第一部分Windows 系统安装流程1. 安装 Node.js官网地址Node.js 官网 (中文下载)操作步骤下载Windows 安装程序 (.msi)。双击运行安装包勾选“我同意协议”一路点击Next。点击Install开始安装完成后点击Finish。2. 安装 Git官网地址Git 官网 (Windows)操作步骤下载对应版本如 Git for Windows/x64 Setup。运行安装包一路点击Next。安装完成时取消勾选“View Release Note”点击Finish。3. 安装 OpenClaw操作步骤在系统搜索栏输入PowerShell右键选择“以管理员身份运行”。输入以下命令并回车根据提示输入Y确认执行策略更改powershell编辑1Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser执行安装命令powershell编辑1iwr -useb https://openclaw.ai/install.ps1 | iex看到 OpenClaw 欢迎信息即代表安装成功。4. 初始化 OpenClaw配置流程风险提示输入Yes。模式选择QuickStart。模型服务商任选如 OpenAI / Anthropic。通讯渠道选择Skip for now。Skills选择Skip for now。API Key没有则选No。Hook选择Skip for now。最后选择Web UI启动。注若出现聊天界面说明配置成功。5. 创建飞书机器人官网地址飞书开放平台操作步骤登录账号点击创建企业自建应用。添加机器人能力。在权限管理中搜索im:开通消息相关权限。创建版本并发布。6. 连接 OpenClaw 和飞书操作步骤回到 PowerShell输入openclaw config。选择local-Channels-Configure/link- 选择Feishu。通过 npm 安装插件。输入飞书App Secret和App ID。通讯方式选择WebSocket。域名选择feishu.cn。群聊权限选择Open。选择Finished。运行命令openclaw gateway启动服务。7. 飞书事件配置操作步骤进入飞书开发者后台的机器人应用点击事件与回调。订阅方式选择长连接。添加事件接收消息。在权限管理中新增权限获取通讯录基本信息。创建新版本并发布。8. 测试机器人在飞书 App 中找到应用发送消息。若 OpenClaw 能正常回复即配置成功。第二部分macOS 系统安装流程1. 安装 Homebrew (包管理器)操作步骤打开终端 (Terminal)。输入以下命令原文档中的命令已自动指向 Gitee 镜像适合国内网络bash编辑1/bin/zsh -c $(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)按提示操作选择下载源输入1清华大学镜像。输入开机密码。若询问是否删除旧版本输入Y。选择镜像源输入5阿里镜像。安装完成后关闭并重新打开终端。2. 安装 Git命令bash编辑1brew install git3. 安装 Node.js官网地址Node.js 官网 (中文下载)操作步骤下载macOS 安装程序 (.pkg)。双击运行点击“继续”同意协议并安装输入密码完成。4. 安装 OpenClaw操作步骤打开终端先配置国内镜像源加速bash编辑1npm config set registry https://registry.npmmirror.com避免 SSH 问题bash编辑1git config --global url.https://github.com/.insteadOf ssh://gitgithub.com/执行安装命令需输入密码bash编辑1sudo npm install -g openclawlatest出现added xxx packages提示即为成功。5. 初始化 OpenClaw (Mac版)清理旧插件防止冲突bash编辑1sudo rm -rf ~/.openclaw/extensions/feishu后续步骤从openclaw gateway开始与 Windows 章节相同。第三部分常用命令速查表表格命令功能命令语句启动服务openclaw gateway start查看状态openclaw gateway status打开 Web 界面openclaw dashboard 补充说明与注意事项关于 OpenClawOpenClaw 是飞书官方推出的插件/工具参考网页[4]旨在让 AI 更懂你的工作。在配置过程中如果遇到网络超时建议检查代理设置或重试。关于 Node.js 版本根据网页[3]的信息当前 Node.js 的最新 LTS 版本为v24.14.1。建议在安装时选择 LTS长期支持版本以保证稳定性。关于飞书开放平台飞书提供了 2500 的开放接口参考网页[4]除了机器人你还可以开发网页应用、小程序等多种形态。安全提示在 Windows PowerShell 中执行Set-ExecutionPolicy时需谨慎这是为了允许脚本运行。在 macOS 中使用sudo时请确保你信任该软件包。Windows 系统完全卸载 OpenClaw第一步使用内置卸载器在 PowerShell 中运行官方卸载命令这会停止服务并删除大部分组件openclaw uninstall --all --yes --non-interactive这会处理停止 Gateway 服务、卸载计划任务、删除状态和配置文件。第二步手动清理残留官方卸载器可能会遗漏一些文件需要手动清理1. 删除计划任务schtasks /Delete /F /TN OpenClaw Gateway2. 删除配置目录# 主配置目录 Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw # 旧版本遗留目录如果有 Remove-Item -Recurse -Force $env:USERPROFILE\.clawdbot 2$null Remove-Item -Recurse -Force $env:USERPROFILE\.moltbot 2$null Remove-Item -Recurse -Force $env:USERPROFILE\.molthub 2$null # AppData 目录 Remove-Item -Recurse -Force $env:APPDATA\openclaw 2$null Remove-Item -Recurse -Force $env:LOCALAPPDATA\openclaw 2$null3. 卸载 CLI 工具由于你是通过install.ps1脚本安装的CLI 是通过 npm 全局安装的npm rm -g openclaw如果你使用 pnpm 或 bun 安装的相应替换为powershellpnpm remove -g openclaw # 或 bun remove -g openclaw第三步验证完全卸载运行以下命令确认已完全删除powershell# 检查 CLI 是否还存在 where.exe openclaw # 应该返回 Could not find files # 检查计划任务是否还存在 schtasks /Query /TN OpenClaw Gateway 2$null # 应该返回错误 The system cannot find the file specified # 检查目录是否已删除 Test-Path $env:USERPROFILE\.openclaw # 应该返回 False # 检查进程是否还在运行 Get-Process | Where-Object { $_.ProcessName -match openclaw } # 应该没有输出清理环境变量如果你之前设置了自定义配置路径OPENCLAW_CONFIG_PATH也需要清理# 检查是否设置了自定义路径 echo $env:OPENCLAW_CONFIG_PATH # 如果设置了删除该目录并移除环境变量 [Environment]::SetEnvironmentVariable(OPENCLAW_CONFIG_PATH, $null, User)总结命令# 1. 官方卸载 openclaw uninstall --all --yes --non-interactive # 2. 删除计划任务 schtasks /Delete /F /TN OpenClaw Gateway 2$null # 3. 删除所有配置目录 Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw 2$null Remove-Item -Recurse -Force $env:USERPROFILE\.clawdbot 2$null Remove-Item -Recurse -Force $env:USERPROFILE\.moltbot 2$null Remove-Item -Recurse -Force $env:APPDATA\openclaw 2$null Remove-Item -Recurse -Force $env:LOCALAPPDATA\openclaw 2$null # 4. 卸载 CLI npm rm -g openclaw # 5. 验证 where.exe openclaw
OPEN CLAW 安装指南
️ 环境准备与接入飞书机器人指南第一部分Windows 系统安装流程1. 安装 Node.js官网地址Node.js 官网 (中文下载)操作步骤下载Windows 安装程序 (.msi)。双击运行安装包勾选“我同意协议”一路点击Next。点击Install开始安装完成后点击Finish。2. 安装 Git官网地址Git 官网 (Windows)操作步骤下载对应版本如 Git for Windows/x64 Setup。运行安装包一路点击Next。安装完成时取消勾选“View Release Note”点击Finish。3. 安装 OpenClaw操作步骤在系统搜索栏输入PowerShell右键选择“以管理员身份运行”。输入以下命令并回车根据提示输入Y确认执行策略更改powershell编辑1Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser执行安装命令powershell编辑1iwr -useb https://openclaw.ai/install.ps1 | iex看到 OpenClaw 欢迎信息即代表安装成功。4. 初始化 OpenClaw配置流程风险提示输入Yes。模式选择QuickStart。模型服务商任选如 OpenAI / Anthropic。通讯渠道选择Skip for now。Skills选择Skip for now。API Key没有则选No。Hook选择Skip for now。最后选择Web UI启动。注若出现聊天界面说明配置成功。5. 创建飞书机器人官网地址飞书开放平台操作步骤登录账号点击创建企业自建应用。添加机器人能力。在权限管理中搜索im:开通消息相关权限。创建版本并发布。6. 连接 OpenClaw 和飞书操作步骤回到 PowerShell输入openclaw config。选择local-Channels-Configure/link- 选择Feishu。通过 npm 安装插件。输入飞书App Secret和App ID。通讯方式选择WebSocket。域名选择feishu.cn。群聊权限选择Open。选择Finished。运行命令openclaw gateway启动服务。7. 飞书事件配置操作步骤进入飞书开发者后台的机器人应用点击事件与回调。订阅方式选择长连接。添加事件接收消息。在权限管理中新增权限获取通讯录基本信息。创建新版本并发布。8. 测试机器人在飞书 App 中找到应用发送消息。若 OpenClaw 能正常回复即配置成功。第二部分macOS 系统安装流程1. 安装 Homebrew (包管理器)操作步骤打开终端 (Terminal)。输入以下命令原文档中的命令已自动指向 Gitee 镜像适合国内网络bash编辑1/bin/zsh -c $(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)按提示操作选择下载源输入1清华大学镜像。输入开机密码。若询问是否删除旧版本输入Y。选择镜像源输入5阿里镜像。安装完成后关闭并重新打开终端。2. 安装 Git命令bash编辑1brew install git3. 安装 Node.js官网地址Node.js 官网 (中文下载)操作步骤下载macOS 安装程序 (.pkg)。双击运行点击“继续”同意协议并安装输入密码完成。4. 安装 OpenClaw操作步骤打开终端先配置国内镜像源加速bash编辑1npm config set registry https://registry.npmmirror.com避免 SSH 问题bash编辑1git config --global url.https://github.com/.insteadOf ssh://gitgithub.com/执行安装命令需输入密码bash编辑1sudo npm install -g openclawlatest出现added xxx packages提示即为成功。5. 初始化 OpenClaw (Mac版)清理旧插件防止冲突bash编辑1sudo rm -rf ~/.openclaw/extensions/feishu后续步骤从openclaw gateway开始与 Windows 章节相同。第三部分常用命令速查表表格命令功能命令语句启动服务openclaw gateway start查看状态openclaw gateway status打开 Web 界面openclaw dashboard 补充说明与注意事项关于 OpenClawOpenClaw 是飞书官方推出的插件/工具参考网页[4]旨在让 AI 更懂你的工作。在配置过程中如果遇到网络超时建议检查代理设置或重试。关于 Node.js 版本根据网页[3]的信息当前 Node.js 的最新 LTS 版本为v24.14.1。建议在安装时选择 LTS长期支持版本以保证稳定性。关于飞书开放平台飞书提供了 2500 的开放接口参考网页[4]除了机器人你还可以开发网页应用、小程序等多种形态。安全提示在 Windows PowerShell 中执行Set-ExecutionPolicy时需谨慎这是为了允许脚本运行。在 macOS 中使用sudo时请确保你信任该软件包。Windows 系统完全卸载 OpenClaw第一步使用内置卸载器在 PowerShell 中运行官方卸载命令这会停止服务并删除大部分组件openclaw uninstall --all --yes --non-interactive这会处理停止 Gateway 服务、卸载计划任务、删除状态和配置文件。第二步手动清理残留官方卸载器可能会遗漏一些文件需要手动清理1. 删除计划任务schtasks /Delete /F /TN OpenClaw Gateway2. 删除配置目录# 主配置目录 Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw # 旧版本遗留目录如果有 Remove-Item -Recurse -Force $env:USERPROFILE\.clawdbot 2$null Remove-Item -Recurse -Force $env:USERPROFILE\.moltbot 2$null Remove-Item -Recurse -Force $env:USERPROFILE\.molthub 2$null # AppData 目录 Remove-Item -Recurse -Force $env:APPDATA\openclaw 2$null Remove-Item -Recurse -Force $env:LOCALAPPDATA\openclaw 2$null3. 卸载 CLI 工具由于你是通过install.ps1脚本安装的CLI 是通过 npm 全局安装的npm rm -g openclaw如果你使用 pnpm 或 bun 安装的相应替换为powershellpnpm remove -g openclaw # 或 bun remove -g openclaw第三步验证完全卸载运行以下命令确认已完全删除powershell# 检查 CLI 是否还存在 where.exe openclaw # 应该返回 Could not find files # 检查计划任务是否还存在 schtasks /Query /TN OpenClaw Gateway 2$null # 应该返回错误 The system cannot find the file specified # 检查目录是否已删除 Test-Path $env:USERPROFILE\.openclaw # 应该返回 False # 检查进程是否还在运行 Get-Process | Where-Object { $_.ProcessName -match openclaw } # 应该没有输出清理环境变量如果你之前设置了自定义配置路径OPENCLAW_CONFIG_PATH也需要清理# 检查是否设置了自定义路径 echo $env:OPENCLAW_CONFIG_PATH # 如果设置了删除该目录并移除环境变量 [Environment]::SetEnvironmentVariable(OPENCLAW_CONFIG_PATH, $null, User)总结命令# 1. 官方卸载 openclaw uninstall --all --yes --non-interactive # 2. 删除计划任务 schtasks /Delete /F /TN OpenClaw Gateway 2$null # 3. 删除所有配置目录 Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw 2$null Remove-Item -Recurse -Force $env:USERPROFILE\.clawdbot 2$null Remove-Item -Recurse -Force $env:USERPROFILE\.moltbot 2$null Remove-Item -Recurse -Force $env:APPDATA\openclaw 2$null Remove-Item -Recurse -Force $env:LOCALAPPDATA\openclaw 2$null # 4. 卸载 CLI npm rm -g openclaw # 5. 验证 where.exe openclaw