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

安装 启动 使用 Neo4j的超详细教程

安装 启动 使用 Neo4j的超详细教程

最近在做一个基于知识图谱的智能生成项目。需要用到Neo4j图数据库。写这篇文章记录一下Neo4j的安装及其使用。 一.Neo4j的安装 1.首先安装JDK，配环境变量。（参照网上教程，很多） Neo4j是基于Java的图形数据库，运行Neo4j需要启动JVM进程，因此必须安装JAVA SE的JDK。从Oracle官方网站下载 Java SE JDK。我使用的版本是JDK1.8 2.官网上安装neo4j。 官方网址：https://neo4j.com/deployment-center/  在官网上下载对应版本。Neo4j应用程序有如下主要的目录结构： bin目录：用于存储Neo4j的可执行程序； conf目录：用于控制Neo4j启动的配置文件； data目录：用于存储核心数据库文件； plugins目录：用于存储Neo4j的插件； 3.配置环境变量 创建主目录环境变量NEO4J_HOME，并把主目录设置为变量值。复制具体的neo4j文件地址作为变量值。 配置文档存储在conf目录下，Neo4j通过配置文件neo4j.conf控制服务器的工作。默认情况下，不需

企业微信群机器人Webhook配置全攻略：从创建到发送消息的完整流程

企业微信群机器人Webhook配置全攻略：从创建到发送消息的完整流程 在数字化办公日益普及的今天，企业微信作为国内领先的企业级通讯工具，其群机器人功能为团队协作带来了极大的便利。本文将手把手教你如何从零开始配置企业微信群机器人Webhook，实现自动化消息推送，提升团队沟通效率。 1. 准备工作与环境配置 在开始创建机器人之前，需要确保满足以下基本条件： * 企业微信账号：拥有有效的企业微信管理员或成员账号 * 群聊条件：至少包含3名成员的群聊（这是创建机器人的最低人数要求） * 网络环境：能够正常访问企业微信服务器 提示：如果是企业管理员，建议先在"企业微信管理后台"确认机器人功能是否已对企业开放。某些企业可能出于安全考虑会限制此功能。 2. 创建群机器人 2.1 添加机器人到群聊 1. 打开企业微信客户端，进入目标群聊 2. 点击右上角的群菜单按钮（通常显示为"..."或"⋮"） 3. 选择"添加群机器人"选项 4.

Flowise物联网融合：与智能家居设备联动的应用设想

Flowise物联网融合：与智能家居设备联动的应用设想 1. Flowise：让AI工作流变得像搭积木一样简单 Flowise 是一个真正把“AI平民化”落地的工具。它不像传统开发那样需要写几十行 LangChain 代码、配置向量库、调试提示词模板，而是把所有这些能力打包成一个个可拖拽的节点——就像小时候玩乐高，你不需要懂塑料怎么合成，只要知道哪块该拼在哪，就能搭出一座城堡。 它诞生于2023年，短短一年就收获了45.6k GitHub Stars，MIT协议开源，意味着你可以放心把它用在公司内部系统里，甚至嵌入到客户交付的产品中，完全不用担心授权问题。最打动人的不是它的技术多炫酷，而是它真的“不挑人”：产品经理能搭出知识库问答机器人，运营同学能配出自动抓取竞品文案的Agent，连刚学Python两周的实习生，也能在5分钟内跑通一个本地大模型的RAG流程。 它的核心逻辑很朴素：把LangChain里那些抽象概念——比如LLM调用、文档切分、向量检索、工具调用——变成画布上看得见、摸得着的方块。你拖一个“Ollama LLM”节点，再拖一个“Chroma Vector
OpenClaw配置Bot接入飞书机器人+Kimi2.5

OpenClaw配置Bot接入飞书机器人+Kimi2.5

上一篇文章写了Ubuntu_24.04下安装OpenClaw的过程，这篇文档记录一下接入飞书机器+Kimi2.5。 准备工作 飞书 创建飞书机器人 访问飞书开放平台：https://open.feishu.cn/app，点击创建应用： 填写应用名称和描述后就直接创建： 复制App ID 和 App Secret 创建成功后，在“凭证与基础信息”中找到 App ID 和 App Secret，把这2个信息复制记录下来，后面需要配置到openclaw中 配置权限 点击【权限管理】→【开通权限】 或使用【批量导入/导出权限】，选择导入，输入以下内容，如下图 点击【下一步，确认新增权限】即可开通所需要的权限。 配置事件与回调 说明：这一步的配置需要先讲AppId和AppSecret配置到openclaw成功之后再设置订阅方式，