OpenClaw 完全指南:从安装到飞书接入再到省 Token 秘笈
本文将带你一步步搭建 OpenClaw 环境,接入飞书,并分享如何节省 Token 的实战技巧。
一、OpenClaw 的安装
1.1 环境准备
-
操作系统: Linux (Ubuntu 20.04+ / Debian 11+) 或 macOS
-
Node.js: v18+
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash –
sudo apt-get install -y nodejs -
运行环境: Python 3.10+ (部分功能需要)
sudo apt update && sudo apt install build-essential python3
1.2 安装步骤
# 安装 OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash
1.3 配置向导
openclaw onboard
键盘控制: 单选框,上下左右方向键;多选框,空格键;确认,Enter键

这里是单用户使用,选择YES

引导模式使用快速启动

这里选择MiniMax,性价比高

使用授权模式,节省Tokens开销技巧之一

大模型用的是国际版,懂得都懂,限制较少,而且还送十几天免费试用 
这里自动打开的登陆网页是minimax.io

注册登录完成后,回到命令行就可以选择大模型

配置飞书这些暂时跳过

搜索模型也跳过
配置skills跳过

这里全选上

安装服务,这里我已经安装了

完成配置,成功的话就可以启动WebUI聊天

网页端输入http://127.0.0.1:18789,查看到健康状态是绿灯且正常,就可以在聊天框试试聊天了
二、接入飞书
2.1 安装飞书插件
openclaw plugins install @m1heng-clawd/feishu
2.2 创建飞书应用
1.打开 飞书开放平台
2.创建企业自建应用

2.3 添加机器人
左侧点「添加应用能力」→ 按能力添加 → 机器人 → 添加

2.4 配置应用权限
左侧点「权限管理」→ 开通权限 (以下为必要的权限)

配置完成,这里先发布一次版本,以便后续操作

2.5 OpenClaw 飞书配置
左侧点「凭证与基础信息」→ 分别复制AppID和App Secret→ 回到刚才命令行终端配置
# 设置App ID
openclaw config set channels.feishu.appId "xxx"
# 设置App Secret
openclaw config set channels.feishu.appSecret "xxx"
# 启用飞书通道
openclaw config set channels.feishu.enabled true
# 使用websocket连接模式
openclaw config set channels.feishu.connectionMode "websocket"
# 重启服务
openclaw gateway restart
2.6 配置事件回调
左侧点「事件与回调」→ 修改事件配置的订阅方式,这里就可以选择长连接

同样回调配置的订阅方式,选择长连接

在事件配置中,添加以下事件权限

配置完成,这里再发布一次版本,才能修改生效

2.7 验证接入
# 重启服务
openclaw gateway restart
在飞书搜索框搜索你的应用名称,点击就可以开启聊天了
三、节省 Tokens 大法
官方模型虽好,但烧钱。本文教你省 Token!
3.1 使用Auth授权方式
- API KEY方式比授权方式要更贵
3.2 心跳使用本地模型
安装本地模型
# 安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh
# 下载并启动模型
ollama run qwen2.5:3b
在 ~/.openclaw/openclaw.json 中:心跳配置使用本地模型(添加ollama和heartbeat节点)
{
"models": {
"mode": "merge",
"providers": {
"minimax": { … },
"minimax-portal": { … },
"ollama": {
"baseUrl": "http://127.0.0.1:11434",
"models": [
{
"id": "qwen2.5",
"name": "Qwen 2.5",
"reasoning": true,
"input": ["text"],
"contextWindow": 65536,
"maxTokens": 8192
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "minimax/MiniMax-M2.5",
"fallbacks": [
"google/gemini-flash-latest",
"minimax/MiniMax-M2.5-highspeed",
"minimax-portal/MiniMax-M2.5-highspeed",
"minimax-portal/MiniMax-M2.5-Lightning"
],
"heartbeat": "ollama/qwen2.5"
}
}
}
}
重启服务即可生效
3.3 QMD
QMD (Prompt Memory Delta) 是 OpenClaw 的核心省 Token 机制。
工作原理
┌─────────────────────────────────────┐
│ 系统提示词 (首次) │
│ (完整的人物设定、规则、技能) │
└──────────────┬──────────────────────┘
│
▼
┌─────────────────────────────────────┐
│ QMD 对话历史摘要 │
│ (仅保存关键信息,压缩再压缩) │
└──────────────┬──────────────────────┘
│
▼
┌─────────────────────────────────────┐
│ 本次用户输入 │
└─────────────────────────────────────┘
安装QMD和SQLite
# 安装qmd
npm install -g @tobilu/qmd
# 安装sqlite
sudo apt install sqlite3
配置QMD
在 ~/.openclaw/openclaw.json 中:
"memory": {
"backend": "qmd",
"qmd": {
"update": {
"interval": "5m"
}
}
},
重启服务
openclaw gateway restart
以上就是OpenClaw 完全指南,让你可以愉快地玩耍了。
最后如何想要授予OpenClaw完全权限,执行各种命令(除了root权限还需你自己操作)
在 ~/.openclaw/openclaw.json 中:
"tools": {
"profile": "full"
},
然后重启服务就可以了。


