1.OpenClaw简介

OpenClaw是一个AI智能体平台，可以将AI大模型接入各种聊天渠道（飞书、钉钉、QQ、Discord、Telegram等）中交互，并且让AI有操作所在系统的能力。

Openclaw官网：https://openclaw.ai
github地址：https://github.com/openclaw/openclaw
ClawHub技能商店：https://clawhub.ai

2.安装步骤

2.1.安装node

OpenClaw的运行环境基于node，要求node版本>=22，此处以node 24版本为例。

如安装过低版本node，需要先卸载

yum remove nodejs npm -y

下载26版本的yum源

curl -fsSL https://rpm.nodesource.com/setup_24.x | sudo bash -

安装node

yum install -y nodejs

检查已安装的版本

node -v
npm -v

会显示node版本：v24.14.0和npm版本：11.9.0

2.1.5.指定国内yum源

将yum源指定为国内源可以提升npm包下载安装速度，官方源下载极慢甚至无法下载。

npm config set registry https://registry.npmmirror.com

2.2.安装git

安装OpenClaw依赖git，OpenClaw运行时的许多操作也需要用到git工具。

yum install git -y

检查git版本

git -v

2.3.安装OpenClaw

2.3.1.官方脚本安装（推荐）

curl -fsSL https://openclaw.ai/install.sh | bash

或者也可以用npm安装

npm install -g openclaw@latest

2.3.2.新手引导并安装gateway服务

OpenClaw的功能都依赖gateway服务。安装后，gateway会注册到系统服务，以后台进程运行。

openclaw onboard --install-daemon

执行后会进入新手引导。

I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?

选Yes

Onboarding mode

选QuickStart进入快速设置

Model/auth provider

选择对应的模型厂商进行模型配置

How do you want to provide this API key?

Paste API key now 直接粘贴秘钥

Enter xxx API key

粘贴秘钥

Default model

如果当前默认模型不想用，可以选Enter model manually指定模型
回车后指定模型id

Select channel (QuickStart)

如果是接入飞书，可以选择Skip for now稍后再选，飞书官方有新版插件

Search provider

都是收费选项，跳过 Skip for now

Configure skills now?

配置技能，选Yes

Install missing skill dependencies

安装几个基础的技能（按空格选中）：
clawhub（技能商店）
github
mcporter（MCP管理器，发现、安装、更新和卸载各种MCP）
nano-pdf（读取分析PDF结构和文本）
video-frames（视频片段或帧截取）

Show Homebrew install command?

显示Homebrew安装命令，选Yes

Preferred node manager for skill installs

安装技能的工具，选npm

Set GOOGLE_PLACES_API_KEY for goplaces?
Set GEMINI_API_KEY for nano-banana-pro?
Set NOTION_API_KEY for notion?
Set OPENAI_API_KEY for openai-image-gen?
Set OPENAI_API_KEY for openai-whisper-api?
Set ELEVENLABS_API_KEY for sag?

基本都要科学上网，全选No

Enable hooks?

可以把command-logger勾上（记录OpenClaw 执行的所有命令事件记录到一个集中的审计日志文件中），其他后续按需配置。

How do you want to hatch your bot?

选Hatch in TUI，命令行方式交互最方便，web还需要开端口。

2.4.进入命令行

openclaw tui

如果大模型配置没有问题，在tui中就可以跟龙虾互动了。

2.5.配置渠道

以飞书为例

2.5.1.安装飞书官方插件

官方教程链接：https://bytedance.larkoffice.com/docx/MFK7dDFLFoVlOGxWCv5cTXKmnMh

如果在tui命令行，按两次ctrl+c退出命令行后执行。

npx -y @larksuite/openclaw-lark install

安装完成后，会显示一个二维码，用飞书扫码，创建机器人。
如果超时了，可以到飞书开放平台获取APP ID和secret，手动输入到openclaw进行绑定。

2.5.2.配对

跟飞书机器人对话时，如果显示以下内容，则需要配对

OpenClaw: access not configured.
ou_ba97068d...
Pairing code: 834YXXXX
Ask the bot owner to approve with:
openclaw pairing approve feishu 834YXXXX

在服务器上执行配对命令（注意不要在tui中执行）

openclaw pairing approve feishu 834YXXXX

配对完成后，就能跟机器人对话了。

2.5.3.授权

给机器人发送用户授权命令，便于后续 OpenClaw 通过你的身份完成消息、文档、多维表格、日历等任务。

/feishu auth

执行后会出现弹窗，点击按钮授权。

2.5.4.学习飞书技能

为了让 OpenClaw 能学会这些新技能并正确使用，在飞书对话中发送：

学习一下我安装的新飞书插件，列出有哪些能力

2.5.5.验证是否安装成功

/feishu start

出现飞书 OpenClaw 插件已启动 v2026.3.17表示安装成功。

2.5.6.升级飞书插件版本

服务器执行

npx -y @larksuite/openclaw-lark update

重启gateway

openclaw gateway restart

2.5.7.切换到流式输出

默认情况下，跟机器人交互，每次都要等待机器人做完所有操作才会返回消息，很难区分是openclaw挂了还是仍在执行。切到流式输出，可以分批次流式返回消息，体验更好。

开启流式输出

openclaw config set channels.feishu.streaming true

流式输出卡片上支持显示更多内容

openclaw config set channels.feishu.footer.elapsed true  # 开启耗时
openclaw config set channels.feishu.footer.status true  # 开启状态展示

设置多任务并行及独立上下文
机器人可在话题群/消息群话题模式中，针对每个话题拥有独立上下文以及多任务并行。

openclaw config set channels.feishu.threadSession true

修改飞书机器人在群内的回复方式
目前插件支持的默认方式是机器人被拉进群后，只有 at 机器人时才可回复。
模式1：在群内机器人仅响应应用所有者（主人）@机器人的消息，不响应其他人发给机器人的消息（已作为3.17及以上版本安装时的默认策略，推荐配置）
配置方法
修改openclaw.json配置文件，如果是root用户安装，路径一般在/root/.openclaw/。

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_你的AppID",
      "appSecret": "你的AppSecret",
      "requireMention": true
      "groupPolicy": "allowlist",
      "groupAllowFrom": ["ou_XXXX"]，
      "groups": { "*": { enabled: true } }
    }
  }
}

将 groupPolicy 设置为 "allowlist"（白名单），并通过 groupAllowFrom 指定允许触发机器人的用户，配置你本人openid 信息。你可以直接咨询小龙虾你的openid。
再在 groups 中设置 requireMention: true，要求消息必须 @ 到机器人后才会回复。

重启生效

openclaw gateway restart

模式2：只有 @机器人才回复，可响应群内任何人发送的消息
配置方法

# 设置需要 @ 才回复
openclaw config set channels.feishu.requireMention true --json
# 重启生效
openclaw gateway restart

完整配置

{"channels": {"feishu": {"enabled": true,"appId": "cli_你的AppID","appSecret": "你的AppSecret","requireMention": true,"groupPolicy": "open"}}}

模式3：不用 @，所有消息都回复
⚠️ 注意：这个模式在大群里容易刷屏，谨慎使用！
需要额外在开发者后台申请应用身份权限：获取群组中所有消息（敏感权限）im:message.group_msg。
配置方法

# 设置不需要 @ 也回复
openclaw config set channels.feishu.requireMention false --json
# 重启生效
openclaw gateway restart