OpenClaw+DeepSeek 飞书机器人原生部署指南：10分钟告别配置焦虑

告别配置焦虑，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）

node -v

若未安装或版本过低，建议安装 Node.js 22。

2. 启用 Corepack 及 pnpm

corepack enable
corepack prepare pnpm@latest --activate
# 或
npm install -g pnpm

pnpm -v

⚠️ 重要提示：

OpenClaw 是一个 pnpm workspace 项目
直接使用 npm 会报错：workspace:* unsupported

三、获取并构建 OpenClaw（源码方式）

1. 创建项目目录

mkdir OpenClaw-Zens
cd ~/OpenClaw-Zens

克隆官方项目：

git clone https://github.com/openclaw/openclaw.git
cd openclaw

安装依赖：

pnpm install --registry=https://registry.npmmirror.com

常见现象：

  • 下载 1000+ 个包
  • 耗时约 3~5 分钟
  • 出现 Ignored build scripts: core-js 可以忽略

常见卡住问题

安装过程可能会卡在：

@matrix-org/matrix-sdk-crypto-nodejs

原因通常是：

  1. GitHub 下载速度慢
  2. 服务器内存不足

解决方案：增加 Swap

sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
free -h

2. 构建 OpenClaw

pnpm run build

成功标志：

  • 没有出现 error
  • dist/ 目录下生成 *.js 文件
  • 终端输出 Build complete

四、OpenClaw 配置文件（核心）

创建配置目录

mkdir -p ~/.openclaw

创建配置文件

nano ~/.openclaw/openclaw.json

示例配置内容：

{
  "env": {
    "DEEPSEEK_API_KEY": "你的API Key"
  },
  "models": {
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com",
        "apiKey": "你的API Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-chat",
            "name": "DeepSeek Chat",
            "contextWindow": 64000,
            "maxTokens": 8192
          },
          {
            "id": "deepseek-reasoner",
            "name": "DeepSeek Reasoner",
            "contextWindow": 64000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "你的飞书App ID",
      "appSecret": "你的飞书App Secret",
      "verificationToken": "你的飞书Verification Token"
    }
  },
  "gateway": {
    "mode": "local",
    "auth": {
      "mode": "token",
      "token": "自定义登录token"
    },
    "port": 18789
  }
}

保存文件

nano 快捷键：

Ctrl + O  保存
Ctrl + X  退出

五、启动 OpenClaw

cd ~/OpenClaw-Zens/openclaw
node openclaw.mjs gateway

六、验证 DeepSeek API 可用性

测试 API 连通性：

curl -s https://api.deepseek.com/v1/models \
  -H "Authorization: Bearer sk-你的key"

正常应返回类似结构：

{
  "data": [
    {"id": "deepseek-chat"},
    {"id": "deepseek-reasoner"}
  ]
}

如果返回：

  • 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

此时：

  • 飞书机器人已在线
  • 向机器人发送消息，将会收到回复

八、使用 systemd 实现后台长期运行

创建服务文件：

sudo nano /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

启动并启用服务

sudo systemctl daemon-reexec
sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw

查看运行状态

sudo systemctl status openclaw

实时查看日志：

journalctl -u openclaw -f

九、常见错误及其解决方法

错误 1

Gateway start blocked: gateway.mode=local

解决方式：

"gateway": {
  "mode": "local"
}

错误 2

pairing required

原因：

  • 未携带认证 token
  • 通过公网访问

解决建议：

  • 不使用 Cloudflare Tunnel
  • 仅使用飞书消息通道

错误 3

Unknown model: openai/deepseek-chat

原因：

DeepSeek 并非 OpenAI provider。

正确写法：

deepseek/deepseek-chat

十、最终结论

推荐架构：

OpenClaw + DeepSeek + 飞书

特点：

  • 纯后端实现，不暴露 Web 界面
  • 通过消息通道进行交互
  • 稳定性高

不推荐的实践：

  • 暴露 WebUI
  • 折腾 Cloudflare Tunnel
  • 使用 pairing 流程

总结：OpenClaw + DeepSeek + 飞书 = 一个稳定可靠的 AI Agent 后端方案。