一、安装核心依赖
OpenClaw运行依赖于Node.js且版本必须大于v22.0.0
# 1. 安装Node.js 22.x(官方推荐稳定版)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
# 2. 验证Node.js版本(需≥v22.0.0)
node --version
npm --version
# 3. 安装OpenClaw 2026最新版(全局安装,支持命令行调用)
npm install -g openclaw@latest
# 4. 验证OpenClaw安装(显示版本号即为成功)
openclaw --version
可能出现的错误:
1.Node.js安装失败:若提示"curl: (7) Failed to connect to deb.nodesource.com port 443",切换手机热点或配置国内镜像后重试;
2.旧版本冲突 :若已安装低版本Node.js,先执行sudo apt remove nodejs npm卸载,再重新安装。
二、初始化配置
# 启动初始化向导(--install-daemon自动安装系统服务,支持开机自启)
openclaw onboard --install-daemon
选择YES

选择初始化模式:选择QuickStart

选择模型提供商:这边我选择Customer Provider(根据自己需求选择模型)

选择通讯渠道(这边直接skip for now,获取可以通过openclaw channels add来添加)

配置技能选择YES

安装技能依赖(输入Skip for new,后续按需安装具体技能)

配置第三方API密钥(后续所有API密钥配置(如GOOGLE_PLACES_API_KEY、NOTION_API_KEY等),均输入No(暂时用不到,避免配置错误)

启用Hooks(钩子功能):选择session-memory(保存会话上下文,关闭终端后仍能延续话题,核心功能);

选择孵化方式(选Hatch in TUI,终端UI模式,快速测试功能):

ok啦!
访问链接
三、对接飞书
3.1 创建飞书应用
1.访问飞书开放平台(国际版用Lark)
2.点击企业自建应用
3.填写应用名称、描述、上传图标
3.2 获取凭证
在应用的凭证与基础信息页面,复制:
App ID 与App Secret
3.3 配置权限
在权限管理页面,需要导入一下权限

3.4 启用机器人
在 应用能力 中启用 Bot(机器人) 功能。
3.5 配置事件订阅
- 进入 事件与回调 页面
- 订阅方式选择 「使用长连接接收事件」(推荐!无需公网 URL)
- 添加事件:
im.message.receive_v1(接收消息 v2.0)
这一步可能在配置长连接接受事件可能会报错,没事,因为下面的openclaw飞书插件还没有配置。
3.6 配置OpenClaw
openclaw config

选择Local

选择Channels -> Configure/link

选择飞书

然后下载等待....
然后填写飞书的APP Secret 和 APP ID

接着就选择 Group Chat Policy为Open

然后选择Finished就可以了,接着就回到3.5事件订阅就配置好了,然后发布机器人,成功!!!