本指南提供在Ubuntu/Debian服务器上，使用OpenClaw v2026.2.9原生部署DeepSeek API至飞书机器人的完整流程。适合拥有VPS、希望长期后台运行且避免Cloudflare Tunnel配置的用户。包含环境准备、配置文件设置、systemd后台服务及常见错误解决方案。
Tags:
告别配置焦虑：10 分钟完成原生 OpenClaw + DeepSeek 飞书端完美接入
🦞 OpenClaw + DeepSeek + 飞书机器人完整部署指南（避坑实录）
适合人群
喜欢折腾、喜欢原生部署 有 VPS / 云服务器（Ubuntu / Debian / Alibaba Cloud ECS） 想把 DeepSeek API 接入飞书 希望 OpenClaw 长期后台运行 不想再被 Cloudflare Tunnel / WebUI token 折磨
一、环境说明（真实部署环境）
云服务器：Alibaba Cloud ECS 系统：Ubuntu / Debian（root 用户） Node.js：v22.x 包管理器：pnpm OpenClaw 版本： 2026.2.9模型：DeepSeek API 通道：飞书（WebSocket 模式）
二、基础环境准备
1. Node.js（必须 ≥20，推荐 22）
1node-v
如果没有或版本过低，建议安装 Node.js 22。
2. 启用 Corepack + pnpm
1corepack enable
2corepack prepare pnpm@latest --activate
3# 或
4npminstall-gpnpm
5
6pnpm-v
⚠️ 重要说明：
OpenClaw 是 pnpm workspace 项目
用 npm 会直接报错：workspace:* unsupported
三、获取并构建 OpenClaw（源码方式）
1. 创建项目目录
1mkdir OpenClaw-Zens
2cd ~/OpenClaw-Zens
克隆官方项目：
1git clone https://github.com/openclaw/openclaw.git
2cd openclaw
安装依赖：
1pnpminstall--registry=https://registry.npmmirror.com
常见现象：
下载 1000+ 包 时间 3~5 分钟 Ignored build scripts: core-js可以忽略
常见卡住问题
可能卡在：
@matrix-org/matrix-sdk-crypto-nodejs原因通常是：
GitHub 下载慢 内存不足
解决方案：增加 Swap
1sudo fallocate -l 4G /swapfile
2sudochmod600 /swapfile
3sudomkswap /swapfile
4sudoswapon /swapfile
5free-h
2. 构建 OpenClaw
1pnpm run build
成功标志：
没有 error看到 dist/*.js出现 Build complete
四、OpenClaw 配置文件（核心）
创建配置目录
1mkdir-p ~/.openclaw
创建配置文件
1nano ~/.openclaw/openclaw.json
示例配置：
1{
2"env":{
3"DEEPSEEK_API_KEY":"你的API Key"
4},
5"models":{
6"providers":{
7"deepseek":{
8"baseUrl":"https://api.deepseek.com",
9"apiKey":"你的API Key",
10"api":"openai-completions",
11"models":[
12{
13"id":"deepseek-chat",
14"name":"DeepSeek Chat",
15"contextWindow":64000,
16"maxTokens":8192
17},
18{
19"id":"deepseek-reasoner",
20"name":"DeepSeek Reasoner",
21"contextWindow":64000,
22"maxTokens":8192
23}
24]
25}
26}
27},
28"channels":{
29"feishu":{
30"enabled":true,
31"appId":"你的飞书App ID",
32"appSecret":"你的飞书App Secret",
33"verificationToken":"你的飞书Verification Token"
34}
35},
36"gateway":{
37"mode":"local",
38"auth":{
39"mode":"token",
40"token":"自定义登录token"
41},
42"port":18789
43}
44}
保存文件
nano 快捷键：
Ctrl + O 保存
Ctrl + X 退出五、启动 OpenClaw
1cd ~/OpenClaw-Zens/openclaw
2node openclaw.mjs gateway
六、验证 DeepSeek API
测试 API：
1curl-s https://api.deepseek.com/v1/models \
2-H"Authorization: Bearer sk-你的key"
正常返回：
1{
2"data":[
3{"id":"deepseek-chat"},
4{"id":"deepseek-reasoner"}
5]
6}
如果返回：
401无数据
说明 API key 或 base_url 错误
七、成功启动的日志示例
[gateway] agent model: deepseek/deepseek-chat
[gateway] listening on ws://127.0.0.1:18789
[feishu] starting feishu (mode: websocket)
[feishu] WebSocket client started此时：
飞书机器人在线 给机器人发消息会回复
八、让 OpenClaw 后台长期运行（systemd）
创建服务：
1sudonano /etc/systemd/system/openclaw.service
配置：
[Unit]
Description=OpenClaw Gateway
After=network.target
[Service]
Type=simple
User=root
WorkingDirectory=/root/OpenClaw/openclaw
ExecStart=/usr/bin/node openclaw.mjs gateway
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target启动服务
1sudo systemctl daemon-reexec
2sudo systemctl daemon-reload
3sudo systemctl enable openclaw
4sudo systemctl start openclaw
查看状态
1sudo systemctl status openclaw
查看日志：
1journalctl -u openclaw -f
九、常见错误
错误 1
Gateway start blocked: gateway.mode=local解决：
1"gateway":{
2"mode":"local"
3}
错误 2
pairing required原因：
token 未携带 公网访问
解决：
不使用 Cloudflare Tunnel 只使用飞书消息通道
错误 3
Unknown model: openai/deepseek-chat原因：
DeepSeek 不是 OpenAI provider。
正确写法：
deepseek/deepseek-chat十、最终结论
推荐架构：
OpenClaw + DeepSeek + 飞书特点：
纯后端 消息通道交互 稳定性高
不建议：
暴露 WebUI 折腾 Cloudflare Tunnel 使用 pairing
总结一句话：
OpenClaw + DeepSeek + 飞书 = 一个稳定的 AI Agent 后端方案。 ([LINUX DO][1])
没有评论:
发表评论