跳到主要内容
极客日志极客日志
首页博客AI提示词GitHub精选代理工具
搜索
|注册
博客列表
Shell / BashNode.jsAI大前端

OpenClaw 部署指南:接入 Minimax/DeepSeek 与飞书机器人

OpenClaw 部署涉及环境准备、核心安装及多渠道配置。本文详细记录了在 Linux 系统下安装 Node.js、CMake 等依赖的步骤,并通过交互式命令完成 OpenClaw 初始化。重点涵盖了 Minimax 的 OAuth 授权流程、DeepSeek 的自定义端点配置方法,以及飞书企业应用的权限开通与回调设置。文中修正了常见命令格式错误,提供了端口映射访问 Web 界面的具体方案,并针对权限、网络及模型调用失败等常见问题给出了解决思路,适合新手快速上手部署 AI 机器人。

ApiHolic发布于 2026/3/21更新于 2026/4/251 浏览

OpenClaw 部署指南:接入 Minimax/DeepSeek 与飞书机器人

本文档梳理了 OpenClaw 在 Linux 系统(Debian/Ubuntu 系列)上的完整部署流程,涵盖环境准备、核心安装、模型配置及飞书渠道对接。所有步骤均经过验证,可直接复制执行。

一、基础环境准备

1. 权限与环境检查

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

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

为了方便远程操作,建议启用 Root 登录。修改密码并调整 SSH 配置:

# 修改 root 密码
sudo passwd root

# 编辑 SSH 配置文件
sudo vim /etc/ssh/sshd_config

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

sudo systemctl restart sshd

3. 安装 Node.js

OpenClaw 依赖 Node.js,建议版本 ≥20.x(推荐 22.x)。

# 添加 NodeSource 官方源
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 安装 Node.js
sudo apt-get install -y nodejs

# 验证版本
node -v

*提示:若 curl 命令失败,可尝试更换国内源或手动上传安装包。

4. 安装编译工具与 CMake

OpenClaw 需要 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

# 验证 CMake 版本
cmake --version

若提示找不到 cmake,请临时设置环境变量:export PATH=/usr/local/bin:$PATH。

接着安装基础编译工具:

sudo apt install -y make gcc g++ build-essential

5. 安装 xpm

这是 OpenClaw 专用的依赖管理工具。

npm install -g xpm
xpm -v

二、OpenClaw 核心安装与初始化

1. 安装主程序

npm install -g openclaw@latest

如遇权限不足,请在命令前加 sudo。

2. 交互式初始化

运行以下命令启动向导,按提示选择即可:

openclaw onboard --install-daemon

关键选项指引:

  • 协议确认:选择 Yes。
  • 初始化模式:选 QuickStart,后续可通过命令补充细节。
  • 模型提供商:暂时选 Skip for now,稍后单独配置。
  • 默认模型:保留 Keep current 或按需修改。
  • 渠道配置:选 Skip for now,飞书渠道将在后面单独处理。
  • 技能与钩子:建议先选 No 或 Skip,保持初始简洁。
  • 启动方式:选 Open the Web UI 打开管理界面。

3. 验证网关状态

openclaw gateway status

若无红色报错且显示 running 或 active,说明核心服务正常。

4. 访问 Web 管理界面

由于 OpenClaw 默认绑定本地端口,Windows 用户需通过 SSH 端口映射访问。

  1. 在 Windows 终端执行(替换为你的服务器 IP):

    ssh -N -L 18789:127.0.0.1:18789 [email protected]
    

    *首次连接输入 yes 确认指纹,随后输入密码。终端无响应属正常现象,请勿关闭。

  2. 浏览器访问地址:

    http://127.0.0.1:18789/#token=YOUR_TOKEN
    

    *注意:Token 是随机生成的,需在 openclaw gateway status 的输出中查找,不可直接复制示例中的值。

三、模型配置(Minimax / DeepSeek)

执行 openclaw config 进入配置界面。

1. 基础设置

  • 网关位置:选 local。
  • 配置模块:选 Model。

2. Minimax 配置

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

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

3. 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 即可。
  7. 别名:可选填 deepseek 方便识别。

*安全提醒:API Key 属于敏感信息,切勿泄露。

四、飞书(Feishu)渠道配置

1. 进入配置界面

再次运行 openclaw config,依次选择:

  • 模块:Channels
  • 操作:Configure/link
  • 类型:Feishu/Lark

2. 安装插件

选择 Download from npm (@openclaw/feishu),等待约 1-2 分钟下载完成。

3. 对接应用信息

先在飞书后台创建「企业内部应用」并获取 App ID 和 Secret。

  1. App ID & Secret:粘贴对应值。
  2. 域名:选 Feishu (feishu.cn) - China。
  3. 群聊策略:推荐 Open(所有群聊响应)或 Allowlist(指定群聊)。
  4. 私聊策略:推荐 Open(响应所有私聊)。

4. 飞书后台补充配置

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

  1. 添加能力:在「应用能力」→「机器人」中添加机器人。
  2. 配置权限:在「权限管理」中搜索 im,勾选消息与群组相关的所有权限;同时勾选「获取通讯录基本信息」。
  3. 事件订阅:在「事件与回调」中选择「长连接」,订阅「接收消息」事件。
  4. 发布应用:创建版本并申请发布,等待管理员审核。

5. 生效配置

配置完成后重启网关:

openclaw gateway restart

审核通过后,机器人即可正常收发消息。

五、常见问题排查

  • 权限拒绝:安装时加 sudo,如 sudo npm install -g openclaw@latest。
  • Web 无法访问:检查防火墙是否开放 18789 端口(sudo ufw allow 18789)。
  • 飞书不响应:确认权限是否全开、事件订阅是否正确,并重启网关。
  • 模型调用失败:核对 API Key 有效性及模型 ID 拼写。

六、注意事项

  • 本指南基于 Debian/Ubuntu 编写,CentOS 等系统需调整包管理器命令。
  • 生产环境建议限制 Web 界面访问 IP,避免安全风险。
  • 敏感信息(API Key、Secret)泄露需立即更换。
  • 若遇版本兼容问题,可尝试指定版本安装,如 npm install -g [email protected]。
  • 网络受限环境下,需配置代理或手动上传依赖包。

目录

  1. OpenClaw 部署指南:接入 Minimax/DeepSeek 与飞书机器人
  2. 一、基础环境准备
  3. 1. 权限与环境检查
  4. 2. 配置 Root 账户(可选但推荐)
  5. 修改 root 密码
  6. 编辑 SSH 配置文件
  7. 3. 安装 Node.js
  8. 添加 NodeSource 官方源
  9. 安装 Node.js
  10. 验证版本
  11. 4. 安装编译工具与 CMake
  12. 下载 CMake 3.28.3 脚本
  13. 赋予执行权限并安装
  14. 验证 CMake 版本
  15. 5. 安装 xpm
  16. 二、OpenClaw 核心安装与初始化
  17. 1. 安装主程序
  18. 2. 交互式初始化
  19. 3. 验证网关状态
  20. 4. 访问 Web 管理界面
  21. 三、模型配置(Minimax / DeepSeek)
  22. 1. 基础设置
  23. 2. Minimax 配置
  24. 3. DeepSeek 配置
  25. 四、飞书(Feishu)渠道配置
  26. 1. 进入配置界面
  27. 2. 安装插件
  28. 3. 对接应用信息
  29. 4. 飞书后台补充配置
  30. 5. 生效配置
  31. 五、常见问题排查
  32. 六、注意事项
  • 💰 8折买阿里云服务器限时8折了解详情
  • 💰 8折买阿里云服务器限时8折购买
  • 🦞 5分钟部署阿里云小龙虾了解详情
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • C++ 实现红黑树:深入 STL map 底层原理
  • OpenClaw 30+ 真实场景实战拆解与架构思考
  • Java 入门实战:从环境配置到 Hello World
  • OpenClaw 本地部署指南:隧道配置与百炼模型接入
  • GitLab 个人访问令牌(Token)获取方法
  • C++ Boost 搜索引擎:正倒排索引核心实现与详解
  • 国内环境升级 GitHub Copilot 专业版支付方案
  • PX4 与 ROS 集成:Offboard 模式解析及轨迹跟踪实战
  • C++ 二叉搜索树(BST)详解与实现
  • 二分查找实战:山峰数组的峰顶索引与寻找峰值
  • Hashcat 实战指南:从安装到高级密码恢复技巧
  • C++ 搜索引擎通用工具模块:文件读取与中文分词实现
  • Java 开发中 TIME_WAIT 状态过多的原因与应对策略
  • FastbuildAI:一款开源 AI 应用快速构建与商业化闭环工具
  • 计算机视觉基础与实战应用指南
  • Visual Studio 使用 GitHub Copilot 与 IntelliCode 辅助编码
  • Spring AI 实战:基于 SSE 构建 MCP Server 与 Client
  • C++ STL 容器详解:map 与 set 原理及实战
  • 基于 Java 的无人化台球棋牌茶室系统架构设计
  • 深度评测 GLM-5:代码生成实战体验

相关免费在线工具

  • RSA密钥对生成器

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

  • Mermaid 预览与可视化编辑

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

  • 随机西班牙地址生成器

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

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online