完成Moltbot(原Clawdbot)服务器的部署(可参考使用云主机一键部署Moltbot),可通过配置聊天软件与Moltbot进行交互,本文将为您介绍打造飞书个人助理的最佳实践。
步骤1:登录云主机,安装Moltbot
登录目标云主机。登录天翼云官网,进入计算控制台,点击远程登录按钮。在管理终端页面中,输入用户名密码,登录云主机。
进行功能的授权,执行命令:
clawdbot onboard风险确认,选择“Yes”。
安装模式,选择“QuickStart”。
配置模型供应商。如果已经订购上述供应商的大模型接口,则选择对应选项,如果使用私有化部署的大模型,选择“Skip for now”,初始化结束后,通过修改~/.clawdbot/clawdbot.json文件,进行大模型配置。
过滤大模型的供应商。这里选择“All providers”。
确定智能体服务的默认模型,默认使用的是“claude-opus-4-5”,也可以下拉选择,选择“Enter model manually”进行手动配置
选择和Moltbot通信的软件,这里先跳过,选择“Skip for now”。
是否配置扩展技能(skills),由于大部分skills目前为国外服务的功能,此处选择跳过,选择“No”。
hooks配置。hooks可以理解为三个智能体的能力配置:
- boot-md:启动时增加引导内容,可将规则、偏好、项目背景等信息,在每次启动时自动注入使用。
- command-logger:记录在 Moltbot 中执行的命令及关键操作并生成日志,方便后续排查问题、复盘操作;若注重隐私或无需留存操作痕迹,建议关闭。
- session-memory:保存会话相关的状态与记忆数据,支持后续启动时延续上下文,让使用体验更连贯。
这三个可以选择都开,本次演示选择全部打开。
是否重启gateway服务,这里选择“restart”。
下面是对ai的个性化设置,这里可以选择“Do this later”。
到此,Moltbot安装已完成。若配置大模型时选择跳过,此时可以打开配置文件~/.clawdbot/clawdbot.json进行配置,可参考以下配置:
{
"meta": {}, // 请忽略
"wizard": {}, // 请忽略
"models": {
"providers": {
"self": { // self可以替换为其他字符,表示模型供应商
"baseUrl": "http://[大模型服务的IP或者域名]/v1",
"apiKey": "[api key]",
"api": "openai-completions",
"models": [
{
"id": "[模型 id]",
"name": "[模型名称]",
"api": "openai-completions",
"reasoning": false,
"input": [
"text"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 65536, // 根据实际能力修改
"maxTokens": 65536 // 根据模型实际能力修改
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "self/[模型 id]" // self需要与前文模型供应商对应
},
"models": {
"self/[模型 id]": {} // self需要与前文模型供应商对应
}
}
},
"tools": {}, // 请忽略
"media": {}, // 请忽略
"messages": {}, // 请忽略
"commands": {}, // 请忽略
"hooks": {}, // 请忽略
"channels": {}, // 请忽略
"gateway": {}, // 请忽略
"skills": {},// 请忽略
"plugins": {} // 请忽略
}
步骤2:飞书机器人创建(个人用户可使用)
进入飞书应用中心 ,选择创建企业自建应用。
填写信息,点击创建
选择机器人应用,点击添加机器人。
为应用添加权限。点击权限管理-开通权限,在输入框中输入目标权限,必需权限和可选权限配置见下表。
必需权限 范围 说明 contact:user.base:readonly 用户信息 获取用户基本信息 im:message 消息 发送和接收消息 im:message.p2p_msg:readonly 私聊 读取发给机器人的私聊消息 im:message.group_at_msg:readonly 群聊 接收群内 @机器人 的消息 im:message:send_as_bot 发送 以机器人身份发送消息 im:resource 媒体 上传和下载图片/文件 可选权限 范围 说明 im:message.group_msg 群聊 读取所有群消息(敏感) im:message:readonly 读取 获取历史消息 im:message:update 编辑 更新/编辑已发送消息 im:message:recall 撤回 撤回已发送消息 im:message.reactions:read 表情 查看消息表情回复 权限添加完后状态如下:
步骤3:在云服务器上为Moltbot服务配置飞书插件
Moltbot 默认不内置飞书 Channel,需要额外安装插件。这里使用开源插件:https://github.com/m1heng/clawdbot-feishu?tab=readme-ov-file#%E4%B8%AD%E6%96%87。安装流程如下:
在云服务器内运行插件安装命令:
clawdbot plugins install @m1heng-clawd/feishu
安装完成后,将飞书机器人的配置参数写入Moltbot的配置文件。
clawdbot config set channels.feishu.appId "[飞书的APP ID]"
clawdbot config set channels.feishu.appSecret "[飞书的APP Secret]"
clawdbot config set channels.feishu.enabled true以上参数所在位置:
配置完成后,重新启动Moltbot的gateway服务
clawdbot gateway restart
添加事件订阅
注意
事件订阅必须在Moltbot添加飞书配置并启动后,才可以创建,否则无法创建成功。
选择订阅方式为长连接
添加事件,具体添加项见下表:
事件 说明 im.message.receive_v1 接收消息(必需) im.message.message_read_v1 消息已读回执 im.chat.member.bot.added_v1 机器人进群 im.chat.member.bot.deleted_v1 机器人被移出群 配置完成后,进行发版
飞书机器人已创建成功,现在可以在飞书中和机器人对话,校验Moltbot功能是否正常。