JavaScriptNode.jsAI
OpenClaw 本地部署与飞书机器人接入教程
OpenClaw 是一款终端式 AI 助手。介绍如何在 macOS、Linux 和 Windows 环境下本地部署 OpenClaw，并接入飞书机器人。主要步骤包括安装 Node.js 和 Git 基础环境，使用官方脚本安装 OpenClaw，进行交互式配置，以及在飞书开放平台创建应用获取凭证完成接入。此外还包含环境变量设置、联调验证及常见问题排查方法。
OpenClaw 是一款终端式 AI 助手。介绍如何在 macOS、Linux 和 Windows 环境下本地部署 OpenClaw，并接入飞书机器人。主要步骤包括安装 Node.js 和 Git 基础环境，使用官方脚本安装 OpenClaw，进行交互式配置，以及在飞书开放平台创建应用获取凭证完成接入。此外还包含环境变量设置、联调验证及常见问题排查方法。
OpenClaw 是一款终端式 AI 助手，支持多模型适配、多渠道接入，既可本地部署，也支持云端一键安装。
本文聚焦'本地部署 + 飞书机器人接入'全流程，适配 macOS / Linux / Windows。
https://openclaw.ai/https://github.com/openclaw/（以官方仓库为准）OpenClaw 运行依赖 Node.js 24+ 和 Git。
npm 已包含在 Node.js 安装包中，无需单独安装。
注意：Windows 建议全程使用'管理员身份'运行 PowerShell。
https://nodejs.org/LTS v24+ 稳定版本Add to PATH# macOS: 先安装 Homebrew（如未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装 Node.js
brew install node
# 强制重建软链接（部分环境需要）
brew link node --overwrite --force
# 配置 npm 国内镜像（可选，用于加速下载）
npm config set registry https://registry.npmmirror.com/
https://git-scm.com/Add Git to PATH# macOS
brew install git
# Debian / Ubuntu
sudo apt install -y git
# CentOS / RHEL
sudo dnf install -y git
# 验证 Node.js
node -v
# 验证 npm
npm -v
# 验证 Git
git --version
可选：配置 Git 全局身份，避免后续提交报错。
# 设置全局用户名
git config --global user.name "你的用户名"
# 设置全局邮箱
git config --global user.email "你的邮箱"
# 官方安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash
# 全局安装 openclaw 命令
npm i -g openclaw
# 执行官方 PowerShell 安装脚本
iwr -useb https://openclaw.ai/install.ps1 | iex
说明：若 macOS/Linux 出现权限问题，可在命令前增加
sudo。
安装完成后会进入交互式配置流程。
建议先按'最小可用'原则完成初始化，后续再在 Web UI 或终端细化配置。
建议按以下顺序确认：
以下步骤与飞书开发者后台对应，你可以配合截图逐步说明。
在飞书开放平台创建'企业自建应用'，填写：
在应用左侧菜单选择'添加应用能力'，添加'机器人'能力。
进入'凭证与基础信息'，记录：
App IDApp Secret
这两个参数用于 OpenClaw 与飞书的鉴权，务必妥善保存。
进入'事件与回调'页面：
将 App ID 与 App Secret 写入 OpenClaw 配置（建议使用环境变量），然后重启服务。
# 飞书应用 ID（来自飞书开放平台）
export FEISHU_APP_ID="cli_xxxxxxxxxxxxx"
# 飞书应用 Secret（来自飞书开放平台）
export FEISHU_APP_SECRET="xxxxxxxxxxxxxxxx"
# OpenClaw 监听端口（按需调整）
export OPENCLAW_PORT="3000"
Windows PowerShell 可使用：
# 设置当前会话环境变量
$env:FEISHU_APP_ID="cli_xxxxxxxxxxxxx"
$env:FEISHU_APP_SECRET="xxxxxxxxxxxxxxxx"
$env:OPENCLAW_PORT="3000"
建议按以下链路验证：
@机器人 发送测试消息App ID / App Secret 是否有误这部分覆盖最常见的安装、运行、飞书接入问题，以及本地卸载回滚方法。
openclaw: command not found可能原因：
PATH排查步骤：
# 检查是否全局安装成功
npm list -g --depth=0 | grep openclaw
# 查看 npm 全局安装目录
npm root -g
npm config get prefix
若未安装成功，重新安装：
npm i -g openclaw
OpenClaw 依赖 Node.js 24+。先确认版本：
node -v
如果版本过低，升级 Node.js 后重试安装。
常见于 macOS/Linux 全局安装。可使用以下两种方式：
# 方式 A：临时提升权限
sudo npm i -g openclaw
# 方式 B：调整 npm 全局目录到用户目录（更推荐）
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm i -g openclaw
若使用 zsh，请把
.bashrc改为.zshrc。
优先检查：
常见原因：
App ID、App Secret 填写错误建议重新复制后再写入环境变量并重启服务。
检查端口占用并更换端口：
# macOS / Linux：查看 3000 端口占用
lsof -i :3000
# Windows PowerShell：查看 3000 端口占用
netstat -ano | findstr 3000
修改端口后重启服务。
可先切换 npm 镜像：
npm config set registry https://registry.npmmirror.com/
安装完成后如需恢复官方源：
npm config set registry https://registry.npmjs.org/
建议保留三类日志：
排查优先级建议：
# 卸载全局 openclaw
npm uninstall -g openclaw
校验是否卸载成功：
openclaw --version
# 如果提示 command not found，说明卸载完成
npm cache verify
# 如需强制清理：
npm cache clean --force
# 以下为示例路径，请按你的实际安装目录调整
rm -rf ~/.openclaw
rm -rf ~/.config/openclaw
Windows PowerShell 示例：
# 按实际目录删除
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
Remove-Item -Recurse -Force "$env:USERPROFILE\.config\openclaw"
注意：删除配置目录会清空本地配置与缓存，请先备份密钥和自定义配置。
若你暂时不再使用飞书接入，可在飞书开放平台执行：
App Secret（防止旧配置继续生效）如果只想恢复到'干净可重装'状态，建议执行：
openclaw到这里，你已经完成了：
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online