服务器部署OpenClaw教程

一、 环境要求

●系统：Ubuntu 24.04.4 LTS (Server)

●内存：≥ 2GB（推荐 4GB+）

●Node.js：≥ v22（必须）

●权限：root 或 sudo 用户

二、 安装步骤

1、 系统更新与依赖安装

# 更新系统sudo apt update && sudo apt upgrade -y# 安装基础工具sudo apt install -y curl git build-essential

2、 安装 Node.js 22+（推荐 nvm）

# 安装 nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash# 加载 nvm（或重启终端）source ~/.bashrc# 安装 Node.js 22 LTSnvm install 22nvm use 22nvm alias default 22# 验证node -v  # 应输出 v22.x.xnpm -v

3、 安装 OpenClaw（OpenClaw 2026.3.28 正式版）

方式 一：一键脚本（最简单、耗时长）

curl -fsSL https://openclaw.ai/install.sh | bash

方式 二：npm 全局安装（速度快）

# 可选：设置淘宝镜像加速npm config set registry https://registry.npmmirror.com/# 全局安装npm install -g openclaw@latest# 验证openclaw --version

4、初始化配置（关键）

# 启动配置向导openclaw onboard

向导选项：

I understand... → Yes（方向键选择，按回车键）

Onboarding mode → QuickStart（快速开始）

Model/auth provider → Moonshot AI (Kimi K2.5) (Kimi K2.5)

Moonshot AI (Kimi K2.5) auth method → Moonshot API key (.cn)

Enter Moonshot API key (.cn) → 你的key

Default model → Keep current (moonshot/kimi-k2.5)

Select channel (QuickStart) → Skip for now（机器人聊天渠道，可以先不配置）

Search provider → Skip for now（联网搜索功能，暂时不用配置）

Configure skills now? (recommended) → No

Enable hooks? → Skip for now（空格键选择，然后按回车键）

How do you want to hatch your bot? → Do this later

5、 开网关

方式一：关闭窗口网关会关闭，下次使用时需要重新输入下方命令，同时再开一个窗口执行其他命令

openclaw gateway run

方式二：关闭窗口网关不关闭，一直后台运行

nohup openclaw gateway run > /dev/null 2>&1 &

6、 运行

openclaw tui

7、 新增模型（智谱）

向导选项：

I understand... → Yes（方向键选择，按回车键）

Onboarding mode → QuickStart（快速开始）

Config handling→ Use existing values

Model/auth provider → Z.AI (GLM Coding Plan / Global / CN)

Z.AI auth method → CN (Z.AI CN (open.bigmodel.cn))

Enter Moonshot API key (.cn) → 你的key

Default model → zai/glm-5

其他向导选项和上面选择一致

查看模型（此时应该有kimi和智谱两个模型了，默认是新添加的智谱）

openclaw models list

8、重启网关生效

pkill -f openclawopenclaw gateway runopenclaw tui

这时候由于缓存还会显示使用的是之前的模型，实际上默认模型已经是新添加的了

 agent main | session main (heartbeat) | moonshot/kimi-k2.5 | tokens 8.9k/262k (3%) 

想要清除缓存，直接删除缓存文件夹，再重启网关就生效了

rm -rf ~/.local/share/openclaw/

9、切换模型

切换到 智谱 GLM-5

openclaw models set zai/glm-5

切换到 Kimi

openclaw models set moonshot/kimi-k2.5

10、添加机器人（以飞书为例）

先在飞书开放平台创建机器人（https://app.feishu.cn/）

进入首页，点击右上角创建应用

点击开发者后台

创建企业自建应用

左侧 → 凭证与基础信息，记录下 App ID 和 App Secret，后面会用到

左侧 → 添加能力 → 添加机器人

左侧 → 权限管理→ 批量导入

im:message:send_as_bot（发消息）

im:message:readonly（读消息）

im:message.p2p_msg:readonly（私聊）

im:message.group_at_msg:readonly（群 @）

im:chat.access_event.bot_p2p_chat:read（访问事件）

左侧 → 事件与回调 → 订阅方式

选择 使用长连接接收事件（WebSocket），点击保存

添加事件：im.message.receive_v1

左侧 → 版本管理与发布

创建版本（1.0.0）→ 保存 → 发布（企业版要管理员审批）

11、回到 OpenClaw 配置飞书

关闭网关

pkill -f openclaw

添加飞书渠道

openclaw channels add

向导选项：

Configure chat channels now? → Yes

Select a channel → Feishu/Lark (飞书) (configured)

How do you want to provide this App Secret? → Enter App Secret

Enter Feishu App Secret → 输入你的 App Secret 按回车确认

Enter Feishu App ID → 输入你的 App ID 按回车确认

Feishu connection mode → WebSocket (default) ，这个是免配置、最稳定的模式，不用自己搭公网域名。

Which Feishu domain? → Feishu (feishu.cn) - China，国内飞书就用这个，直接回车继续。

Group chat policy → Open - respond in all groups (requires mention)，群里只有 @机器人才会回复，最省心、不会乱插话。

Select a channel → Finished

Configure DM access policies now? (default: pairing) → No，后面需要私聊再开配对，不影响群聊使用。

Add display names for these accounts? (optional) → No

Bind configured channel accounts to agents now? → Yes

Route feishu account "default" to agent → main (default)

然后重启网关就生效了：

pkill -f openclawopenclaw gateway run

12、飞书客户端使用机器人

飞书客户端 → 搜索 你应用的名字（如 OpenClaw）

第一次会提示 配对（pairing）

按提示在终端执行：

openclaw pairing approve feishu xxxxx

再发消息就会正常回复 AI 了。

13、删除机器人

要删除刚配置的飞书 (Feishu/Lark) 机器人，需要分两步：先在 OpenClaw 中移除通道绑定，再去飞书后台删除应用

停止服务

pkill -f openclaw

删除 OpenClaw 里的飞书通道

方法 1：命令行删除（最快）

# 移除飞书账户（default）并清理配置openclaw channels remove --channel feishu --account default --delete

方法 2：重置配置（彻底）

如果只想清掉所有通道配置，保留模型 / 密钥：

openclaw onboard --reset --reset-scope config

重新走一遍向导，其他选项正常选择，下面这个选项选择 All providers

Filter models by provider → All providers，这样之前配置的智谱 GLM-5、Kimi 都会保留，不用重新配置。

Select channel (QuickStart) → Skip for now

验证是否删除：

openclaw channels list

控制台会输出：

Chat channels:- Feishu default: not configured, enabled

方法3：手动清理配置

直接编辑配置文件，删除飞书相关内容：

nano ~/.openclaw/openclaw.json

找到并删除整个 feishu 块：

// 删除以下内容"feishu": {"default": {"appid": "cli_xxx","appsecret": "xxx","enabled": true  }}

同时删除 bindings 里飞书相关的路由规则

重启网关：

openclaw gateway run

14、删除飞书后台应用（如果想在飞书侧也删掉机器人）

打开 飞书开放平台 → 企业自建应用

点击想要删除的应用

拉到最下面，点击删除应用

15、安装 Skills 

此版本openclaw自带常用的skills，不需要手动安装。

今日的分享就到这里，对OpenClaw实现原理感兴趣的同学可以回复关键字【龙虾】领取以下资料。