在 K3／K1 开发板上部署 openclaw 并配置飞书与自定义邮件系统

本教程旨在引导在 K3 或 K1 RISC-V 开发板上成功部署和配置 。将学习如何搭建必要的运行环境、安装 核心程序、配置大语言模型（LLM）、集成飞书（Lark）插件以及部署一个自定义的邮件服务，从而实现一个功能强大的自动化智能助手。

本教程以 K3 开发板为例进行演示。K1 开发板的操作流程完全相同，但由于性能差异，部分安装和编译过程可能会耗时更长。

在开始之前，请确保您的开发板系统满足以下环境要求。

请确保系统中已安装以下工具：

• Python 3.x (3.10 或更高版本)
• pip (Python 包管理器)
• Git (版本控制工具，用于克隆代码仓库)
• venv (Python 虚拟环境工具)

及其插件生态依赖于 Node.js 环境。推荐使用 (Node Version Manager) 来安装和管理 Node.js 版本，这样可以轻松切换以满足不同项目的需求。

步骤一：安装 nvm

如果您的系统中尚未安装 ，请执行以下命令：

如果你觉得有需要，为了永久生效，可将上述 和 命令添加到您的 或 文件中，然后执行 或重启终端。

步骤二：安装 Node.js

这个包临时找一个地方存着，比如

将包 放到目录后，运行

安装成功后，您会看到如下界面：

需要连接一个大语言模型才能进行对话。对于这个版本的包，我们可以直接通过来快速配置模型。

在命令行输入下面的命令

示例 1: 配置 QWEN (或其他兼容模型)

示例 2: 配置 Moonshot Kimi

如果您使用 Kimi 模型，请先前往 Moonshot AI 开放平台 获取openclaw 配置您的 API Key，新人会有15元额度，平时省着用即可（k2.5模型的价格可以在 https://platform.moonshot.cn/docs/pricing/chat 查询到）。

复制密钥，注意只会显示一次

然后可以按照下面流程使用 openclaw configure进行配置

其他模型配置方法相似，qwen每天会有一定免费额度。需要自定义模型的可以在custom provider里面设置

2.5. 配置openclaw后端服务

2.6测试openclaw

打开地址：OpenClaw Control

在左侧的Overview 找到 Gateway Token ，输入刚刚填写的token，点击connect ，

然后就可以回到chat尝试聊天了

正常可以回复。

接下来，我们将为 配置飞书插件，使其能够通过飞书聊天接收和发送消息。

当前这个包内置飞书插件，我们只需要启用插件，配置app ID 和 app SECRET即可，无需额外安装！

步骤一：创建应用

1. 访问 飞书开放平台，并确保切换到个人开发者身份！！！。
2. 点击「创建应用」，选择“企业自建应用”，填写应用名称（如 ）和描述。
3. 在应用详情页的“能力”部分，找到并添加「机器人」能力。

步骤二：获取凭证

• 在「凭证与基础信息」页面，复制您的 App ID 和 App Secret。
  
  

步骤三：配置 openclaw的飞书插件

先在控制面板左侧的config的 plugins 里面的 All 的Feishu 插件 找到Enable Feishu，然后点击启用

然后配置频道

配置完成后，重启网关以加载新配置：

步骤四：配置权限和事件
关于权限说明可以参考 README.md · /openclaw_feishu_riscv – Gitee.com

1. 开通权限：在飞书开放平台的「权限管理」页面，搜索并开通以下必需权限。更多高级功能权限可按需添加。

2. 配置事件订阅：
   • 进入「事件与回调」页面。
   • 在“事件配置方式”中，选择 使用长连接接收事件。
   • 点击“添加事件”，订阅以下事件：
     • (必需)
     • (可选)
     • (可选)

       
       
       

   如果在配置长连接时提示“应用未建立长连接”，请检查：

   1. 网关是否已成功重启。
   2. 您在 中配置的 App ID 和 App Secret 是否正确。

步骤五：发布应用

• 前往「版本管理与发布」，创建一个新版本并申请发布。个人开发者应用通常会很快通过审核。
  
  

邮件服务一般是基于POP3/SMTP/IMAP服务，但是直接使用灵活性较低

故这里是本人想的两个方案，一个是自己写一个邮件服务，处理好SMTP协议，然后对外暴露api接口，仅限本地的openclaw进行调用，还有一个方案是采用现成的插件，插件由于我暂时没有找到比较符合自己要求的，故采用自行编写邮件服务，顺带能够实现自定义的功能，如果你有其他需求，可以直接改代码，或者寻找合适的插件。

为了让 具备收发邮件的能力，我们部署一个独立的、基于 FastAPI 的邮件服务。 可以通过调用此服务的 API 来操作您的邮箱。

建议找一个固定的目录存放这套独立的python邮箱服务，比如~/.openclaw

步骤一：克隆并安装依赖

步骤二：配置邮箱账户

先启用插件

然后登陆你的邮箱，找到SMTP相关的内容，申请一个授权码

步骤三：启动服务

首次启动，会带一个密钥

然后可以按照类似于这样的填写相关的配置，具体内容按照你的实际来！！然后配置完成点击右上角的save进行保存

现在，你的openclaw应该具备的邮件的插件，你可以告诉他让他读取当前的邮件

然后就可以尝试各个邮件处理功能，相关的文档可以参考项目目录下的README.md

您可以登录自己的邮箱，在“草稿箱”中确认 是否成功创建了邮件。

也可以让openclaw直接发送

当然，最后你可以直接让openclaw给自己的网关和邮件服务配置开机启动，dashboad也有很多现成的skill供你尝试

不过，对于复杂任务可能会消耗不少token，用量仍然需要注意。

不过由于当前api局限性，不支持实时推送邮件作为通信渠道，下一次更改会尝试添加这个功能

恭喜您！至此，你已经成功在 K3/K1 开发板上部署了 ，并配置了飞书和自定义邮件服务。现在，你可以进一步探索 的更多功能，例如编写更复杂的技能、集成其他插件，或将其应用到您的实际工作流中。

如果您在部署过程中遇到任何问题，请回顾教程中的步骤或查阅相关工具的官方文档。祝您使用愉快！