DeepSeek技术社区

目录

• 前言
• 安装前应掌握的基本概念
• 安装步骤
  • 第一步：安装Node.js
  • 第二步：安装OpenClaw(使用npm)
  • 第三步：申请DeepSeek大模型的API Key
  • 第四步：配置OpenClaw(使用大模型)
  • 第五步：配置飞书
    • 1. 在飞书开放平台创建飞书应用
    • 2. 安装飞书插件并进行配置
    • 3. 在飞书开放平台进一步配置事件订阅与权限
    • 4. 在OpenClaw中进行配对
  • 第五步：配置QQ
  • 第五步：配置微信
• OpenClaw安装与配置失败怎么办？如何升级？
• 卸载OpenClaw
• 🦞 OpenClaw 常用命令速查表(AI生成，人工审核)
  • 💡 最常用的命令
  • 🎛️ 客户端界面
  • 📦 安装与基础管理
  • 🚀 网关服务管理
  • ⚙️ 配置管理
    • 📌 常用配置项示例
  • 🔌 插件管理
  • 🔐 用户与授权管理
  • 🛠️ 技能(skill)与ClawHub
  • 📁 数据与存储

最后更新：2026/04/26；内容：DeepSeek升级为V4，其相应的model也进行了修改。

前言

最近跟风，研究了一下OpenClaw的安装与使用。花费了几天时间折腾，终于搭建将这个AI助理搭起来了。
现在已经可以通过飞书发送消息给电脑上的Openclaw，让其干活了。这边应该有一截图

安装调试过程颇有些繁琐，写点笔记，做个备忘。

安全提醒：

1. OpenClaw 在安装和部署后将获得较高的系统权限，有可能误删用户数据。
2. 如果安装OpenClaw服务器部署在公网环境还可能被黑客攻击。
3. OpenClaw会疯狂的燃烧Tokens，也就是传说中的烧钱 。如果处理复杂任务或碰到特殊情况，OpenClaw有可能很快就会把你的Tokens快速烧光。

安装前应掌握的基本概念

安装时主要使用到如下系统、组件与平台服务与文档。

操作系统：Windows 10或11 及 PowerShell控制台；
安装组件：Node.js 22及以上版本、OpenClaw、飞书插件。
平台服务：飞书开放平台、DeepSeek大模型API开放平台。
官方文档：OpenClaw官方中文文档
使用示例：别人使用OpenClaw能做些什么？

组件与平台说明表格如下：

组件	核心作用	官方网站
Node.js	JavaScript 运行时环境，为 OpenClaw 提供运行基础	https://nodejs.org/
OpenClaw	开源 AI 网关，负责接收和转发消息、调用大模型、管理插件	https://openclaw.ai/
DeepSeek	大语言模型服务，OpenClaw 通过 API 调用它来生成回答内容	https://platform.deepseek.com/
飞书开放平台	提供飞书应用创建、权限配置、事件订阅等能力，是机器人接入的入口	https://open.feishu.cn/
飞书插件	OpenClaw 的扩展(extension)，负责与飞书开放平台通信，完成消息格式转换和收发	同上

组件与服务之间的关系：OpenClaw 运行在 Node.js 环境上，通过飞书插件连接飞书平台以收发消息，当收到用户消息(用户手机上的飞书发送的消息)后，OpenClaw 调用 DeepSeek API 生成回答内容，最后通过飞书插件将回答返回给用户手机上的飞书客户端。

安装步骤

第一步：安装Node.js

Node.js是OpenClaw运行的基础环境，所以需要先安装。截至2026年3月，应该安装Node.js 22及以上的新版本。

1. 访问nodejs.org，下载Windows安装程序(.msi)。
2. 双击安装，要选择 “Add to PATH” (默认是安装的)。
3. 如何验证是否安装成功，打开PowerShell、终端或命令提示符(CMD)，输入命令node --version，确认版本号是否大于等于22。

如何打开PowerShell？

1. 右键点击任务栏上的“开始”按钮(或按 Win + X)。
2. 选择 “PowerShell(管理员)”。注：在Windows 11中选择终端管理员，或者直接使用命令行提示符亦可。
   • 这里并不需要管理员权限，但后面的很多操作需要。
     说明：后面涉及到命令行操作的，使用PowerShell、终端(本质上还是PowerShell)、命令行提示符均可，不再赘述。

第二步：安装OpenClaw(使用npm)

打开OpenClaw官网，找到Quick Start，发现4种安装方式：

1. One-liner
   一行命令安装，适合小白，不过灵活性不足。
2. npm(我们选择的安装方式)：
   Node.js包管理器安装。适合熟悉Node.js生态的开发者。通过npm全局安装后，OpenClaw会作为一个命令行工具常驻系统中，后续使用openclaw命令时无需再次下载，启动速度更快。
3. Hackable
   面向希望深度定制、贡献代码或对安全性有极高要求的进阶用户。
4. macOS
   macOS上的安装方式。

npm安装命令：npm install -g openclaw。注意：一定要以管理员权限启动PowerShell运行。
安装后验证命令：openclaw --version

第三步：申请DeepSeek大模型的API Key

此步是为了让你的OpenClaw可以使用DeepSeek作为其后台大模型。
此步需要获得几个关键信息：

1. DeepSeek的API Key：形如sk-xxx格式的key(密钥)。
2. base_url:https://api.deepseek.com
3. 模型名称或id：deepseek-chat或deepseek-reasoner。前者为非思考模式、后者为思考模式。

步骤：

1. 打开DeepSeek官网,点击开放平台;
2. 登录后点击左侧API Key去创建API Keys；
3. 创建你的Key，会生成一个形如(sk-xxx)的key。这时候把他复制下来存在一个文本文件里(如果不现在复制下来，以后就看不到了)，方便后面配置OpenClaw的Model的时候使用。

第四步：配置OpenClaw(使用大模型)

1. 运行配置向导

在管理员权限下PowerShell中执行以下命令，进入交互式配置界面：openclaw onboard

2. openclaw onboard 配置步骤一览(AI生成，人工审核)

步骤	提示内容	简要说明与配置建议
1. 风险确认(Security warning)	确认你了解运行 AI 助手的潜在风险。	选择 Yes 以继续 。
2. 配置模式(Onboarding mode)	选择 QuickStart (快速开始) 或 Advanced (高级/手动)。	新手或一般使用选 QuickStart 即可 。高级模式可让你对端口、认证等有更多控制权。
3. 模型/认证提供商(Model/auth provider)	选择你想使用的大模型提供商(如DeepSeek)	如果列表中没有你的大模型提供商，可以选择 Custom Provider 选项。如果不知道怎么设置，此处可以选择 Skip for now 跳过 。
4. 配置模型(model)	在上一步选择了Custom Provider，就可以进行配置。	依次提供：API Base URL：https://api.deepseek.com(如果上一步你选择的是具体的某个供应商，URL通常不用填写)， Paste API key now：粘贴你刚才的申请的SK开头的API Key，Endpoint compatibility ：OpenAI-compatible，Model ID:填入deepseek-v4-flash。如果提供的信息无误，会返回验证成功信息。
5. 选择消息通道(Channel)	选择你想要连接的聊天平台，如 飞书、QQ、Telegram、WhatsApp 等。	如果计划安装飞书插件，这里可以选择 Skip for now，稍后再配置 。也可以在这里选择飞书(feishu)，其会自动下载安装飞书插件。注意：如果权限不够，是无法安装成功的。你可以先下载，后面再进行配置。最新版本还支持QQ，可以直接选择QQ。
6. 配置技能(Configure skills now?)	询问是否要启用一些本地实用技能(如文件操作等)。	暂时选择 No
7. 启用钩子(Enable hooks)	允许你在特定系统事件发生时自动执行预先定义的脚本或操作	建议全选
8. 网关服务(Gateway service)	询问是否将 OpenClaw 网关安装为系统服务(支持后台运行和开机自启)。	推荐选择 Install 或 Reinstall 。
9. 孵化机器人(How do you want to hatch your bot?)	询问如何启动你的机器人，通常提供 TUI(终端界面)或 Dashboard(网页界面)选项。	选择 Hatch in TUI 可以在控制台获得更互动的体验，或者之后直接用 openclaw dashboard 命令打开网页控制台 。对于喜欢使用网页形式的交互的选择Open the Web UI

注意：新版本的OpenClaw可能还会有多余的步骤或者少掉一些步骤，比如让你配置Geimi的API，根据需要进行选择。

经过如上操作，如果一切顺利，你就已经在OpenClaw配置好DeepSeek大模型。这时候可能会打开一个OpenClaw的Web页面(地址通常是类似http://127.0.0.1:18789/#token=23ada5d0a9f0dffe865e986a9fc66c79b74ff494a1567079)，或者直接打开一个命令行终端。在这个页面或终端窗口你就可以和OpenClaw Bot聊天了。

注意：网址中token=后面的23ada5d0a9f0dffe865e986a9fc66c79b74ff494a1567079是一个一次性的身份验证令牌，让你无需输入密码即可直接登录Web控制台。它保证了只有能在你电脑上打开这个链接的人(也就是你自己)才能访问。重启OpenClaw这个token就不能用了。

该步骤的常用命令

• 启动 OpenClaw 网关(gateway)：命令openclaw gateway start或openclaw gateway restart
• 打开 OpenClaw 网页控制台：命令openclaw dashboard。注意：如果配置不正确，即使打开了网页也不能正常使用。
• 打开 OpenClaw 终端控制台：命令openclaw tui

到这里，如果都配置正确，你的OpenClaw就已经能调用DeepSeek大模型啦！
比如可以问它：今天北京天气怎么样。
还可以直接发信息让他操作电脑，甚至可以让他帮你安装飞书插件。

3. 如果没有成功怎么办？

尝试使用openclaw dashboard全部重新配置，或者openclaw config对某个单项进行配置，比如重新配置model。

当你在配置时误操作，可按Ctrl + c退出。

第五步：配置飞书

本小节讲解的是如何配置OpenClaw内置的Feishu插件，该插件基本上只能完成信息传递功能。
但自2026年3月6日其，飞书正式推出了其开发的适用于OpenClaw的飞书官方插件，让你不仅可以信息传递，还可以充分地利用飞书平台的云文档、日历日程、多维表格、电子表格、任务功能。并且，整个安装过程也比原来OpenClaw内置的Feishu插件容易得多，你无需再手动创建应用、添加机器人、填写配置信息、赋予权限、进行事件回调配置、pairing操作等，只需扫二维码即可成功创建并进行必要的配置。不过还是要先注册飞书账号。推荐安装飞书官方插件，就可以不用再看第五步啦。具体安装与使用方法详见官方文档：OpenClaw飞书官方插件使用指南。安装飞书官方插件的命令为：npx -y @larksuite/openclaw-lark-tools install，需要管理员权限。

---

1. 在飞书开放平台创建飞书应用

打开飞书开放平台，登录后，点击发开着后台，点击创建企业自建应用 → 点击添加应用能力，选择添加机器人。点击网页左侧凭证与基础信息，获得 App ID 和 App Secret。最后点击“创建版本”进行发布上线。关键： 必须发布上线(不能是草稿)

2. 安装飞书插件并进行配置

1. 如果前面你没安装飞书插件，可以使用如下命令安装：openclaw plugins install @openclaw/feishu。

2. 将飞书配置到OpenClaw：
   openclaw config set channels.feishu.appId "你的App ID"
   openclaw config set channels.feishu.appSecret "你的App Secret"

3. 安装、配置后为了让其生效，需重新启动网关：openclaw gateway restart

3. 在飞书开放平台进一步配置事件订阅与权限

1. 配置事件订阅(最关键的一步)：

   打开 飞书开放平台 → 你的应用 → 事件与回调

   订阅方式选择 “使用长连接接收事件”(⚠️ 不是Webhook)。注意：应先把OpenClaw gateway启动好以后再做，要不然不成功。

   最后，添加事件 im.message.receive_v1

2. 设置飞书机器人权限

   打开 飞书开放平台，点击左侧权限管理，然后点击批量导入/导出权限。粘贴如下json字符串，批量赋予权限。主要赋予了基于对话、文件处理、应用管理等权限。

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

在飞书平台上都设置好以后，一定要点击“创建版本”进行发布上线。

4. 在OpenClaw中进行配对

所有配置都完成后，还需要在 OpenClaw 中执行一次配对操作，才能让你的飞书账号获得使用机器人的权限。

这一步是 OpenClaw 的安全机制——只有经过你(管理员)明确批准的飞书用户，才能和你的 AI 助手对话。

配对步骤：

第一步：在飞书中获取配对码

1. 打开飞书电脑端(手机端也行，但建议电脑端方便复制)
2. 找到你刚才创建并发布的机器人，给它发一条消息(比如“你好”或任意内容)
3. 机器人会自动回复一条消息，其中包含一个 8位大写字母+数字的配对码，例如：

你的身份验证码是：X379S5M8
请在命令行执行：openclaw pairing approve feishu X379S5M8

第二步：在 OpenClaw 中批准配对

在终端输入openclaw pairing approve feishu X379S5M8

(请将 X379S5M8 替换为你实际收到的配对码)

第三步：确认批准成功

命令执行成功后，会看到类似以下提示：
`Pairing approved for user ou_xxxxxxxxxxxxxxxxxxxxx`
此时，你的飞书用户 ID 已被添加到允许列表中

第四步：验证

再次在飞书里给机器人发消息，应该能正常收到 AI 回复，不再需要配对码。

第五步：配置QQ

现在除了飞书外，QQ也支持接入OpenClaw。打开 q.qq.com 进入 QQ开放平台查询如何安装。

注意：OpenClaw 3.31已内置QQ机器人插件，无需单独安装。详见QQ龙虾Bot使用文档。

第五步：配置微信

截至2026-03-22 微信也支持介入了OpenClaw了。简单总结一下安装步骤：

打开微信后，依次点击“我-设置-插件-微信ClawBot”。
然后在部署OpenClaw的电脑上输入如下命令安装。安装过程中需要扫描二维码。npx -y @tencent-weixin/openclaw-weixin-cli@latest install
安装完后，最后重启OpenClaw：openclaw gateway restart

详见如下文章：

微信官方终于下场了！支持原版OpenClaw，你的龙虾好友已上线

OpenClaw安装与配置失败怎么办？如何升级？

1. 把出错信息粘贴给DeepSeek之类的大模型，问它。不过有时候幻觉还挺多的，它给的命令不能全信。
2. 打开openclaw config或openclaw onboard重新进行设置。设置后，重新启动网关openclaw gateway restart。
3. 打开OpenClaw网关(openclaw dashboard或openclaw tui)访问进行验证。
4. 有的时候根据提示，启动openclaw doctor进行检查。
5. 在openclaw中直接问他，让他帮你解决。

总的来说还是要多看出错提示，在出错提示的指导下进行配置。

如何升级OpenClaw？

管理员权限运行命令npm install -g openclaw@latest或openclaw update,升级完以后。按照如下步骤检查：

1. 运行健康检查(会自动修复可修复的问题)openclaw doctor

2. 重启网关服务openclaw gateway restart

3. 查看状态确认一切正常openclaw status

卸载OpenClaw

因为OpenClaw频繁升级，有的时候升级完不少插件就不能用或者插件重复，这时候如果没有重要的配置与插件，干脆卸载后重装。

下面这一条命令，它就会自动把主程序、服务和配置文件都删掉：openclaw uninstall --all --yes
命令解释：--all 代表彻底删除所有相关数据，--yes 代表自动确认，不用你再手动输入"y"。npm uninstall -g openclaw
命令跑完后，它可能还会留个"外壳"。为了彻底干净，再执行删除命令行工具：

🦞 OpenClaw 常用命令速查表(AI生成，人工审核)

OpenClaw命令众多，先记常用的吧。
更详细的说明请查看OpenClaw官方文档

💡 最常用的命令

场景	对应命令
刚开始	npm install -g openclaw → openclaw onboard
配飞书	openclaw plugins install @openclaw/feishu → 配置 App ID/Secret → openclaw gateway restart
改配置	openclaw config
日常用	openclaw gateway start(启动服务) + openclaw onboard(网页控制台) 或openclaw tui(命令行控制台)+ openclaw gateway stop (停止服务)
出问题	openclaw doctor + openclaw logs

控制台下配置到一半发现错了，赶紧按Ctrl + C中止当前运行。

🎛️ 客户端界面

命令	作用	使用场景
openclaw tui	打开终端文本界面(命令行聊天)	习惯命令行、SSH远程连接时
openclaw dashboard	打开网页控制台	需要图形界面管理、查看用量统计

📦 安装与基础管理

命令	作用	使用场景
npm install -g openclaw	使用 npm 全局安装 OpenClaw	首次安装
openclaw --version	查看 OpenClaw 版本	验证安装是否成功
openclaw update	更新 OpenClaw	需要更新openclaw或者出问题的时候
openclaw doctor	运行诊断检查	排查配置问题、验证连通性

🚀 网关服务管理

命令	作用	使用场景
openclaw gateway start	启动网关服务(前台运行)	调试或临时使用
openclaw gateway stop	停止网关服务	需要关闭服务时
openclaw gateway restart	重启网关服务	修改配置后使其生效
openclaw gateway status	查看网关运行状态	检查服务是否正常运行
openclaw gateway install	安装为系统服务(后台运行)	需要开机自启或长期运行
openclaw status	查看整体运行状态(插件、通道等)	快速概览系统状态

⚙️ 配置管理

命令	作用	使用场景
openclaw onboard	运行交互式配置向导	首次配置或重新设置
openclaw config	通用配置向导	日常微调、查看配置、单项修改
openclaw config get <key>	获取指定配置项的值	如 openclaw config get model.provider
openclaw config set <key> <value>	设置指定配置项的值	手动配置 API Key、App ID 等

📌 常用配置项示例

配置项	示例值	作用
model.provider	deepseek	设置大模型提供商
model.apiKey	sk-xxx	设置 API Key
model.name	deepseek-v4-flash或deepseek-v4-pro	设置模型命
channels.feishu.appId	cli_xxxxx	设置飞书 App ID
channels.feishu.appSecret	your-secret	设置飞书 App Secret
channels.feishu.enabled	true	启用飞书通道

说明：

• deepseek-v4-flash：经济版，适合日常使用。
• deepseek-v4-pro ：旗舰版，适合处理复杂逻辑、长文档或高难度Agent任务。截至2026-04-26，还非常贵！

🔌 插件管理

命令	作用	使用场景
openclaw plugins list	列出所有已安装插件	查看已安装的插件
openclaw plugins install <插件名>	安装插件	如 openclaw plugins install @openclaw/feishu
openclaw plugins uninstall <插件名>	卸载插件	移除不需要的插件
openclaw plugins update <插件名>	更新指定插件	获取插件新版本

🔐 用户与授权管理

命令	作用	使用场景
openclaw pairing list	查看待处理的配对请求	查看有哪些用户正在申请使用
openclaw pairing approve <渠道> <配对码>	批准用户使用机器人	如 openclaw pairing approve feishu X379S5M8
openclaw pairing revoke <渠道> <用户ID>	撤销已批准的用户权限	禁止某个用户继续使用

🛠️ 技能(skill)与ClawHub

命令	作用	使用场景
openclaw skills list	列出所有可用技能	主要用于本地查看已安装的技能

更多Skill的安装、查找还是使用ClawHub。
ClawHub = Skill的“发现引擎” + “下载源”
openclaw skill = Skill的“本地管理工具”

ClawHub命令如下

操作步骤	命令	说明
安装 ClawHub	npm install -g clawhub	需要在管理员权限下运行
验证安装	clawhub --version	显示版本号即表示安装成功
搜索 Skill	npx clawhub search "browser"	搜索和浏览器相关的 Skill(这里用 npx 临时执行)
安装 Skill	clawhub install tavily-search	示例：安装 tavily-search 这个 Skill
列出已安装的 Skill	clawhub list	查看本地已安装的所有 Skill

💡 小贴士：安装 Skill 后，需要重启 OpenClaw 会话(如在 TUI 中输入 /exit 重进)才能生效。如果不放心，直接重启整个Gatewayopenclaw gateway restart。

📁 数据与存储

命令	作用	使用场景
openclaw logs	查看Gateway网关文件日志	排查问题
openclaw reset	重置本地配置/状态(谨慎使用)	完全重新开始