OpenClaw 部署指南：Minimax/DeepSeek 模型与飞书机器人集成
在 Linux 环境下从零搭建 OpenClaw 智能体平台，涉及环境准备、核心安装、模型对接及渠道配置。本文档梳理了从 Node.js 环境搭建到 Minimax/DeepSeek 模型接入、飞书机器人集成的全流程，包含交互式配置选项解析与常见问题排查，适合希望快速落地私有化 AI 助手的技术人员参考。
一、基础环境准备
1.1 系统权限与环境检查
确保拥有 root 或 sudo 权限，服务器需能访问 GitHub、npm 及飞书官网。建议使用 Xshell 或 Putty 等远程工具连接。
1.2 配置 Root 账户（可选但推荐）
为了便于后续操作，建议启用 Root 远程登录。
修改密码并开启 SSH 配置：
sudo passwd root
sudo vim /etc/ssh/sshd_config
编辑 sshd_config，找到 PermitRootLogin 行，取消注释并设为 yes。保存退出后重启服务：
sudo systemctl restart sshd
1.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 连接失败，可尝试更换国内源或手动上传安装包。
1.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 --version
# 安装基础编译工具
sudo apt-get install -y make gcc g++ build-essential
注意：若提示找不到 cmake 命令，请执行 export PATH=/usr/local/bin:$PATH。
1.5 安装依赖管理工具 xpm
npm install -g xpm
xpm -v
二、OpenClaw 核心安装与初始化
2.1 安装主程序
使用 npm 全局安装最新版本：
npm install -g openclaw@latest
如遇权限报错，请在命令前加 sudo。
2.2 交互式初始化
运行 onboard 命令进入配置向导：
openclaw onboard --install-daemon
按以下逻辑选择即可：
- 协议确认：输入
Yes继续。 - 初始化模式：选
QuickStart，后续可通过命令补充细节。 - 模型提供商：暂时选
Skip for now，稍后单独配置。 - 默认模型：保留当前默认值或按需调整。
- 渠道配置：先选
Skip for now，飞书渠道将在后面单独对接。 - 技能与钩子：根据需求选择，新手建议暂不配置。
- 启动方式：选
Open the Web UI打开管理界面。
2.3 验证网关状态
openclaw gateway status
显示 running 或 active 即表示核心服务正常。
2.4 访问 Web 管理界面
通过 SSH 端口映射在本地浏览器访问。假设服务器 IP 为 <server_ip>：
ssh -N -L 18789:127.0.0.1:18789 root@<server_ip>
首次连接提示指纹确认时输入 yes，随后输入密码。终端保持运行状态下，浏览器访问：
http://127.0.0.1:18789/#token=<your_token>
注：Token 需在 openclaw gateway status 输出中获取，每个安装实例的 Token 随机生成。
三、模型配置（Minimax / DeepSeek）
执行 openclaw config 进入配置菜单，选择 Model 模块。
3.1 Minimax 模型配置
- 提供商：选择
MiniMax。 - 授权方式：推荐
MiniMax OAuth，按提示复制链接完成授权；也可选择 API Key 方式。 - 区域：选择
CN（国内）。 - 模型选择：勾选
minimax2.5highspeed或其他可用模型。
注意：授权链接单次有效，失败需重新获取。
3.2 DeepSeek 模型配置
DeepSeek 采用 OpenAI 兼容接口，需自定义端点。
- 提供商：选择
Custom Provider。 - 基地址：输入
https://api.deepseek.com/v1。 - API Key：选择
Paste API key now，粘贴官方提供的 Key。 - 兼容性：选
OpenAI-compatible。 - 模型 ID：推理用
deepseek-reasoner，对话用deepseek-chat。 - 别名：可设为
deepseek以便识别。
注意：妥善保管 API Key，失效需重新配置。
四、飞书（Feishu）渠道配置
4.1 配置入口
再次运行 openclaw config，依次选择 Channels → Configure/link → Feishu/Lark。
4.2 安装插件
选择 Download from npm (@openclaw/feishu)，等待自动下载安装。
4.3 应用信息对接
提前在飞书后台创建企业内部应用，获取 App ID 和 App Secret。
- App ID/Secret：粘贴对应凭证。
- 域名：选择
Feishu (feishu.cn)。 - 群聊策略：推荐
Open（所有群聊响应）或Allowlist（指定群聊）。 - 私聊策略：推荐
Open（响应所有私聊）。
4.4 飞书后台补充配置
登录飞书开放平台，完成以下关键步骤：
- 添加能力：在「应用能力」中添加「机器人」。
- 权限开通：在「权限管理」中搜索
im，勾选消息与群组相关权限（约 55 项），以及「获取通讯录基本信息」。 - 事件订阅：在「事件与回调」中选择长连接，订阅「接收消息」事件。
- 发布应用：创建版本并提交审核，范围设为「全部成员」。
4.5 生效配置
openclaw gateway restart
重启后等待审核通过，机器人即可收发消息。
五、常见问题与注意事项
5.1 常见故障排查
- 权限不足：npm 命令前加
sudo。 - Web 无法访问：检查防火墙是否放行 18789 端口 (
sudo ufw allow 18789)。 - 机器人无响应：检查飞书权限是否全开、事件订阅是否正确，或重启网关。
- 模型调用失败：核对 API Key 有效性及模型 ID 拼写。
5.2 重要提示
- 本指南基于 Debian/Ubuntu 系列，CentOS 需调整包管理命令（yum/dnf）。
- 生产环境务必限制 Web 界面访问 IP，避免安全风险。
- 敏感信息（API Key、App Secret）泄露需立即更换。
- 网络受限时可配置代理或手动上传依赖包。