跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

OpenClaw 部署指南:集成 Minimax/DeepSeek 模型与飞书机器人

Linux 环境下 OpenClaw 的完整部署流程,涉及 Node.js 环境准备、核心程序安装及初始化交互配置。内容涵盖 Minimax 模型 OAuth 授权、DeepSeek 自定义端点接入,以及飞书企业内部应用的后台权限与事件回调设置。附带常见问题排查方案,协助开发者快速实现 AI 聊天机器人的本地化运行与渠道对接。

GRACE Grace发布于 2026/3/27更新于 2026/6/1119 浏览

OpenClaw 部署指南:集成 Minimax/DeepSeek 模型与飞书机器人

在 Linux 环境下快速搭建 OpenClaw,不仅能轻松接入 Minimax 和 DeepSeek 等主流大模型,还能通过飞书机器人实现即时通讯对接。本文梳理了从基础环境准备、核心程序安装到渠道配置的全流程,所有交互式选项均已验证,适合新手直接参考执行。

一、基础环境准备

1. 系统权限与环境检查

确保服务器拥有 root 或 sudo 权限,且能访问 GitHub、npm 及飞书官网。建议使用 Xshell 或 Putty 等远程工具连接。

2. 配置 Root 账户(可选但推荐)

为了方便后续操作,建议启用 Root 远程登录。修改密码后编辑 SSH 配置文件:

sudo passwd root
sudo vim /etc/ssh/sshd_config

在 sshd_config 中找到 PermitRootLogin,取消注释并改为 yes,保存退出后重启服务:

sudo systemctl restart sshd

3. 安装 Node.js(核心依赖)

OpenClaw 基于 Node.js 运行,建议版本 ≥20.x(推荐 22.x)。

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
node -v

若遇到 curl 连接失败,可尝试更换国内源或手动上传安装包。

4. 编译工具链

安装 CMake(≥3.19)及基础编译工具,避免后续依赖报错。

# 下载并安装 CMake 3.28.3
wget https://github.com/Kitware/CMake/releases/download/v3.28.3/cmake-3.28.3-linux-x86_64.sh
chmod +x cmake-3.28.3-linux-x86_64.sh
sudo ./cmake-3.28.3-linux-x86_64.sh --prefix=/usr/local --skip-license
export PATH=/usr/local/bin:$PATH

# 安装基础编译工具
sudo apt install -y make gcc g++ build-essential

5. 安装包管理工具

OpenClaw 使用 xpm 进行依赖管理:

npm install -g xpm
xpm -v

二、核心安装与初始化

1. 安装主程序

全局安装 OpenClaw 最新版本:

npm install -g openclaw@latest

若提示权限不足,请添加 sudo 前缀。

2. 交互式初始化

执行初始化命令后,会进入向导模式。以下是推荐的配置路径,按实际提示选择即可:

openclaw onboard --install-daemon
  • 协议确认:输入 Yes 确认个人使用协议。
  • 初始化模式:选择 QuickStart,后续可通过命令补充细节。
  • 模型提供商:暂时选 Skip for now,稍后单独配置。
  • 默认模型:保留当前默认值或按需调整。
  • 渠道配置:先选 Skip for now,飞书渠道将在后面单独处理。
  • 技能与钩子:建议跳过,保持初始简洁。
  • 启动方式:选择 Open the Web UI 打开管理界面。

3. 验证网关状态

openclaw gateway status

显示 running 或 active 即表示核心服务正常。

4. 本地访问 Web 管理界面

由于服务运行在服务器端,需通过 SSH 端口映射在本地浏览器访问。在 Windows 终端执行(替换 <服务器 IP> 为实际地址):

ssh -N -L 18789:127.0.0.1:18789 root@<服务器 IP>

首次连接提示确认指纹时输入 yes,输入密码后保持终端开启。随后在浏览器访问:

http://127.0.0.1:18789/#token=<your-token>

注意:Token 需在 openclaw gateway status 的返回信息中查找,每个安装实例随机生成。

三、模型配置(Minimax / DeepSeek)

执行 openclaw config 进入配置向导,选择 Model 模块进行设置。

1. Minimax 模型接入

支持 OAuth 授权或 API Key 方式。

  1. 选择 MiniMax 作为提供商。
  2. 授权方式推荐 MiniMax OAuth,终端会弹出链接,复制给已购买套餐的用户完成授权。
  3. 区域选择 CN(国内)。
  4. 模型选择:推荐 minimax2.5highspeed 高速模型,或保留默认。

提示:授权链接单次有效,若失败需重新获取。

2. DeepSeek 自定义端点

DeepSeek 兼容 OpenAI 接口,配置如下:

  1. 选择 Custom Provider。
  2. 基地址输入:https://api.deepseek.com/v1。
  3. 提供 API Key 方式选择 Paste API key now,粘贴官方密钥。
  4. 端点兼容性选 OpenAI-compatible。
  5. 模型 ID 根据需求填写:推理用 deepseek-reasoner,对话用 deepseek-chat。
  6. Endpoint ID 保持默认 custom-api-deepseek-com。

四、飞书(Feishu)渠道配置

1. 插件安装与入口

在配置界面选择 Channels -> Configure/link -> Feishu/Lark,然后下载官方插件:

# 自动下载 @openclaw/feishu 插件

2. 应用信息对接

前置准备:在飞书后台创建「企业内部应用」,获取 App ID 和 App Secret。

在命令行依次输入:

  • App ID 与 App Secret
  • 域名:选择 Feishu (feishu.cn)
  • 群聊策略:推荐 Open(响应所有群聊,需@机器人)
  • 私聊策略:推荐 Open(响应所有私聊)

3. 飞书后台补充配置

登录 飞书开放平台,完成以下关键步骤:

  1. 能力添加:在「应用能力」→「机器人」中添加机器人。
  2. 权限开通:在「权限管理」中搜索 im,勾选消息与群组相关的所有权限(约 55 项),以及「获取通讯录基本信息」。
  3. 事件订阅:在「事件与回调」中选择长连接,订阅「接收消息」事件。
  4. 发布应用:创建版本并提交审核,管理员通过后即可生效。

最后重启网关使配置生效:

openclaw gateway restart

五、常见问题排查

  • 权限拒绝:npm 安装时若遇 permission denied,加 sudo 重试。
  • Web 无法访问:检查防火墙是否放行 18789 端口(sudo ufw allow 18789)。
  • 机器人无响应:确认飞书应用权限是否完整,事件订阅是否包含「接收消息」。
  • 模型调用失败:核对 API Key 有效性及模型 ID 拼写,重启网关刷新配置。

建议:生产环境务必限制 Web 界面访问 IP,敏感信息如 API Key 需妥善保管。

目录

  1. OpenClaw 部署指南:集成 Minimax/DeepSeek 模型与飞书机器人
  2. 一、基础环境准备
  3. 1. 系统权限与环境检查
  4. 2. 配置 Root 账户(可选但推荐)
  5. 3. 安装 Node.js(核心依赖)
  6. 4. 编译工具链
  7. 下载并安装 CMake 3.28.3
  8. 安装基础编译工具
  9. 5. 安装包管理工具
  10. 二、核心安装与初始化
  11. 1. 安装主程序
  12. 2. 交互式初始化
  13. 3. 验证网关状态
  14. 4. 本地访问 Web 管理界面
  15. 三、模型配置(Minimax / DeepSeek)
  16. 1. Minimax 模型接入
  17. 2. DeepSeek 自定义端点
  18. 四、飞书(Feishu)渠道配置
  19. 1. 插件安装与入口
  20. 自动下载 @openclaw/feishu 插件
  21. 2. 应用信息对接
  22. 3. 飞书后台补充配置
  23. 五、常见问题排查
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • Spring Boot 读取 Resource 目录文件的五种常见方式
  • C++ 与 Qt 开发环境搭建及 Windows 快捷键指南
  • Apache IoTDB 高性能存储引擎与工业级架构解析
  • 本地文件上传至服务器的常用方法与工具
  • 复杂 SQL 性能突围:代价驱动的连接条件下推策略与工程实践
  • Apache IoTDB 部署实践:AINode 独立运行与 Kubernetes 集群性能调优
  • C++ string 类核心成员函数与全局函数实战
  • MySQL 权限撤销(REVOKE)机制与语法安全实践
  • AMD显卡加速Whisper语音识别:从环境配置到性能优化实战
  • AI 产品经理核心职责、能力模型与转型指南
  • OpenClaw 本地 AI 助手钉钉集成部署指南
  • C++ 多态的概念、实现与原理详解
  • Android 判断权限是否开启的方法
  • C++动态库加载瓶颈分析与优化
  • tkinter-helper:Python GUI 可视化拖拽设计工具
  • Axios 错误处理进阶封装:实现网络层数据与状态解耦
  • 链表核心算法实战:从基础操作到复杂结构
  • 快速幂算法详解:高效计算 x 的 n 次幂
  • 基于 DeepSeek V3.2 与 Go 语言构建智能日志分析系统
  • Python 中 == 与 is 的区别及最佳实践

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online