阎怀慕 发表于 2026-3-12 00:15:00

Ubuntu 云服务部署 OpenClaw 并接入飞书机器人

一、部署openclaw


点击立即登录https://cdn.nlark.com/yuque/0/2026/png/59621818/1773158335493-1c737d00-cdf0-4ece-a081-97b00adee312.png
1.更新系统包索引

sudo apt updatehttps://cdn.nlark.com/yuque/0/2026/png/59621818/1773161584989-814039fe-9057-4057-968f-e024d9ec7c4b.png
2.安装 curl

sudo apt install -y curlhttps://cdn.nlark.com/yuque/0/2026/png/59621818/1773161803656-58acd3da-4925-4a77-a3a6-2817d27bbf53.png

3.安装Node.js(LTS版本)

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash https://cdn.nlark.com/yuque/0/2026/png/59621818/1773162008479-3f85bd6e-6b80-42c5-9651-d81c6925c3a8.png
sudo apt-get install -y nodejs
#安装https://cdn.nlark.com/yuque/0/2026/png/59621818/1773162181840-c156fffb-1a71-4938-b378-bb03e66fe166.png
4.配置npm镜像(加速国内访问)

npm config set registry https://registry.npmmirror.comhttps://cdn.nlark.com/yuque/0/2026/png/59621818/1773162286555-0b876650-41dd-475a-a8b9-b3b350a090b0.png

5.安装openclaw

curl -fsSL https://openclaw.ai/install.sh |bash
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773162410111-2f65b3fc-2b52-441a-85be-63bcd28dd188.png



用键盘方向键选择,回车键确认
选择yes
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773162483540-05cce6df-ce3b-4d09-b550-0776e0dc5dcf.png
这里默认,选择回车https://cdn.nlark.com/yuque/0/2026/png/59621818/1773162536812-d82b70c7-a232-4590-b207-974da840d787.png

6.选择大模型(以Kimi为例)

这里我选择kimi,因为新用户注册有15元的额度
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773162732808-f05c3aff-b33e-4db9-8eaf-9487397c4890.png
我们先去kimi平台复制密钥信息,后面要用到
6.1. kimi平台配置

获取Kimi API Key
访问kimi平台,进入用户中心


https://cdn.nlark.com/yuque/0/2026/png/59621818/1773162938272-4dabff32-88f3-480f-9cee-c029078c8399.png
左侧菜单选择API Key管理 ,然后新建,名字自己随便起,点击确定后先把密钥复制
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773163056451-b0ffc124-e343-452c-a676-00822541e1db.png
这里密钥只会显示一次,一定要复制后确定,如果没复制到,就新建一个重复上面的步骤
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773163248559-b91d4f4a-9549-4f60-aa37-f3e5a9d58177.png



我们选择kimi后回车
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773162732808-f05c3aff-b33e-4db9-8eaf-9487397c4890.png?x-oss-process=image%2Fformat%2Cwebp
地区选择 .cn
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773163520452-7bec818a-6e38-40e3-8094-ad773617a41e.png

默认选择第一个,回车
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773163619585-dfcb8667-33d5-444e-b8e7-9f8fac161e10.png
把前面复制的密钥粘贴进来
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773163707185-4f0d220b-2c26-4695-9db9-6736417b48d0.png

默认,回车
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773163734264-85d6f299-32eb-4726-bc28-163176fce211.png
选择最后一个 skip for nowhttps://cdn.nlark.com/yuque/0/2026/png/59621818/1773164253658-70a39ee3-c549-41f3-b26b-9892ab04d3ef.png
选择最后一个
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773164338351-c33fa6d0-cf0e-4c48-9416-a0595cb80d25.png
是否设置技能,选no
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773164450369-b4e45ced-4a0d-4a18-9be1-e4d4cab62d53.png
空格选择第一个,人后回车
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773164478581-2e52881f-191b-4818-9d65-1666cd11802f.png
选择第二个https://cdn.nlark.com/yuque/0/2026/png/59621818/1773164555024-0a972f4d-8374-425d-8101-c3191cffd5c1.png安装完成https://cdn.nlark.com/yuque/0/2026/png/59621818/1773164594360-dd115c2d-76d9-4d99-8182-843ee1b986f3.png

7.验证安装

openclaw status若显示 running 则表示网关启动成功
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773164855958-bf5f9324-7651-4e11-a119-1fde49f2e3f7.png
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773164990641-83758a9f-1a11-4dad-a3ac-4c8e16e9be74.png

8.本地访问 Openclaw Web UI


电脑本地 Ctrl+R
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773235088534-d074d82a-d67f-4ec5-b8a3-93d745c1ed07.png
ssh-N-L 18789:127.0.0.1:18789 root@172.16.175.146
##去掉 -N 可以本地ssh连接使用命令选择yeshttps://cdn.nlark.com/yuque/0/2026/png/59621818/1773235076246-9363fa7b-23cc-47aa-8d1d-ca85ae03ebc2.png
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773235241652-8c552aec-f273-4108-bd15-13e2d3f461be.png
172.16.175.146换成你的服务器公网地址就行,还有问题就是你的防火墙去配置一下就好了,根据实际情况替换用户名和地址
确保 SSH 转发正常,服务器开启端口转发:AllowTcpForwarding yes
##本地known_hosts冲突或者服务器重装过系统
##地址填你自己对应的
ssh-keygen -R 123.56.117.132https://cdn.nlark.com/yuque/0/2026/png/59621818/1773165216582-48ef0a37-4be9-4214-8a0d-59de5a401972.png
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773167115723-d5b4efee-df47-4f48-9b8f-89ce7ba04d6a.png
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773167256041-87afe72c-cf5d-4a62-920a-d0da6dc5b517.png
如果远程连接不上,查看服务器端口是否放行,端口转发是否为yes(AllowTcpForwarding yes)
9.获取访问Token

cat /root/.openclaw/openclaw.json | grep token1.解决 openclaw 命令无法使用问题

echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc



2.验证openclaw 命令,查询openclaw状态

openclaw status

3.通过powershell shh链接ubuntu

ssh -N -L 18789:127.0.0.1:18789 ubuntu@172.16.175.146

4.window 访问openclaw web ui

http://localhost:18789/#token=替换为安装后生成的token
要先本地连接ssh服务才能这样用否则回环地址无效 确保 SSH 转发正常,服务器开启端口转发:AllowTcpForwarding yes
二、接入飞书

1.进入飞书开放平台

飞书开放平台
点击进入开发者后台
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773189255177-a0443eb5-0d05-49b4-9d06-05922f08734b.png
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773189618825-9b8626e9-fab5-4a56-8fbc-f4717a024420.png
填写名称和描述,然后创建应用,可以定义他的图标和颜色,我这里已经有一个机器人了,我就不创建了
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773189869926-cf54f286-b90c-4ef3-a747-8f8122b03db7.png
2.飞书机器人权限


[*]进入「权限管理」
[*]点击「导入权限」,粘贴以下 JSON 权限配置(可按需精简):
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773216548707-79a1a7be-a370-4237-8a39-5d58f5bbe5ab.png

{
"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:contact.base:readonly",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:app_feed_card:write",
      "im:biz_entity_tag_relation:read",
      "im:biz_entity_tag_relation:write",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.announcement:read",
      "im:chat.announcement:write_only",
      "im:chat.chat_pins:read",
      "im:chat.chat_pins:write_only",
      "im:chat.collab_plugins:read",
      "im:chat.collab_plugins:write_only",
      "im:chat.managers:write_only",
      "im:chat.members:bot_access",
      "im:chat.members:read",
      "im:chat.members:write_only",
      "im:chat.menu_tree:read",
      "im:chat.menu_tree:write_only",
      "im:chat.moderation:read",
      "im:chat.tabs:read",
      "im:chat.tabs:write_only",
      "im:chat.top_notice:write_only",
      "im:chat.widgets:read",
      "im:chat.widgets:write_only",
      "im:chat:create",
      "im:chat:delete",
      "im:chat:moderation:write_only",
      "im:chat:operate_as_owner",
      "im:chat:read",
      "im:chat:readonly",
      "im:chat:update",
      "im:datasync.feed_card.time_sensitive:write",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "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.urgent",
      "im:message.urgent.status:write",
      "im:message.urgent:phone",
      "im:message.urgent:sms",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_depts",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "im:tag:read",
      "im:tag:write",
      "im:url_preview.update",
      "im:user_agent:read",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "contact:contact.base:readonly",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
}
}https://cdn.nlark.com/yuque/0/2026/png/59621818/1773216656457-fa329d42-997c-4ee9-8bdb-1ef7fa18d5b3.pnghttps://cdn.nlark.com/yuque/0/2026/png/59621818/1773216701040-22bcdbdf-c9c3-4968-bcb5-323d14a9bbfc.png
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773216736068-1bb5214b-c1a4-4a37-999e-673c9e5a1d10.png
3.添加应用能力


[*]在「应用能力」中启用「机器人」
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773217721122-7b5b62ad-dc6a-4415-9881-c5d3cc23e23c.png
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773217724689-e7f675ba-d4bb-4f23-ab8a-01cc8c99897e.png
4.openclaw配置飞书

4.1.添加飞书渠道

openclaw channels add选择yeshttps://cdn.nlark.com/yuque/0/2026/png/59621818/1773226195091-1b3c79da-da21-402a-b054-fa74b0236581.png
选择飞书
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773226215906-89df4aeb-db27-464f-b8b0-fd2a4569e415.png
选择npm安装
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773230755825-542d6278-11de-465e-a075-f704860323b2.png
选择第一个App Secrethttps://cdn.nlark.com/yuque/0/2026/png/59621818/1773230863364-165ba6b3-0725-43b0-bc71-2fb48549a3b0.png
这里提示要输入 APP Secret ,我们去飞书开放平台复制
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773231059556-e9550c95-a156-4c6f-b6f4-0ebe6fafca48.png
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773231038527-76e2b506-f5a9-403f-b875-2fe31dd2c95b.png
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773231283771-750bc040-d839-4eb7-848b-4724d312eb99.png
默认回车就行
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773231230537-45678fcc-fcfb-4211-858b-1f8cb8b6a67c.png
china
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773231320863-dddfc82c-167a-4ea0-be60-af4b2b7c966a.png
选择第二个
Open - respond in all groups (requires mention)
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773231349472-f36aa056-4d25-470d-b4d6-08a66e2f54e2.png
Finished
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773231432902-2742e8aa-de27-479f-ad37-e16223040297.png
yes
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773231516694-657ad8e9-e31f-4a3a-9149-e73cc61690f4.png
openhttps://cdn.nlark.com/yuque/0/2026/png/59621818/1773231542363-5e4301fe-e0bc-49da-9824-c0b3ce9706c6.png
如图选择进行操作
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773231631252-e176b3d3-918f-4c96-8a2f-d86ac3761a2e.png
4.2.重启网关

输入命令重启网关然后会到飞书开放平台
openclaw gateway restart4.3.配送飞书事件订阅

⚠️ 注意:在配置事件订阅前,请确保已完成 OpenClaw 渠道添加并启动网关。

[*]进入「事件订阅」
[*]选择 「使用长连接接收事件」(WebSocket)
[*]添加事件:im.message.receive_v1
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773232020399-de71a636-6168-44b5-aca2-426126e23817.png

4.4 发布应用


[*]进入「版本管理与发布」
[*]创建版本,提交审核(企业自建应用通常自动通过)
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773232338926-1d07a9a1-79a7-4aab-aec6-810314ba518b.pnghttps://cdn.nlark.com/yuque/0/2026/png/59621818/1773232509426-719598d6-ba51-4b5a-9335-c3eea72b7729.png
三、验收

1.发送测试消息


[*]在飞书客户端中搜索你的应用名称
[*]进入聊天窗口,发送消息
[*]机器人应能正常回复
https://cdn.nlark.com/yuque/0/2026/png/59621818/1773232810674-44d21992-2c79-458f-993a-13648d1db5cb.pnghttps://cdn.nlark.com/yuque/0/2026/png/59621818/1773233216963-e591e78b-cfc1-4d48-8f71-f0c6dd025eb3.png

五、总结

✅ 已完成内容

1. 环境搭建


[*]Ubuntu 系统基础环境配置
[*]Node.js 运行环境安装
[*]OpenClaw 核心服务部署
2. 大模型集成


[*]选择 Kimi 作为对话模型
[*]配置 API Key 认证
[*]完成模型与 OpenClaw 的对接
3. 飞书机器人接入


[*]创建飞书企业自建应用
[*]配置应用权限和机器人能力
[*]通过 OpenClaw 添加飞书渠道
[*]设置 WebSocket 长连接接收消息事件
4. 本地访问配置


[*]SSH 端口转发实现本地访问 Web UI
[*]获取访问 Token 进行安全认证

来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!

幽淆 发表于 1 小时前

这个好,看起来很实用
页: [1]
查看完整版本: Ubuntu 云服务部署 OpenClaw 并接入飞书机器人