这篇教程写给第一次自建服务、但又想把 OpenClaw 跑起来的人。结论先说：用 1Panel 的应用商店安装 OpenClaw，是目前最省心、最不容易踩坑的方式——你只需要在创建应用时导入 DeepSeek 的 API 配置，部署完成后打开 OpenClaw 终端跑一遍引导，就能接入飞书开始使用。
0. 你会得到什么（部署完成后的效果）
- OpenClaw 在你的服务器上常驻运行
- 模型使用 DeepSeek（对话/推理模型任选）
- 在飞书里直接和 OpenClaw 对话（按引导接入即可）
- 后续管理：启停、重启、看日志、进容器终端，都在 1Panel 里完成
【图片位置：最终效果/飞书对话截图】
1. 为什么推荐用 1Panel 应用商店安装 OpenClaw？
很多“手动 Docker 部署”教程最大的问题不是装不起来，而是后续维护麻烦：端口、数据卷、重启策略、日志、更新、反代、HTTPS……对小白来说每个点都可能卡半天。
用 1Panel 应用商店的优势是很实在的：
1.
一键部署 + 可视化配置
不需要自己写 compose，不需要背命令。参数都在表单里填。
2.
出问题更容易定位
1Panel 直接看日志、直接进终端；重启应用也就是点一下。
3.
更适合长期跑
OpenClaw 不是“跑一次就关”的脚本，而是常驻服务。面板托管更稳定。
4.
反向代理/HTTPS更顺滑（可选）
后面你想绑域名、上 HTTPS，也在 1Panel 里配。
2. 开始前准备（照着检查就行）
- 你已经装好 1Panel，能正常登录
- 服务器能访问外网（至少能访问 DeepSeek 的 API）
- 你要接入飞书：能登录 飞书开放平台（后面要创建应用/配置机器人）
【图片位置：1Panel 首页/环境确认】
3. 获取 DeepSeek 的 API Key（有自己的模型API可跳过该步骤）
下面是“去 DeepSeek 官网拿 API”的标准流程（小白按顺序点就行）。
3.1 进入 DeepSeek 开放平台控制台
1. 打开 DeepSeek 的开放平台/控制台（官网入口一般在「开放平台 / API」相关页面）
2. 登录你的账号
【图片位置：DeepSeek 控制台首页】
3.2 创建 API Key
1. 进入「API Keys / 密钥管理」（名称可能略有不同）
2. 点击「创建密钥 / Create new key」
3. 复制生成的 Key（通常只显示一次，务必先保存好）
【图片位置：API Keys 列表页】
随便输入一个名称
【图片位置：创建 Key 弹窗/复制 Key 的位置】
点击复制，
注意1：该秘钥只显示一次，关闭后需要重新创建
注意2：API Key 相当于密码
- 不要发群里、不要贴到公开文章里
- 建议只放在服务器环境变量/配置文件中
3.3（可选）确认余额/调用权限
有的平台需要先开通计费或充值才能调用 API。
如果你部署后发现模型一直报 401/402/余额不足一类错误，优先检查这里。
【图片位置：充值页面】
4. 用 1Panel 应用商店安装 OpenClaw（关键：创建时导入模型配置）
4.1 在应用商店找到 OpenClaw
1. 登录 1Panel
2. 进入「应用商店」
3. 搜索 OpenClaw
4. 点击「安装/部署」
【图片位置：应用商店搜索 OpenClaw】
4.2 安装时怎么填（小白只抓住三件事）
选择模型账号，点击创建
- 自定义名字：给这个起个你看得懂的名称
例如： deepseek
-导入 DeepSeek API（最关键）
填你刚复制的 DeepSeek Key
【图片位置：API Key/Base URL/Model 填写位置】
最后点击确认。
你也可以根据你自己的模型选择对应模型供应商，以上仅供参考
4.3选择智能体
点击智能体，点击创建
输入应用的名称，选择智能体类型，应用版本，输入没被占用的端口
输入访问地址：
可以直接这样输入
http://0.0.0.0:18789
选择刚刚配置的模型供应商和模型账号名称
选择使用deepseek的哪个模型
按需要选择时否用外网访问
全部完成后点击确认，等待镜像拉取完成
致此openclaw部署完成
5. 部署完成：打开 OpenClaw 终端跑引导（然后接入飞书）
5.1 在 1Panel 里确认应用运行正常
1. 打开该应用详情页
2. 看状态是否为「运行中」
3. 打开「日志」确认没有明显报错（比如 Key 缺失、连不上模型）
【图片位置：应用状态页】
5.2 打开 OpenClaw 终端
在应用详情页找到「终端 / Exec / 进入容器」之类的入口，点进去。
【图片位置：终端入口】
5.3 接下来先按以下步骤创建飞书应用
首先，我们需要在飞书端创建一个“机器人”应用。
创建应用：访问飞书开放平台，
注册登录飞书，进入开发者后台
点击“创建企业自建应用”，填写名称和描述 后，点击创建。
添加机器人：在应用管理页面，点击“添加应用能力” → “机器人”，为应用添加机器人功能 。
获取凭证：在左侧菜单“凭证与基础信息”页面，复制并保管好
App ID和App Secret，下一步会用到 。
配置权限：在“权限管理”页面，点击“批量导入/导出权限”，将以下JSON配置粘贴进去并确认开通 。这些权限是机器人与你交互、读写文件所必需的。
{
"scopes": {
"tenant": [
"aily:file:read",
"aily:file:write",
"application:application.app_message_stats.overview:readonly",
"application:application:self_manage",
"application:bot.menu:write",
"cardkit:card:write",
"contact:user.employee_id:readonly",
"corehr:file:download",
"docs:document.content:read",
"event:ip_list",
"im:chat",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.members:bot_access",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.group_msg",
"im:message.p2p_msg:readonly",
"im:message:readonly",
"im:message:send_as_bot",
"im:resource",
"sheets:spreadsheet",
"wiki:wiki:readonly"
],
"user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
}
}配置事件与回调：这是最关键的一步，让飞书知道如何把消息推送给OpenClaw。
进入“事件与回调”页面。
在“事件配置”页签中，将“订阅方式”改为
使用长连接接收事件并保存 。
点击“添加事件”，搜索并添加
im.message.receive_v1（接收消息） 事件 。
发布应用：进入“版本管理与发布”，创建版本并提交审核。只有发布后，配置才会生效 。
5.4 接入openclaw，使用命令行引导
在终端中执行以下命令，OpenClaw 会以问答形式引导你完成所有步骤：
点击连接
openclaw channels add粘贴命令，回车
键盘上下定位到Feishu/Lark(飞书)回车选择
运行后，系统会依次提示你：
输入 App ID：粘贴你在飞书开放平台获取的
App ID输入 App Secret：粘贴对应的
App Secret选择连接方式：推荐选择
websocket（长连接）确认是否启用该通道：输入
y启用
引导完成后，OpenClaw 会自动：
将配置写入
~/.openclaw/config.yaml重启网关服务使配置生效
在终端输出配对提示，引导你完成最后的飞书账号绑定
你只需要按照屏幕提示，
登录飞书应用并私聊机器人
在飞书私聊机器人获取配对码，再在终端输入配对命令即可。
7. 常见问题（小白救命区）Q1：部署后模型不可用/一直报错
优先检查：
- API Key 是否粘贴完整（有没有多空格/少字符）
- 账户是否有调用权限/余额
- Base URL 是否填错（不确定就先用模板默认）
- 默认模型名是否写错（建议先用 ）Q2：飞书不回消息
优先检查：
- 飞书开放平台的权限是否按引导勾齐并发布/生效
- 回调/事件订阅相关配置是否保存成功
- OpenClaw 日志里有没有提示签名校验失败/权限不足Q3：我想用域名访问（HTTPS）
这属于锦上添花：等你“能聊天了”再弄也不迟。
后续你可以用 1Panel 的「网站/反向代理」功能把 OpenClaw 服务挂到域名上，再申请证书。
8. 最短成功路径（你照这 5 步做就行）
1. DeepSeek 控制台创建 API Key
2. 1Panel 应用商店安装 OpenClaw（第三项：自定义名字随便起）
3. 创建时把 DeepSeek API Key（以及可选的模型名）填进去
4. 部署完成 → 打开 OpenClaw 终端 → 跑引导
5. 引导里选择飞书 → 去飞书开放平台按提示配置 → 回来测试对话
评论区