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

OpenClaw 安装配置指南:Minimax/DeepSeek 模型及飞书机器人接入

档介绍在 Linux 系统(Debian/Ubuntu)上部署 OpenClaw 的全过程。内容包括基础环境准备(Node.js、CMake)、核心程序安装与初始化、Minimax 与 DeepSeek 模型配置,以及飞书渠道对接步骤。提供详细的命令行操作指引、交互式配置选项说明及常见问题排查方法,适用于企业级飞书机器人对接及多模型接入场景。

AiEngineer发布于 2026/4/6更新于 2026/5/2030 浏览

OpenClaw 安装与配置指南

本文档适用于 Linux 系统(Debian/Ubuntu 系列),详细梳理 OpenClaw 从基础环境准备、核心程序安装,到模型配置(Minimax/DeepSeek)、飞书渠道对接的全流程。

环境要求

  1. 服务器需联网,确保能访问 GitHub、npm、飞书官网;
  2. 操作全程使用终端命令行,建议使用 SSH 客户端连接服务器;
  3. 复制命令时需完整复制,避免遗漏特殊符号;
  4. 拥有 root 用户或 sudo 权限。

一、基础环境准备

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

执行以下命令修改 Root 密码及远程登录权限:

# 1. 修改 root 密码(执行后按提示输入两次新密码)
sudo passwd root

# 2. 修改 root 远程登录配置文件
sudo vim /etc/ssh/sshd_config

配置文件编辑步骤:

  • 打开文件后,按 i 键进入编辑模式;
  • 找到 PermitRootLogin 行(若被注释,先删除前面的 #),修改为 PermitRootLogin yes;
  • 按 Esc 键退出编辑模式,输入 :wq 并回车,保存并退出 vim;
  • 重启 sshd 服务,使配置生效:
sudo systemctl restart sshd

1.2 安装 Node.js(OpenClaw 核心依赖,需 ≥20.x,推荐 22.x)

# 1. 添加 NodeSource 官方源(22.x 稳定版本)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

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

# 3. 验证 Node.js 版本(确认版本 ≥20.x)
node -v

注意:若执行 curl 命令提示连接失败,可尝试更换国内源或手动下载安装包上传至服务器。

1.3 安装 CMake(编译依赖,版本 ≥3.19 可跳过此步骤)

# 1. 下载 CMake 3.28.3 官方安装脚本(Linux x86_64 架构)
wget https://github.com/Kitware/CMake/releases/download/v3.28.3/cmake-3.28.3-linux-x86_64.sh

# 2. 给安装脚本添加执行权限
chmod +x cmake-3.28.3-linux-x86_64.sh

# 3. 安装到 /usr/local/bin 目录(跳过许可证确认)
sudo ./cmake-3.28.3-linux-x86_64.sh --prefix=/usr/local --skip-license

# 4. 验证 CMake 版本(确认版本 ≥3.19)
cmake --version

注意:1. 若 wget 下载失败,可手动从 GitHub 下载安装包,上传至服务器后执行后续命令;2. 安装完成后,若提示'cmake: command not found',需配置环境变量,执行 export PATH=/usr/local/bin:$PATH。

1.4 安装基础编译工具

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

该命令会安装编译 OpenClaw 所需的所有基础工具,确保后续安装无依赖报错。

1.5 安装 xpm(OpenClaw 专用依赖管理工具)

npm install -g xpm

安装完成后,可执行 xpm -v 验证是否安装成功。

二、OpenClaw 核心安装与初始化

2.1 安装 OpenClaw 主程序(最新版本)

npm install -g openclaw@latest

安装过程中若提示权限不足,可在命令前添加 sudo(即 sudo npm install -g openclaw@latest)。

2.2 初始化 OpenClaw(交互式配置)

openclaw onboard --install-daemon

执行命令后,进入交互式配置界面,按以下指引选择选项:

  1. 确认个人使用协议
    • 提示内容:I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
    • 可选选项:● Yes / ○ No
    • 选择:● Yes(回车确认)
  2. 选择初始化模式
    • 提示内容:Onboarding mode
    • 可选选项:
      • ● QuickStart (Configure details later via openclaw configure.)
      • ○ Manual
    • 选择:● QuickStart(快速初始化,后续可通过命令补充配置,回车确认)
  3. 选择模型/授权提供商
    • 提示内容:Model/auth provider
    • 可选选项:(上方为各类模型提供商,最下方为跳过选项)
      • ○ Anthropic
      • ○ OpenAI
      • ○ MiniMax
      • …(其他提供商)
      • ● Skip for now
    • 选择:● Skip for now(暂时跳过,后续通过 config 命令配置模型,回车确认)
  4. 筛选模型提供商
    • 提示内容:Filter models by provider
    • 可选选项:● All providers / ○ 其他具体提供商
    • 选择:● All providers(显示所有提供商的模型,回车确认)
  5. 选择默认模型
    • 提示内容:Default model
    • 可选选项:● Keep current (default: anthropic/claude-opus-4-6) / ○ 其他模型
    • 选择:● Keep current(保留默认模型,后续可修改,回车确认)
  6. 选择渠道(QuickStart 模式)
    • 提示内容:Select channel (QuickStart)
    • 可选选项:
      • ○ Feishu/Lark (飞书)
      • ○ WeChat (微信)
      • …(其他渠道)
      • ● Skip for now (You can add channels later via openclaw channels add)
    • 选择:● Skip for now(暂时跳过渠道配置,后续补充,回车确认)
  7. 是否配置技能(推荐后续配置)
    • 提示内容:Configure skills now? (recommended)
    • 可选选项:● Yes / ○ No
    • 选择:○ No(暂时不配置,回车确认)
  8. 是否启用钩子(Hooks)
    • 提示内容:Enable hooks?
    • 可选选项:◻ Skip for now / ○ 其他钩子选项
    • 操作:按空格键勾选 ◻ Skip for now,变为 ☑ Skip for now 后,回车确认
  9. 选择机器人启动方式
    • 提示内容:How do you want to hatch your bot?
    • 可选选项:
      • ● Open the Web UI
      • ○ Run in background (daemon mode)
      • ○ Exit (configure later)
    • 选择:● Open the Web UI(打开 Web 管理界面,回车确认)

2.3 验证 OpenClaw 网关运行状态

openclaw gateway status

验证标准:执行命令后,终端无红色报错信息,显示'running'或'active'状态,即表示 OpenClaw 核心服务安装正常。

2.4 访问 OpenClaw Web 管理界面(Windows 端操作)

通过 SSH 端口映射,在 Windows 端访问服务器上的 Web 界面,步骤如下:

  1. 打开 Windows 终端(CMD 或 PowerShell),执行端口映射命令(替换为服务器实际 IP):
ssh -N -L 18789:127.0.0.1:18789 [email protected]

首次连接提示处理:

  • 提示:Are you sure you want to continue connecting (yes/no/[fingerprint])? 输入 yes 并回车;
  • 提示输入 root 密码,输入密码后回车(回车后终端无响应,属于正常现象,不要关闭终端);
  1. 打开浏览器,输入以下地址,即可访问 Web 管理界面(token 不可直接复制,每个安装完成后的 token 随机,在上方的 openclaw gateway status 指令的返回中寻找自己的 token):
http://127.0.0.1:18789/#token=0cc32ed44f212d5067acd89f164c5c51192ba0a0ae2fbdd7

注意:1. 端口映射终端需保持打开状态,关闭则无法访问 Web 界面;2. 若无法访问,检查服务器防火墙是否开放 18789 端口。

三、模型配置(Minimax / DeepSeek 完整配置)

执行以下命令,进入 OpenClaw 模型配置界面:

openclaw config

3.1 基础配置选择(所有模型通用)

  1. 选择网关运行位置
    • 提示内容:Where will the Gateway run?
    • 可选选项:● local / ○ remote
    • 选择:● local(网关运行在本地服务器,回车确认)
  2. 选择配置模块
    • 提示内容:Select sections to configure
    • 可选选项:● Model / ○ Channels / ○ Skills / ○ Hooks / ○ Gateway
    • 选择:● Model(进入模型配置,回车确认)

3.2 Minimax 模型配置(完整选项)

  1. 选择模型提供商
    • 提示内容:Select a model provider
    • 可选选项:○ Anthropic / ○ OpenAI / ● MiniMax / ○ 其他提供商 / ○ Custom Provider
    • 选择:● MiniMax(回车确认)
  2. 选择 Minimax 授权方式
    • 提示内容:Select MiniMax auth method
    • 可选选项:● MiniMax OAuth / ○ API Key
    • 选择:● MiniMax OAuth(OAuth 授权方式,回车确认,若使用 API Key 的也可选择对应方式并输入 API Key)
  3. 选择区域
    • 提示内容:Select region
    • 可选选项:● CN / ○ 其他区域
    • 选择:● CN(国内区域,回车确认)
  4. 授权操作
    • 终端会弹出 Minimax 授权链接,复制该链接;
    • 将授权链接提供给已购买 Minimax 套餐的用户,用户打开链接完成授权;
    • 授权完成后,终端自动跳转至模型选择界面。
  5. 选择 Minimax 模型
    • 提示内容:Select default model
    • 可选选项:● 默认模型 / ○ minimax2.5highspeed / ○ 其他 Minimax 模型
    • 选择:可勾选 minimax2.5highspeed(高速模型),或保留默认模型,回车确认

注意:授权链接仅单次有效,若授权失败,需重新进入配置界面,重复上述步骤获取新的授权链接。

3.3 DeepSeek 模型配置(自定义 OpenAI 兼容端点,完整选项)

  1. 选择模型提供商
    • 提示内容:Select a model provider
    • 可选选项:○ Anthropic / ○ OpenAI / ○ MiniMax / … / ● Custom Provider (Any OpenAI or Anthropic compatible endpoint)
    • 选择:● Custom Provider(自定义提供商,回车确认)
  2. 输入 DeepSeek 基地址
    • 提示内容:Enter the base URL for the custom provider
    • 输入内容:https://api.deepseek.com/v1(输入完成后回车确认)
  3. 选择 API Key 提供方式
    • 提示内容:How do you want to provide this API key?
    • 可选选项:
      • ● Paste API key now (Stores the key directly in OpenClaw config)
      • ○ Use environment variable (Requires restarting the gateway)
      • ○ Skip (Configure later)
    • 选择:● Paste API key now(立即粘贴 API Key,回车确认)
  4. 输入 DeepSeek API Key
    • 提示内容:Enter the API key
    • 操作:粘贴 DeepSeek 官方提供的 API Key
  5. 选择端点兼容性
    • 提示内容:Endpoint compatibility
    • 可选选项:
      • ● OpenAI-compatible (Uses /chat/completions)
      • ○ Anthropic-compatible (Uses /messages)
    • 选择:● OpenAI-compatible(OpenAI 兼容模式,回车确认)
  6. 输入模型 ID
    • 提示内容:Enter the model ID (e.g., gpt-4, claude-3-opus)
    • 输入内容:
      • 推理模型:deepseek-reasoner
      • 对话模型:deepseek-chat
    • 操作:根据需求输入对应模型 ID,回车确认
  7. 选择 Endpoint ID
    • 提示内容:Select an endpoint ID (or create a new one)
    • 可选选项:● custom-api-deepseek-com(默认选项,回车确认)
  8. 设置模型别名(可选)
    • 提示内容:Model alias (optional, for easier reference)
    • 操作:可输入 deepseek 作为别名(便于后续识别),也可直接回车跳过(不设置别名)

注意:DeepSeek API Key 需妥善保管,避免泄露;若 API Key 失效,需重新进入配置界面修改。

四、飞书(Feishu)渠道配置(完整步骤+选项)

4.1 进入飞书渠道配置界面

  1. 执行配置命令:openclaw config
  2. 选择配置模块:● Channels(回车确认)
  3. 选择渠道操作:● Configure/link(回车确认)
  4. 选择渠道类型:○ WeChat / ● Feishu/Lark (飞书) / ○ 其他渠道(选择飞书,回车确认)

4.2 安装飞书插件

  • 提示内容:Install Feishu plugin?
  • 可选选项:● Download from npm (@openclaw/feishu) / ○ Use local plugin / ○ Skip (Configure later)
  • 选择:● Download from npm(从 npm 下载官方插件,回车确认)
  • 等待插件下载安装完成(约 1-2 分钟,根据网络速度而定)

4.3 对接飞书应用信息(交互式配置完整选项)

前置操作:在飞书后台创建「企业内部应用」,并添加机器人(步骤见 4.4),复制应用的 App ID 和 App Secret。

  1. 输入飞书 App ID
    • 提示内容:Enter Feishu App ID
    • 操作:粘贴飞书应用的 App ID,回车确认
  2. 输入飞书 App Secret
    • 提示内容:Enter Feishu App Secret
    • 操作:粘贴飞书应用的 App Secret,回车确认
  3. 选择飞书域名
    • 提示内容:Which Feishu domain?
    • 可选选项:● Feishu (feishu.cn) - China / ○ Lark (larksuite.com) - International
    • 选择:● Feishu (feishu.cn) - China(国内飞书,回车确认)
  4. 选择群聊响应策略
    • 提示内容:Group chat policy
    • 可选选项:
      • ● Allowlist - only respond in specific groups(仅允许指定群聊响应)
      • ○ Open - respond in all groups (requires mention)(所有群聊响应,需 @ 机器人)
      • ○ Disabled - don't respond in groups(不响应任何群聊)
    • 选择:根据实际需求选择(推荐选择 ○ Open,回车确认)
  5. 配置私聊访问策略
    • 提示内容:Configure DM access policies now? (default: pairing)
    • 可选选项:● Yes / ○ No
    • 选择:● Yes(回车确认,进入私聊策略配置)
    • 私聊策略可选选项:
      • ● Open - respond to all DMs(响应所有用户私聊)
      • ○ Allowlist - only respond to specific users(仅响应指定用户私聊)
      • ○ Disabled - don't respond to DMs(不响应任何私聊)
    • 选择:根据实际需求选择(推荐选择 ● Open,回车确认)

至此,OpenClaw 端的飞书渠道配置完成,需进入飞书后台补充配置(步骤见 4.4)。

4.4 飞书后台补充配置(完整步骤)

登录飞书开放平台(https://open.feishu.cn/),进入已创建的「企业内部应用」后台,按以下步骤配置:

  1. 添加机器人能力
    • 左侧导航栏点击「应用能力」→「机器人」;
    • 点击「添加机器人」,确认添加(无需额外配置,默认即可)。
  2. 配置权限(关键步骤)
    • 左侧导航栏点击「权限管理」→「权限配置」;
    • 在搜索框输入「im」,筛选「消息与群组」分类下的所有权限(共 55 项),全部勾选;
    • 在搜索框输入「获取通讯录基本信息」,勾选该权限;
    • 点击页面底部「确认开通」。
  3. 配置事件与回调
    • 左侧导航栏点击「事件与回调」→「事件配置」;
    • 订阅方式选择「长连接」,点击「保存」;
    • 点击「添加事件」,在弹出的窗口中,筛选「消息」分类,勾选「接收消息」;
    • 点击「确认添加」,完成事件订阅。
  4. 发布应用(最终步骤)
    • 点击页面顶部「版本管理」→「创建版本」;
    • 输入版本号(如 v1.0.0)和版本描述(如 OpenClaw 飞书机器人);
    • 可用范围选择「全部成员」,点击「保存」;
    • 点击「申请发布」,等待企业管理员审核(审核通过后,应用即可使用)。

4.5 重启网关,生效飞书配置

openclaw gateway restart

重启完成后,飞书机器人即可正常接收和响应消息(需等待飞书应用审核通过)。

五、常见问题与注意事项

5.1 常见问题排查

  • 问题 1:安装 OpenClaw 时提示'permission denied'(权限不足)
    • 解决方法:在 npm 命令前添加 sudo,即 sudo npm install -g openclaw@latest。
  • 问题 2:Web 界面无法访问,端口映射无报错
    • 解决方法:检查服务器防火墙是否开放 18789 端口,执行 sudo ufw allow 18789 开放端口。
  • 问题 3:飞书机器人无法响应消息
    • 解决方法:1. 检查飞书应用权限是否完整开通;2. 检查事件订阅是否勾选「接收消息」;3. 重启 OpenClaw 网关(openclaw gateway restart)。
  • 问题 4:模型配置后无法调用
    • 解决方法:1. 检查 API Key/授权链接是否有效;2. 检查模型 ID 是否输入正确;3. 重启网关生效配置。

5.2 注意事项(必看)

  • 所有命令需在 Linux 终端(Debian/Ubuntu 系列)执行,其他系统(如 CentOS)需调整部分命令(如 apt 替换为 yum)。
  • 端口映射仅用于本地访问 Web 界面,生产环境需配置防火墙,限制访问 IP,避免安全风险。
  • 飞书应用权限需完整配置,否则机器人无法接收/响应消息,若权限变更,需重启网关生效。
  • 模型 API Key、飞书 App Secret 等敏感信息需妥善保管,避免泄露,若泄露需及时更换。
  • OpenClaw 版本会持续更新,若安装过程中出现兼容性问题,可尝试安装指定版本(如 npm install -g [email protected])。
  • 若服务器网络受限,无法访问 GitHub、npm,需配置代理,或手动下载安装包、插件上传至服务器。

目录

  1. OpenClaw 安装与配置指南
  2. 环境要求
  3. 一、基础环境准备
  4. 1.1 配置 Root 账户(可选但推荐)
  5. 1. 修改 root 密码(执行后按提示输入两次新密码)
  6. 2. 修改 root 远程登录配置文件
  7. 1.2 安装 Node.js(OpenClaw 核心依赖,需 ≥20.x,推荐 22.x)
  8. 1. 添加 NodeSource 官方源(22.x 稳定版本)
  9. 2. 安装 Node.js
  10. 3. 验证 Node.js 版本(确认版本 ≥20.x)
  11. 1.3 安装 CMake(编译依赖,版本 ≥3.19 可跳过此步骤)
  12. 1. 下载 CMake 3.28.3 官方安装脚本(Linux x86_64 架构)
  13. 2. 给安装脚本添加执行权限
  14. 3. 安装到 /usr/local/bin 目录(跳过许可证确认)
  15. 4. 验证 CMake 版本(确认版本 ≥3.19)
  16. 1.4 安装基础编译工具
  17. 1.5 安装 xpm(OpenClaw 专用依赖管理工具)
  18. 二、OpenClaw 核心安装与初始化
  19. 2.1 安装 OpenClaw 主程序(最新版本)
  20. 2.2 初始化 OpenClaw(交互式配置)
  21. 2.3 验证 OpenClaw 网关运行状态
  22. 2.4 访问 OpenClaw Web 管理界面(Windows 端操作)
  23. 三、模型配置(Minimax / DeepSeek 完整配置)
  24. 3.1 基础配置选择(所有模型通用)
  25. 3.2 Minimax 模型配置(完整选项)
  26. 3.3 DeepSeek 模型配置(自定义 OpenAI 兼容端点,完整选项)
  27. 四、飞书(Feishu)渠道配置(完整步骤+选项)
  28. 4.1 进入飞书渠道配置界面
  29. 4.2 安装飞书插件
  30. 4.3 对接飞书应用信息(交互式配置完整选项)
  31. 4.4 飞书后台补充配置(完整步骤)
  32. 4.5 重启网关,生效飞书配置
  33. 五、常见问题与注意事项
  34. 5.1 常见问题排查
  35. 5.2 注意事项(必看)
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • Python 实现 AI 绘画用户评价自动分类与报告生成
  • FPGA 开发从入门到实战指南
  • C++ 基础入门实战指南
  • PyTorch 文本引导图像生成与 Stable Diffusion 实践
  • 使用文心一言为智能体设计稳定调用工作流的提示词
  • Python 窗体编程技术详解
  • 多模态文本智能技术:AI 语义理解与执行架构解析
  • Selenium Web 自动化测试入门与实战指南
  • Linux 多线程初探:从进程到轻量级执行流
  • DooTask 如何利用轻量化与 AI 技术优化开发团队协同管理
  • Redmine 基于 Docker 的部署与插件配置指南
  • 基于 Django 框架搭建 WebApi 项目实战
  • 金仓数据库与 InfluxDB 性能及 SQL 兼容性对比分析
  • 网文作家 AI 写作技巧与效率提升
  • 语义化 AI 驱动器与提示词工程的技术演进
  • 文心一言开源版测评:能力、易用性与应用价值
  • Docker 安装 Neo4j 图数据库教程
  • MySQL 索引原理:B+ 树演进与操作实战
  • 动态规划专题:子序列问题的核心思路与实战
  • 前端监控实战:错误追踪与性能分析指南

相关免费在线工具

  • 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