环境准备
在开始之前，请确保你的服务器运行的是 Debian 或 Ubuntu 系列 Linux 系统，并且拥有 root 权限。整个流程依赖命令行操作，建议使用 Xshell 或 Putty 等工具连接。
1. 基础依赖安装
首先配置 Root 账户以便远程管理，修改密码并允许 SSH 登录：
sudo passwd root
编辑 SSH 配置文件以启用 Root 登录：
sudo vim /etc/ssh/sshd_config
找到 PermitRootLogin 行，取消注释并改为 yes，保存退出后重启服务：
sudo systemctl restart sshd
接下来安装 Node.js（OpenClaw 核心依赖），推荐版本 22.x：
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
node -v
若遇到网络问题，可尝试更换国内源或手动上传安装包。随后安装编译工具链和 CMake：
sudo apt-get install -y make gcc g++ build-essential
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
最后安装 OpenClaw 专用的包管理工具 xpm：
npm install -g xpm
2. 安装与初始化
使用 npm 全局安装 OpenClaw：
npm install -g openclaw@latest
如果提示权限不足，请在命令前加 sudo。执行初始化命令进入交互式配置：
openclaw onboard --install-daemon
按以下指引选择即可：
- 确认协议：输入
Yes继续。 - 初始化模式：选择
QuickStart，后续可通过命令补充细节。 - 模型提供商：暂时选
Skip for now，稍后单独配置。 - 默认模型：保留当前默认值或按需调整。
- 渠道配置：先选
Skip for now，飞书通道后面再配。 - 技能与钩子：建议跳过，后续按需添加。
- 启动方式：选择
Open the Web UI打开管理界面。
验证网关状态：
openclaw gateway status
显示 running 或 active 即表示核心服务正常。
3. 访问 Web 管理界面
Windows 用户可通过 SSH 端口映射访问本地 Web 界面。在终端执行（替换 <服务器 IP> 为实际地址）：
ssh -N -L 18789:127.0.0.1:18789 root@<服务器 IP>
首次连接提示确认指纹时输入 yes，输入密码后保持终端开启。浏览器访问：
http://127.0.0.1:18789/#token=<你的 Token>
Token 可在 openclaw gateway status 的输出中查找。注意防火墙需开放 18789 端口。
4. 模型配置
Minimax 接入
运行配置命令：
openclaw config
依次选择：
- 网关位置：
local - 配置模块：
Model - 提供商：
MiniMax - 授权方式：
MiniMax OAuth（或 API Key） - 区域：
CN
终端会弹出授权链接，复制给已购买套餐的用户完成授权。之后选择具体模型，如 minimax2.5highspeed。
DeepSeek 接入
同样进入 openclaw config -> Model -> Custom Provider：
- 基地址：输入
https://api.deepseek.com/v1 - API Key：选择
Paste API key now并粘贴密钥 - 兼容性：选择
OpenAI-compatible - 模型 ID：推理用
deepseek-reasoner，对话用deepseek-chat - 别名：可选填
deepseek
5. 飞书渠道对接
服务端配置
再次运行 openclaw config：
- 模块：
Channels - 操作：
Configure/link - 类型：
Feishu/Lark - 插件：选择从 npm 下载官方插件
随后输入飞书应用的 App ID 和 App Secret，域名选 Feishu (feishu.cn)。群聊策略建议选 Allowlist 仅响应特定群，私聊策略选 Open 响应所有用户。
飞书后台设置
登录飞书开放平台创建企业内部应用：
- 能力：添加机器人。
- 权限：开通消息与群组相关权限（约 55 项），以及获取通讯录基本信息。
- 事件：订阅长连接，勾选'接收消息'事件。
- 发布：创建版本并提交审核，范围设为全部成员。
配置完成后重启网关生效：
openclaw gateway restart
6. 常见问题
- 权限拒绝：npm 命令前加
sudo。 - 无法访问 Web：检查防火墙是否放行 18789 端口 (
sudo ufw allow 18789)。 - 机器人无响应：确认飞书权限是否全开，事件订阅是否正确，必要时重启网关。
- 模型调用失败：核对 API Key 有效性及模型 ID 格式。
注意事项
- 敏感信息（API Key、Secret）请妥善保管。
- 生产环境建议限制 Web 界面访问 IP。
- 如遇网络限制，可配置代理或手动上传依赖包。
- 版本更新频繁，遇到问题可尝试指定版本安装。
