OpenClaw 完整安装与配置文档（包含Minimax/deepseek模型接入、飞书机器人接入）

优质文章学习记录

— 14 min read

OpenClaw 完整安装与配置文档

文档说明：本文档适用于 Linux 系统（Debian/Ubuntu 系列），详细梳理 OpenClaw 从基础环境准备、核心程序安装，到模型配置（Minimax/DeepSeek）、飞书渠道对接的全流程，所有交互式配置选项完整呈现，步骤可直接复制执行，适配新手操作。

适用场景：OpenClaw 新手部署、企业内部飞书机器人对接、Minimax/DeepSeek 模型配置

前置说明：

  1. 服务器需联网，确保能访问 GitHub、npm、飞书官网；
  2. 操作全程使用终端命令行，建议使用远程工具（如 Xshell、Putty）连接服务器；
  3. 复制命令时需完整复制，避免遗漏特殊符号；
  4. 所有交互式配置选项均完整列出，按文档指引选择即可。
  5. 拥有root用户/sudo权限。

一、基础环境准备

1.1 配置 Root 账户（便于远程登录操作，可选但推荐）

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

# 1. 修改 root 密码（执行后按提示输入两次新密码）sudopasswd root # 2. 修改 root 远程登录配置文件sudovim /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-Ebash - # 2. 安装 Node.jssudoapt-getinstall-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 安装基础编译工具

sudoaptinstall-ymake gcc g++ build-essential

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

1.5 安装 xpm（OpenClaw 专用依赖管理工具）

npminstall-g xpm

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

二、OpenClaw 核心安装与初始化

2.1 安装 OpenClaw 主程序（最新版本）

npminstall-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-L18789: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，需配置代理，或手动下载安装包、插件上传至服务器。

Read more

Retinaface+CurricularFace部署教程：镜像内Python 3.11.14环境安全补丁升级方法

Retinaface+CurricularFace部署教程：镜像内Python 3.11.14环境安全补丁升级方法 你是不是也遇到过这样的问题：刚拉取一个功能齐全的人脸识别镜像，准备直接上手测试，结果发现Python版本存在已知安全漏洞？或者在企业级部署中，安全审计要求必须打上最新补丁，但又担心升级后破坏原有推理环境的稳定性？别急，这篇教程就是为你量身定制的——我们不讲抽象理论，不堆砌参数配置，而是手把手带你完成RetinaFace+CurricularFace镜像中Python 3.11.14的安全补丁升级，全程零兼容性风险，所有操作均可逆、可验证。 本教程面向真实工程场景：你拿到的是一个开箱即用的AI镜像，目标不是从头编译Python，而是以最小改动、最高安全性完成升级。我们会避开常见的“重装conda环境”陷阱，绕过PyTorch与CUDA的脆弱依赖链，用官方推荐的增量补丁方式，让Python版本号不变（仍是3.11.14），但底层安全漏洞全部修复。整个过程5分钟内完成，不影响任何已有推理脚本运行。 1. 镜像环境现状与升级必要性 1.1 当前镜像核心组件一览 Ret

实测｜龙虾机器人（OpenClaw）Windows系统部署全攻略（含避坑指南）

作为一名热衷于折腾新技术的ZEEKLOG博主，最近被一款名为「龙虾机器人」的开源AI工具圈粉了！它还有个更正式的名字——OpenClaw（曾用名Clawdbot、MoltBot），不同于普通的对话式AI，这款工具能真正落地执行任务，比如操作系统命令、管理文件、对接聊天软件、自动化办公，而且支持本地部署，数据隐私性拉满。 不过调研发现，很多小伙伴反馈龙虾机器人在Windows系统上部署容易踩坑，官方文档对Windows的适配细节描述不够细致。今天就结合自己的实测经历，从环境准备、分步部署、初始化配置，到常见问题排查，写一篇保姆级攻略，不管是新手还是有一定技术基础的同学，都能跟着一步步完成部署，少走弯路～ 先简单科普下：龙虾机器人本质是一款开源AI代理框架，核心优势是“能行动、可本地、高灵活”——它不内置大模型，需要对接第三方AI接口（如GPT、Claude、阿里云百炼等），但能将AI的指令转化为实际的系统操作，相当于给AI配了一个“能动手的身体”，这也是它和普通对话大模型的核心区别。另外要注意，它还有一种“生物混合龙虾机器人”的概念，是利用龙虾壳改造的柔性机器人，本文重点分享的是可本
Neo4j-Desktop2.0安装教程(更改安装路径)

Neo4j-Desktop2.0安装教程(更改安装路径)

引言        由于neo4j-desktop2.0版本是不提供安装页面（默认安装在C盘），从而让你选择安装路径的，这对于C盘内存来说是灾难性的。因此，需要手动设置安装路径。 参考文献： 1. https://zhuanlan.zhihu.com/p/1935104156433121644https://zhuanlan.zhihu.com/p/1935104156433121644 2. https://blog.ZEEKLOG.net/WMXJY/article/details/150649084 安装包下载：https://neo4j.com/deployment-center/?desktop-gdbhttps://neo4j.com/deployment-center/?desktop-gdb 1文件夹创建及环境变量设置     首先需要在C盘以外的位置先创建一个Neo4j2文件夹，再在下面创建两个文件夹：App，PROData来存放软件本体和相关数据 然后打开“高级系统设置”——“环境变量”——系统变量下方的“新建”
ubuntu上安装OpenClaw并接入飞书机器人

ubuntu上安装OpenClaw并接入飞书机器人

大家好，我是一根甜苦瓜。今天来分享如何在本地安装openclaw并接入飞书，实现让AI给我打工。 最近AI圈更新太快了，从github copilot到cursor 到claud code ，再到codex，然后是最近火爆了的小龙虾(OpenClaw)，可谓是百花齐放，应接不暇。本人也是github copilot+codex的深度用户，确实不错，所以最近打算折腾一下小龙虾，顺带教大家如何把智谱GLM 接入OpenClaw。 1. 前言 1.1 什么是openclaw 2026 年开年，AI 圈突然冒出一匹“野生黑马”——OpenClaw。这个开源个人 AI 助手项目在 GitHub 上只用了 两周时间就狂揽 15 万 Star，速度堪比开挂。 简单说，它就像给你配了一个 24 小时不下班的数字打工人： 把它部署在自己的电脑或服务器上，它就能接入 WhatsApp、Telegram、