前言

前几个月Openclaw火了起来,在我看来其实挺莫名其妙,但是却冥冥之中又带点道理,无非就是做了三件事情

  1. 将Skill的标准化实现了

  2. 实现了history/ memory机制

  3. 将human ask - robot think - human do 直接变成了 human ask - robot think - robot do

最近我也在部署,但是想着这个部署过程中还是有一点小坑的,以防万一,记录一下。

P.S.: 因为现在AI发展的很快,一切都很有时效性,所以现在的一切都基于Openclaw 3.8 (3caab92)。

正文

1. Openclaw部署

说实话 Openclaw部署还是挺简单的,跟着 Openclaw 官方文档 走就行了。

1.1 openclaw下载 与 安装

首先输入命令(MacOS、Linux) curl -fsSL https://openclaw.ai/install.sh | bash

对于Windows而言输入命令 iwr -useb https://openclaw.ai/install.ps1 | iex

然后开始安装:

admin@xxxxxxxxxxxxxxxxxxx:~$ curl -fsSL https://openclaw.ai/install.sh | bash

🦞 OpenClaw Installer
Type the command with confidence—nature will provide the stack trace if needed.

✓ Detected: linux

Install plan
OS: linux
Install method: npm
Requested version: latest

[1/3] Preparing environment
· Node.js not found, installing it now
· Installing Node.js via NodeSource
· Installing Linux build tools (make/g++/cmake/python3)

然后选择Yes

然后选择QuickStart

然后选择 OpenAI

然后选择OpenAI API key,这个选择什么先不重要,后面我们再设置就好:

然后选择 Paste API key now

这里随便输入一个 sk-abc 就可以了,因为我们后面用的是 Minimaxi 的api:

这个地方就选择一个 Keep current (openai/gpt-5.1-codex) 就可以了:

这个地方channel 其实我们要选择channel,但是我们之后再添加,我们先选择 Skip for now

然后search provider 我们选择 Skip for now

skill什么的我们之后再配置,现在的大多数都需要api,点进去也配置不了:

hooks的话,我们现在先 Skip for now

然后我们选择 Do this later

然后我们现在 openclaw 其实框架已经安装好了,但是我们因为没有配置任何的东西,所以我们现在开始要给他加配置,比如:

  1. 接入大模型,让他说话,我们下面会选择minimax

  2. 接入飞书,这样我们飞书群里面可以直接调用,不用来服务器里面这么麻烦

1.2 openclaw: command not found

如果发生这种情况的话,但是安装过程中没有发现任何的错误的话,说明我们的OpenClaw 装着,但是 PATH 里没有它的安装目录,我们输入下面的命令

echo 'export PATH="/home/admin/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

然后就成功啦!

2. 大模型接入

2.1 Minimaxi 接入

输入 openclaw configure 进行配置,这是未来 配置openclaw 最重要的命令之一:

openclaw configure

选择 Local (this machine)

因为我们是要接入模型 所以选择 Model

我们选择 MiniMax,因为我这里的 MiniMax 的大模型api:

我们是 中国的api 所以选择 MiniMax M2.5 (CN)

我们先去MiniMax官网,拿到MiniMax 的api,如果没有的话看,我们先创建新的API Key:

然后选择 Paste API key now

然后把MiniMaxi的API放进来,回车:

然后选择 minimax-cn/MiniMax-M2.5 ,回车:

然后选择 Continue 就结束了:

2.2 tui 测试

然后我们输入 openclaw tui 命令测试一下结果:

3. Channel接入

3.1 前置条件: 允许本地预安装的飞书插件

# 允许插件
openclaw config set plugins.allow '["feishu"]'
# 重启 gateway
systemctl --user restart openclaw-gateway

3.2 飞书接入

输入 openclaw configure 进行配置,这是未来 配置openclaw 最重要的命令之一:

openclaw configure

选择 Local (this machine)

选择 Channels

选择 Configure/ link

选择 Feishu/Lark (飞书)

我们选择 Use local plugin path

3.3 飞书接入 II

根据 openclaw给的流程,我们一步一步做

  1. 先去飞书开发者平台

  2. 然后选择 创建企业自建应用

  3. 然后把后台得到的 App IDApp Secret 放在下面

  4. 启用 机器人能力

  5. 然后 允许一系列的权限

  6. 然后 配置事件订阅

  7. 然后 发布

  8. 选择 测试的组 进入

我们先到飞书开发者平台,建立一个企业自建应用:

然后按需填入 应用名称 和 应用描述:

然后我们把后台得到的 App ID 和 APP Secret获得到,在这个地方:

然后把 App Secret 和 App ID 复制到这里:

这里会显示 Connection failed: API error: app do not have bot,这个报错很正常 因为我们现在还没有在飞书启动机器人服务,我们待会儿启动机器人服务的时候重新再来一遍就可以了,这里我们选择 WebSocket (default)

然后我们选择 Feishu (feishu.cn) - China

我们这里选择 Allowlist - only respond in specific groups

我们这里输入我们自己的飞书群:

手机版飞书 ID在设置最下面:

我们现在回到飞书后台,实现下面几个操作:

  1. 启用 机器人能力

  2. 然后 允许一系列的权限

  3. 然后 配置事件订阅

我们先 启用 机器人能力

然后我们 加入权限

复制以下权限,去批量导入权限:

{
  "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:read",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

然后开始 配置事件订阅

订阅方式选择 长连接 接收事件:

我们发现这个问题,让我们先发布一下版本,然后再来修改事件:

版本详情按需填写即可:

我们再走一边 刚刚的channel流程,会发现可以连通了:

然后连通之后 我们再回到,订阅方式选择 长连接 接收事件:

然后我们 添加以下事件:

  • im.message.receive_v1- 接收消息

  • im.message.message_read_v1- 消息已读回执

  • im.chat.member.bot.added_v1- 机器人进群

  • im.chat.member.bot.deleted_v1- 机器人被移出群

然后我们现在再发布一次 (创建一次版本)

版本号要与之前不同:

到这里为止,我们的机器人就已经配置完了。

3.4 将机器人 接入飞书

让我们来测试一下,打开飞书 > 选择群机器人 > 添加:

发现,成功!

4. Openclaw TUI 和 Web UI

4.1 TUI

直接输入命令 openclaw tui,如下:

4.2 Web UI

直接输入命令 openclaw dashboard,如下:

如果在此之前我们需要给admin用户改密码(因为这里是admin登录,那我们需要输入命令如下,并且输入两次密码用于确认)

sudo passwd admin

这个地方我们先要输入命令把远程的应用 端口转发到 我们本地

ssh -N -L 18789:127.0.0.1:18789 admin@<我们的openclaw服务器IP>

这里的 openclaw服务器 是我们的openclaw服务器IP,然后本地登录一下,如果一直是这个页面,说明成功了,如果是permission denied 说明有可能是密码输入错误,没有成功:

然后我们浏览器里面访问 http://localhost:18789/#token=871016eb5a6ff5164660b0854ee4e762c65f746f6bd74452 ,这个token每个人不一样,复制自己的,页面如下:

总结

总结就是:

  1. 一条命令一键部署 openclaw: curl -fsSL https://openclaw.ai/install.sh | bash

  2. 大模型 和 飞书 的接入 用命令: openclaw configure

  3. TUI用 openclaw tui, Web UI用 openclaw dashboard

参考

[1] Openclaw Getting Start

[2] Openclaw 接入飞书

立志做一个有趣的碳水化合物。