Moltbot是一款开源的本地优先AI 代理与自动化平台。您可以通过Moltbot将多渠道通信能力与大语言模型深度集成,创建拥有持久记忆与主动执行能力的定制化 AI 助理。
步骤一、购买Moltbot套餐
如果您已购买轻量应用服务器,可以跳过此步骤,以重置系统的方式部署Moltbot(重置系统时选择应用镜像下的Moltbot镜像),但重置系统会清除轻量应用服务器上的系统盘数据,请您根据需要做好数据备份。具体操作,请参见重置系统。
在轻量应用服务器页面,预置了资源配置,如要更改配置项,请参考下面内容。
实例:内存必须2GiB及以上,可以根据自己的需求切换套餐。
地域:默认美国(弗吉尼亚)。
购买配置:默认12个月,可以根据自己的需求切换时长。
步骤二、配置Moltbot
在阿里云百炼大模型服务平台前往密钥管理页面,单击创建API-Key。
警告请妥善保管百炼 API-Key。若发生泄露,第三方将有机会冒用您的身份进行恶意使用,产生超出预期的token费用。
在服务器页面,单击服务器卡片中的实例ID,进入服务器概览页面。
单击应用详情页签,配置Moltbot。

端口放通:需要放通对应端口的防火墙,单击一键放通即可。
配置Moltbot:单击执行命令,输入百炼的API-Key,单击下一步。
访问控制页面:单击执行命令可获取Clawdbot对话的地址。
查看Token。在中单击执行命令,获取Token。
警告请勿泄露包含 Token 的完整 URL。该链接包含您的身份验证凭据,任何持有此链接的人都能直接绕过登录验证,获得您 Moltbot 控制台的管理员权限。
开启ResponseAPI访问,后续AppFlow会通过API访问Moltbot。
在Clawdbot页面左侧导航栏,单击。
在Config页面左侧导航栏单击Gateway,切换至Http页签,在Responses区域将Enabled切换至开启,单击Save。

步骤三、集成钉钉
1. 创建钉钉应用
创建钉钉应用需要您的钉钉账号有开发者权限。您可以联系您的组织管理员获取钉钉开放平台的开发权限,具体操作请参见获取开发者权限。
1.1 创建应用
访问钉钉开放平台,点击创建。如果创建过应用但未展示应用开发指引,点击立即开始进入钉钉应用页面。
在应用开发的左侧导航栏中,点击钉钉应用,在钉钉应用页面右上角点击创建应用。

在创建应用面板,填写应用名称和应用描述,在应用图标上传图标,完成后点击保存。
1.2 查看应用 Client ID 和 Client Secret
在左侧菜单选择凭证与基础信息,复制Client ID和Client Secret,用于下一步创建连接流。

1.3 创建消息卡片
钉钉机器人通过卡片消息支持流式返回结果,您需要创建卡片模板供消息发送使用。
访问卡片平台,点击新建模板。

在创建模板输入框,填入模板信息,单击创建。
卡片类型:选择消息卡片。
卡片模板场景:选择AI 卡片。
关联应用:填入应用创建步骤中的应用名称。
在模拟编辑页面,不要使用预设模板,不需要进行任何额外操作,直接保存并发布模板。然后点击返回模板列表页面。

复制模板ID,用于创建钉钉连接流使用。

1.4 授予应用发送卡片消息权限
创建卡片后,您需要给应用授予发送卡片消息的权限。
访问钉钉应用列表。找到刚刚创建的应用,点击应用名称进入详情页面。
在左侧菜单选择,在左侧搜索框分别输入
Card.Streaming.Write和Card.Instance.Write,并在操作列点击申请权限。
2. 创建AppFlow连接流
使用AppFlow模板创建连接流,单击立即使用进入创建流程。
在连接流的账户授权配置向导页,点击添加新凭证。输入在配置Moltbot时获取的Token。

在连接流的账户授权配置向导页,点击添加新凭证。在创建凭证对话框中,填入创建的应用的Client ID 和 Client Secret,并设置一个自定义凭证名称。

在执行动作配置向导页,填写模型名称、公网地址以及获取卡片模板时获取的模板ID,完成后点击下一步。

在基本信息配置向导页,填写连接流名称和连接流描述(建议保持默认),完成后点击下一步。
界面提示流程配置成功,复制WebhookUrl,点击发布。

3. 配置钉钉机器人
有了Webhook地址后,接下来您可以在钉钉应用中配置机器人来回答用户问题了。
3.1 配置钉钉机器人
访问钉钉应用列表。找到刚刚创建的应用,点击应用名称进入详情页面。
在添加应用能力页面,找到机器人卡片,点击添加。
在机器人配置页面,打开机器人配置开关,您可以参考下图完成配置。消息接收模式请选择HTTP模式,消息接收地址为创建的流式调用的WebhookUrl。然后点击发布。
消息接收模式选择HTTP模式,目前AppFlow仅支持HTTP模式,选择Stream模式会导致无法返回消息。


3.2 发布应用版本
应用创建完成后,如果需要将应用供企业内其他用户使用,需要发布一个版本。
单击应用开发,在钉钉应用页面,点击目标应用。

在目标应用开发导航栏,单击版本管理与发布,在版本管理与发布页面,点击创建新版本。进入版本详情页面,输入应用版本号和版本描述信息,选择合适的应用可见范围,完成后点击保存。并在弹窗中点击直接发布。


3.3 测试机器人
你可以创建群聊或在已有群聊中添加机器人,并与机器人对话,查看效果。
在钉钉群管理中添加机器人。进入钉钉群群设置页面,点击机器人卡片区域,在机器人管理页面,点击添加机器人。在添加机器人的搜索文本框中输入目标机器人名称,并选中要添加的机器人。点击添加,完成后再点击完成添加。
在钉钉群中或私聊时@机器人,进行交流互动。

相关文档
您可以通过 Tailscale 构建安全隧道互联 Mac,实现通过Moltbot管理Mac上的iMessage,具体实现参考通过Moltbot调用iMessage。
常见问题
如何更改钉钉机器人调用的模型?
在服务器页面,单击服务器卡片中的实例ID,进入服务器概览页面。
单击应用详情页签,在访问控制页面单击快速查看可进入Clawdbot对话页面。
单击,搜索Primary Model,更改为你想用的模型。














