< >
Home » OpenClaw-AI助手入门教程 » OpenClaw-AI助手入门教程-Docker+deepseek+飞书+nginx反向代理部署流程1

OpenClaw-AI助手入门教程-Docker+deepseek+飞书+nginx反向代理部署流程1

  • 说明：

本文介绍了在独立服务器上通过docker方式部署OpenClaw智能助手并接入国产大模型和飞书机器人的完整流程。

  • 主要内容包括：

1）通过docker命令行快速安装OpenClaw；
2）配置国际/国产大模型（如DeepSeek）；
3）安装飞书插件并配置应用凭证；
4）设置飞书机器人权限与事件。
5）设置nginx反向代理访问

部署完成后，用户可通过飞书与AI助手交互，支持多轮对话和上下文记忆功能。

1️⃣ 环境准备：Docker 及 Docker Compose

- 安装 Docker 官方文档：[https://docs.docker.com/engine/install/](https://docs.docker.com/engine/install/)
- Docker Compose 一般随 Docker Engine 一同安装，验证：`docker compose version`

2️⃣ 获取 OpenClaw 源码并部署（Docker 方式）

git clone https://github.com/openclaw/openclaw.git
cd openclaw
./docker-setup.bash   # 交互式部署脚本

2.1 交互式配置要点

步骤  问题  选择/输入   说明
2.1 理解风险，安全问题   Yes 接受安全须知
2.2 Onboarding mode QuickStart  快速安装模式
2.3 Model / auth provider   skip for now    稍后手动配置 DeepSeek
2.4 Filter models by provider   all provider    不影响，后期跳过
2.5 Select Channel  skip for now 或 feishu   飞书稍后配置
2.6 Configure skills now    No  暂不需要技能包
2.7 Hook: session-Memory    选中（空格）  启用多轮对话记忆
2.8 等待部署完成  -   记录输出的 onboarding link（内含访问令牌）

2.2 部署完成后的操作

# 停止默认启动的容器，并以守护模式重新启动
docker compose down
docker compose up -d

# 查看运行日志
docker compose logs -f

#OpenClaw 配置文件位置（宿主机）：

cat ~/.openclaw/openclaw.json   # 所有配置持久化在此

3️⃣ DeepSeek 模型接入

3.1 获取 DeepSeek API 密钥

  • 注册/登录 DeepSeek 开放平台
  • 创建 API Key，格式：sk-xxxxxxxxxxxx
  • ⚠️ 重要：此密钥不可公开，一旦泄露请立即删除并重新生成

3.2 编辑配置文件，添加 DeepSeek 提供商

vim ~/.openclaw/openclaw.json

#在 models 节点下添加 providers 定义，并设置默认模型：

json5
{
  "models": {
    "mode": "merge",
    "providers": {
      "custom-api-deepseek-com": {
        "baseUrl": "https://api.deepseek.com",
        "apiKey": "sk-你的全新密钥",   // ⚠️ 替换为最新密钥
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-reasoner",      // 推理模型
            "name": "DeepSeek Reasoner",
            "reasoning": true,
            "contextWindow": 64000,
            "maxTokens": 8192,
            "input": ["text"]
          },
          {
            "id": "deepseek-chat",           // 快速对话模型
            "name": "DeepSeek Chat",
            "contextWindow": 64000,
            "maxTokens": 8192,
            "input": ["text"]
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "custom-api-deepseek-com/deepseek-reasoner"   // 默认使用模型
      }
    }
  }
}
#保存文件。

3.3 重启网关使配置生效

docker compose restart openclaw-gateway

3.4 测试模型是否接入成功

# 方法一：通过主代理测试（推荐）
docker compose exec openclaw-gateway \
  node dist/index.js agent --agent main --message "你好，请用一句话介绍自己"

#成功标志：回复内容包含“DeepSeek”、“深度求索”等字样。

3.5 可选：更换默认模型以提升速度

docker compose exec openclaw-gateway \
  node dist/index.js config set agents.defaults.model.primary custom-api-deepseek-com/deepseek-chat
docker compose restart openclaw-gateway

3.6 常用诊断命令

# 整体健康检查
docker compose exec openclaw-gateway node dist/index.js doctor

# 查看当前模型配置
docker compose exec openclaw-gateway node dist/index.js config get agents.defaults.model

4️⃣ 飞书机器人集成

4.1 安装飞书插件并补充依赖

# 安装插件（推荐 @xzq-xu/feishu）
docker compose exec openclaw-gateway \
  node dist/index.js plugins install @xzq-xu/feishu

# 进入插件目录，安装生产依赖（跳过 postinstall 避免 SSH 问题）
docker compose exec openclaw-gateway bash -c \
  "cd /home/node/.openclaw/extensions/feishu && npm install --production --ignore-scripts"


# 重启网关
docker compose restart openclaw-gateway

4.2 飞书开发者后台准备工作

登录 飞书开放平台

创建企业自建应用 → 填写名称，创建

添加能力 → 机器人（点击“添加”）

记录 App ID 和 App Secret（在“凭证与基础信息”中）

4.3 配置飞书通道凭证与策略

# 启用飞书通道
docker compose exec openclaw-gateway \
  node dist/index.js config set channels.feishu.enabled true

# 填入凭证
docker compose exec openclaw-gateway \
  node dist/index.js config set channels.feishu.appId 'cli_你的AppID'
docker compose exec openclaw-gateway \
  node dist/index.js config set channels.feishu.appSecret '你的AppSecret'
docker compose exec openclaw-gateway \
  node dist/index.js config set channels.feishu.domain 'feishu'   # 国内飞书

# 免配对策略（解决 pairing required）
docker compose exec openclaw-gateway \
  node dist/index.js config set channels.feishu.dmPolicy 'open'
docker compose exec openclaw-gateway \
  node dist/index.js config set channels.feishu.groupPolicy 'open'
docker compose exec openclaw-gateway \
  node dist/index.js config set channels.feishu.requireMention true   # 群聊需 @

# 性能优化：限制上下文长度 & 关闭工具调用（可选）
docker compose exec openclaw-gateway \
  node dist/index.js config set channels.feishu.contextLimit 8000
docker compose exec openclaw-gateway \
  node dist/index.js config set channels.feishu.toolsEnabled false

# 重启网关
docker compose restart openclaw-gateway

4.4 飞书后台最终配置（长连接模式）

事件订阅 → 订阅方式选择 「使用长连接接收事件」 → 保存

添加事件 → 搜索 im.message.receive_v1 → 确认添加

权限管理 → 批量导入以下权限：

json
{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",        // 获取用户姓名（解决 99991672 错误）
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ]
  }
}
版本管理与发布 → 创建版本 → 填写版本号、可见范围 → 提交发布
（若为企业内部应用，可直接审批）

4.5 验证飞书长连接及消息收发

# 实时查看飞书相关日志
docker compose logs -f openclaw-gateway | grep feishu
成功标志：

text
[feishu] connected to Feishu WebSocket
[feishu] Bot identity: openclaw (ou_xxxx)
打开飞书客户端，搜索你的机器人名称

发送任意消息，应收到 DeepSeek 的智能回复

完整openclaw.json参考

$ cat ~/.openclaw/openclaw.json
{
  "meta": {
    "lastTouchedVersion": "2026.2.9",
    "lastTouchedAt": "2026-02-11T17:06:29.081Z"
  },
  "wizard": {
    "lastRunAt": "2026-02-11T14:12:20.673Z",
    "lastRunVersion": "2026.2.9",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "custom-api-deepseek-com": {
        "baseUrl": "https://api.deepseek.com",
        "apiKey": "sk-b5687763851c4cxxxxxxxxxx",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-reasoner",
            "name": "deepseek-reasoner (Custom Provider)",
            "reasoning": true,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 64000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "custom-api-deepseek-com/deepseek-chat"
      },
      "models": {
        "custom-api-deepseek-com/deepseek-reasoner": {}
      },
      "workspace": "/home/node/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto"
  },
  "hooks": {
    "internal": {
      "enabled": true,
      "entries": {
        "session-memory": {
          "enabled": true
        }
      }
    }
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_a9018xxxxxxxxxx",
      "appSecret": "TTudUxxxxxxxxxxxxxxxxxxxxx",
      "domain": "feishu",
      "dmPolicy": "open",
      "groupPolicy": "open"
    }
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "6746d7bb7fd9xxxxxxxxxxxxxxxxxxxxxxxxxx"
    },
    "trustedProxies": [
      "172.21.0.x/32",
      "183.2.xxx.xxx"
    ],
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    },
    "nodes": {
      "denyCommands": [
        "camera.snap",
        "camera.clip",
        "screen.record",
        "calendar.add",
        "contacts.add",
        "reminders.add"
      ]
    }
  },
  "plugins": {
    "entries": {
      "feishu": {
        "enabled": true
      }
    }
  }
}

纠错,疑问,交流: 请进入讨论区或 点击加入Q群

获取最新文章: 扫一扫右上角的二维码加入“创客智造”公众号


标签: openclaw-ai助手入门教程