OpenClawd 部署教程

在飞书中搭建你的私人AI助手

使用火山云服务器和火山方舟模型，快速部署一个功能强大的飞书AI机器人

1

购买云服务器

选择火山云服务器，系统会自动配置好基础环境。

推荐配置：

  • 2C2G配置：58元/年
  • 2C4G配置：99元/年

购买链接：

szacq.cn/2ec46/

付费后系统会用2-3分钟自动创建实例，然后点击右边页面中的"远程连接"进入虚拟机。

2

开通火山方舟模型

在火山方舟管理页面中选择"一键开通所有模型"。

管理页面：

火山方舟 - 开通管理
3

获取API密钥和模型ID

步骤3：创建API Key

在API Key管理中为本项目设置一个API Key，记录下来作为备用1。

步骤4：选择模型

在模型广场中选择一个模型，记录模型ID作为备用2。

推荐模型：

doubao-seed-1-8-251228
5

配置飞书企业应用

5. 创建企业应用

打开飞书开放平台，用手机飞书扫码登录，创建一个企业应用（例如：openclawd）。

6. 配置权限

在"开发配置 → 权限管理"中，点击"批量导入/导出权限"，粘贴以下JSON配置：

{
  "scopes": {
    "tenant": [
      "im:chat:read",
      "im:chat:update",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.pins:read",
      "im:message.pins:write_only",
      "im:message.reactions:read",
      "im:message.reactions:write_only",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource"
    ],
    "user": [
      "contact:user.employee_id:readonly"
    ]
  }
}

7. 获取应用凭证

在"基础信息 → 凭证与基础信息"中，获取：

  • App ID → 备用3
  • App Secret → 备用4

8. 创建并发布版本

点击"创建版本"，填写必要信息后即可上线发布。

9

服务器配置与启动

9. 配置环境变量

回到虚拟机，使用vi编辑器编辑配置文件：

vi /root/.clawdbot/.env

填入以下信息：

  • 方舟API Key（备用1）
  • 大模型ID（备用2）
  • App ID（备用3）
  • App Secret（备用4）

10. 运行安装脚本

bash /root/setup-clawdbot.sh

11. 测试服务状态

systemctl --user status clawdbot-gateway.service
12

配置飞书事件与回调

事件配置

  1. 在左侧目录树选择"开发配置 → 事件与回调"
  2. 选择"事件配置"页签，点击"订阅方式"旁的编辑按钮
  3. 选择"使用长连接接收事件"，并保存
  4. 在"已添加事件"区域，点击"添加事件"按钮
  5. 选择"应用身份订阅"页签，勾选"接收消息"及其它需要订阅的事件

（可选）开通群组消息权限

若需要将机器人添加到聊天群组中使用：

  1. 点击"接收消息"事件"所需权限"列的"查看其它权限"
  2. 点击"获取群组中所有消息（敏感权限）"
  3. 在弹窗中点击"开通权限"按钮申请开通

回调配置

  1. 选择"回调配置"页签，点击"订阅方式"旁的编辑按钮
  2. 选择"使用长连接接收回调"，并保存

发布新版本

  1. 点击顶部的"创建版本"按钮
  2. 配置应用版本号、默认能力及更新说明等信息
  3. 点击页面底部的"保存"按钮
  4. 点击页面右上角的"确认发布"按钮
  5. 待管理员通过发布审核后即可使用

大功告成！

在飞书对话列表中可以看到openclawd机器人，现在你可以愉快地对话了！

注意：请随时检查token的使用情况，避免超出配额。

参考文档：IMA知识库 - OpenClawd