
目标:Linux云服务器安装openclaw,并对接飞书通道
文档 https://docs.openclaw.ai/zh-CN
也可以查看官网教程安装:https://docs.openclaw.ai/zh-CN/start/getting-started
1.安装OpenClaw
注意选择环境
curl -fsSL https://openclaw.ai/install.sh | bash


2.运行新手引导
新手引导会配置认证、Gateway 网关设置和可选渠道
openclaw onboard --install-daemon
> 我在执行这个命令的时候还报错了,
<--- Last few GCs --->
[7785:0x70d7000] 41869 ms: Mark-Compact 801.7 (821.1) -> 801.0 (822.1) MB, pooled: 2 MB, 1952.46 / 0.00 ms (average mu = 0.054, current mu = 0.005) allocation failure; scavenge might not succeed
<--- JS stacktrace --->
FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of memory ----- Native stack trace -----
原因是我的云服务器配置太低,内存不够用了,设置一下虚拟内存,然后再次执行:
NODE_OPTIONS="--max-old-space-size=1024" openclaw onboard --install-daemon
若没有报错请忽略,直接执行openclaw onboard --install-daemon即可
执行成功后的样子

3.开始配置,按步骤如下
下面两个配置,为了快速搭建,可以选择如下:

4.选择大模型
这里以阿里百炼为例
2026年3月23日记录,发现我使用的大模型总是报错:HTTP 401: invalid access token or token expired,可能是我的额度问题,所以这里不保证接入百炼能够正常使用,如果你有自己的大模型,最好使用你自己的,在下面选择即可

试用百炼大模型,要先注册阿里百炼平台,会赠送一些大模型的免费额度,如果只是试用,记得设置用完即停,不然免费额度用完后会自动计费

创建api key


回车后,可以看到默认模型是modelstudio/qwen3.5-plus,可以进行修改,我这个模型没有免费额度了,换一个

选一个阿里百炼的模型

5.选择通道
配置通道,这里以飞书为例

首次安装选第一个


安装成功后进行飞书的配置,在此之前我们需要先在飞书开放平台配置一下
(1).创建一个应用,名字和描述随便写

(2).创建机器人

(3).修改权限,粘贴复制下方内容

bash
{
"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:chat",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.members:bot_access",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.group_msg",
"im:message.p2p_msg:readonly",
"im:message:readonly",
"im:message:send_as_bot",
"im:resource",
"sheets:spreadsheet",
"wiki:wiki:readonly"
],
"user": [
"aily:file:read",
"aily:file:write",
"contact:contact.base:readonly",
"im:chat.access_event.bot_p2p_chat:read"
]
}
}
(4).复制app id和secret,填入终端中


(5).配置飞书 事件与回调
订阅方式选择 长连接订阅方式(不可选 HTTP 回调)
添加事件:至少包含 im.message.receive_v1(接收消息)
注意:事件订阅和回调配置建议在openclaw部署完成后统一在飞书后台设置,避免向导卡住。

(6).安装向导中选择如下

6.继续配置
这里暂时禁用搜索(Skip),只用大模型

这里暂时跳过skills配置

下面这些配置先跳过,是一些工具配置,不影响openclaw启动,有兴趣可以详细去了解

选择session-memory
作用:
- 缓存对话历史,减少重复请求
- 优化大模型 Token 使用
- 提升响应速度


常用命令
bash
// 查看运行状态
openclaw status
// 修改配置
openclaw config
// 启动openclaw
openclaw gateway
// 重启
openclaw gateway restart