MaxClaw 是基于 OpenClaw 框架构建的国产“龙虾”，本文记录安装流程。

简介

OpenClaw 是一个开源的 AI Agent 网关框架（Github: github.com/openclaw/openclaw），负责：

• 把 AI 模型接入各种聊天平台（Telegram、WhatsApp、Discord 等）
• 管理 Agent 的工作空间、工具权限、记忆文件
• 提供本地自托管能力

MaxClaw 是基于 OpenClaw 框架构建的产品/客户端，背后调用的是 MiniMax 的模型

安装流程

MaxClaw 获取

官方网站：https://agent.minimaxi.com/

获取 MaxClaw ，入门 39￥/月

此时已经可以在网页端正常使用了，但是此时是在云端沙盒运行的 Agent，如果需要本地部署需要一些步骤

安装环境

这里记录我的安装环境：

• 操作系统 ： Ubuntu 22.04
• npm：10.9.4
• node.js : v22.22.0

飞书配置

这里我决定使用飞书作为通信工具

• 申请飞书帐号

• 登录 飞书开放平台

• 创建应用

  

  

• 添加机器人功能

• 创建版本，确认发布

  

• 开通权限

  {
  “scopes”: {
  “tenant”: [
  “im:message:send_as_bot”,
  “docx:document:readonly”
  ],
  “user”: [
  “docx:document:readonly”
  ]
  }
  } 可以逐个权限添加，例如： im:message:send_as_bot（发消息）

  

  

• 也可以批量导入，将如下 json 导入到 批量导入权限中即可：

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

  { "scopes": { "tenant": [ "im:chat", "im:message", "im:message:send_as_bot", "im:message.group_at_msg:readonly", "im:message.p2p_msg:readonly", "im:message:readonly", "im:resource", "im:chat.members:bot_access", "contact:user.employee_id:readonly" ], "user": [ "im:chat.access_event.bot_p2p_chat:read" ] } }

安装流程

• 执行安装命令

1
2

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

• 开启路由

  

• 创建 Session 保存目录

  

• 使用 zsh

  

• 开启路由服务

  

• 这时候应该已经可以通过 Dashboard 访问我们的机器人了

  1 2	Dashboard URL: http://127.0.0.1:18789/#token=xxxxxxxxxx

  

• 继续构建

  

• 快速开始，使用已有的参数

  

• 使用模型，这里选择 MiniMax

  如果需要重新配置模型，执行命令

  1	openclaw configure --section model

  

  

  

• 授权

  

• 默认模型

  

• 通信工具

  

  

• 按需配置 skills

  

• Ubuntu 终端运行

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

# 写入飞书配置（注意：不要运行 openclaw doctor，否则会重置！）
cat > ~/.openclaw/openclaw.json << 'EOF'
{
  "gateway": {
    "mode": "local"
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "accounts": {
        "default": {
          "appId": "你的AppID",
          "appSecret": "你的AppSecret",
          "botName": "AI助手"
        }
      }
    }
  }
}
EOF
# 重启网关
openclaw gateway restart

看到 feishu configured, enabled automatically 就说明成功了

配置飞书回调

• 添加事件回调

• 事件订阅

  添加 im.message.receive_v1，选长连接

  

• 创建版本

测试消息

• 通过飞书客户端向机器人发消息进行测试

  

• 这时候把这条信息发给本地的 OpenClaw 他可以帮你配置

  

• 在飞书里发消息给他

  

• 这时候本地的网页版会收到同样的消息

  

  说明我们的本机工作助理配置顺利完成 ～

其他配置

• 升级 OpenClaw

  1	openclaw update

• 切换模型

  1

  /model

• 查看状态

  1

  /status

• 修改配置（飞书、模型配置）

  修改配置文件 ~/.openclaw/openclaw.json

文章链接：
https://www.zywvvd.com/notes/study/llm/miniclaw-install/miniclaw-install/