环境：
node.js >= v22.0

一、安装或配置 node

# 下载并安装 Node.js 24 版本
nvm install 24

# 验证 Node.js 版本
node -v # 应输出 v24.x.x 或更高版本（确保 ≥22）

# 选择 24版本
nvm use v24.x.x

# 验证 npm 版本
npm -v # 应输出相应版本号

二、使用 npm 安装 openclaw

npm i -g openclaw

三、 验证版本

openclaw --version

四、 初始化 openclaw 配置

openclaw onboard
  1. 使用键盘方向键选择Yes同意风险说明
    选yes
  2. 选择安装方式，这里我们选择“QuicStart”快速入门
    在这里插入图片描述
  3. 选择已有的配置
    在这里插入图片描述
  4. 选择 AI 模型，可以选择跳过或者选择 MiniMax
    在这里插入图片描述
  5. 如果选择了模型后，可以直接黏贴 API key （前提是已申请对应模型的 API key）
    在这里插入图片描述
  6. 保持选择模型
    在这里插入图片描述
  7. 选择聊天工具，待会会配置飞书聊天工具，所以这里先选择"Skip for now"跳过
    在这里插入图片描述
  8. 选择技能，这也先不选择，选 No
    在这里插入图片描述
  9. 是否启用钩子（hooks），建议是将这三个全部打开，通过空格键勾选，回车键确定
    在这里插入图片描述
    静待启动
    在这里插入图片描述
  10. 选择 Open the Web UI，如果能看到 UI 界面，证明部署成功
    在这里插入图片描述
  11. 查看已配置的模型
# 查看openclaw配置的模型
openclaw models list

五、配置飞书

OpenClaw支持多种平台接入，这也是它的一大亮点——无需专用客户端，通过现有聊天工具就能操作。国内用户用飞书比较多，所以本文以飞书为例进行说明。

5.1 获取飞书应用凭证
首先需要在飞书开放平台创建应用并获取必要的凭证：

  1. 访问飞书开放平台-开发者后台：https://open.feishu.cn/app
  2. 创建企业自建应用
    在这里插入图片描述
    在这里插入图片描述
  3. 添加机器人应用能力
    在这里插入图片描述
  4. 发布版本
    在这里插入图片描述

在这里插入图片描述

  1. 获取 App ID 和 App Secret
    在这里插入图片描述

六、安装 openclaw 飞书插件

  1. 在 C:\Users<用户名>.openclaw 路径下执行：
npm config set registry https://registry.npmmirror.com  // 先设置国内镜像
npm cache clean --force
npm install @m1heng-clawd/feishu --verbose   // 显示下载详细， 主要此包安装比较困难

// 确认安装成功
npm list @m1heng-clawd/feishu
ls node_modules/@m1heng-clawd/feishu
  1. 然后将安装好的包复制到 OpenClaw 的扩展目录：
// 创建扩展目录并复制文件
C:\Users\Venn\.openclaw> mkdir extensions
C:\Users\Venn\.openclaw> mkdir extensions\feishu
C:\Users\Venn\.openclaw> xcopy /E /Y "node_modules\@m1heng-clawd\feishu\*" "extensions\feishu\"


// 安装依赖
PS C:\Users\Venn\.openclaw> cd extensions\feishu
PS C:\Users\Venn\.openclaw\extensions\feishu> npm install --prod  // 很重要一步，不换源也很慢或者失败
  1. 完成后重启 OpenClaw 服务：
openclaw gateway restart
  1. 还原 node js 国内镜像：（可选）
npm config set registry https://registry.npmjs.org/  // 还原官方镜像源
npm config get registry

七、设置 openclaw 里的飞书配置

方式一：使用shell命令配置（快速配置）
修改脚本中的AppId和AppSecret后直接执行以下命令

openclaw config set channels.feishu.appId "这里填AppId" && openclaw config set channels.feishu.appSecret "这里填AppSecret" && openclaw config set channels.feishu.enabled true && openclaw config set channels.feishu.domain "feishu" && openclaw config set channels.feishu.groupPolicy "disabled"

方式二：通过配置界面按步骤配置

openclaw channels add

  1. 添加渠道配置
    在这里插入图片描述

  2. 选择飞书
    在这里插入图片描述

  3. 按照提示，输入飞书的 App Id 和 App Secret
    在这里插入图片描述

  4. 选择国内飞书
    在这里插入图片描述

  5. 选择响应策略，这边根据具体场景选择，我就先选择Disabled
    在这里插入图片描述

  6. 结束渠道配置
    在这里插入图片描述

  7. 访问策略选择"No"
    在这里插入图片描述

  8. 添加显示名称可选配置我们也选择"No"
    在这里插入图片描述

八、配置飞书权限事件

  1. 配置事件与回调
    在这里插入图片描述
    在这里插入图片描述
  2. 添加事件
    在这里插入图片描述
    在这里插入图片描述
  3. 配置回调
    在这里插入图片描述
    在这里插入图片描述
  4. 配置权限
    在这里插入图片描述
{
  "scopes": {
    "tenant": [
      "contact:user.base:readonly",
      "im:chat",
      "im:chat:read",
      "im:chat:update",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": []
  }
}

在这里插入图片描述
在这里插入图片描述
5. 更新版本号
在这里插入图片描述
在这里插入图片描述

九、启动 openclaw 验证结果

# 可以手动启动（前台模式）
openclaw gateway --port 18789 --verbose

打开飞书电脑客户端或手机客户端，通过搜索刚刚创建的机器人应用，对话验证是否接入成功。
在这里插入图片描述
第一次对话可能会出现权限不足，按照提示输入命令：

openclaw pairing approve feishu XXXXX

在这里插入图片描述

十、 配置为系统服务

为了方便后续启动关闭openclaw，建议是将 openclaw 配置成系统服务，通过systemctl来进行启动关闭操作

# 创建 systemd 服务文件
cat > /etc/systemd/system/openclaw-gateway.service << 'EOF'
[Unit]
Description=OpenClaw Gateway Service
After=network.target

[Service]
Type=simple
User=root
Environment="PATH=/root/.nvm/versions/node/v24.13.0/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin"
Environment="NODE_PATH=/root/.nvm/versions/node/v24.13.0/lib/node_modules"
WorkingDirectory=/root
ExecStart=/root/.nvm/versions/node/v24.13.0/bin/node /root/.nvm/versions/node/v24.13.0/lib/node_modules/openclaw/openclaw.mjs gateway run
Restart=on-failure
RestartSec=10
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target
EOF

# 重新加载 systemd 配置
systemctl daemon-reload

# 启动服务
systemctl start openclaw-gateway

# 查看服务状态
systemctl status openclaw-gateway

# 设置开机自启
systemctl enable openclaw-gateway

总结

经过完整的部署流程后，您应已成功搭建自己的OpenClaw环境。以下是对已完成工作的总结：

  1. ✅ Node.js环境安装：通过nvm管理Node.js版本，确保版本>=22
  2. ✅ 前置依赖准备：安装必要的编译工具，避免后续安装出错
  3. ✅ OpenClaw核心安装：选择官方脚本或npm方式，根据网络环境灵活选择
  4. ✅ 初始化配置：通过配置向导完成基础设置，重点启用三个实用钩子
  5. ✅ 飞书渠道集成：在飞书开放平台创建应用，安装插件并配置通道
  6. ✅ MiniMax模型配置：切换至性价比高的国内大模型，中文支持更好
  7. ✅ 服务验证与启动：通过官方命令验证配置，启动Gateway服务

相比传统的云端AI助手，OpenClaw具备以下明显优势：

  • 数据隐私：所有数据都在你的设备上，不经过任何第三方服务器
  • 执行能力：不仅能回答问题，更能实际操作文件、命令行、浏览器等
  • 扩展灵活：通过ClawdHub有100+社区开发的技能模块可用
  • 接入方便：支持飞书、钉钉等常用工具，无需安装专用客户端

现在即可让AI助手开始实际工作！

官方文档：https://openclaw.ai/

# node.js # git # AI
Logo
AI Agent技术社区

Agent 垂直技术社区，欢迎活跃、内容共建。

更多推荐

如何卸载openclaw

OpenClaw（俗称"龙虾"）是一个本地 AI 智能体平台，用于在电脑上部署自主运行的 AI 代理。

avatar AI Agent技术社区

（已解决）安装openclaw龙虾[特殊字符]npm权限问题EACCES

先安装升级完成node和homebrew后。安装就很快了。但是遇到EACCESS问题！！！发现报错了。问题错误：核心问题是sharp解决（90%人遇到的）安装 macOS 编译工具很多人缺少，导致sharp无法编译。运行：xcode-select --install安装完成后重新执行：sharp编译需要 C++ 编译器和 node-gyp，这些都来自 Xcode CLI。

avatar AI Agent技术社区
cover

【工具类】kali linux 安装 OpenClaw + 配置大模型 + 接入飞书 + 提示词注入实验

avatar AI Agent技术社区