🦞 OpenClaw 完全配置优化指南
从安装到省 Token 的保姆级教程 —— 不同环境部署 · 核心配置详解 · 省 Token 实战 · 插件技能推荐
🦞 版本 2026.9.4 · 📚 保姆级 · 💰 省 Token 实测
📖 本文目录
🦞一、OpenClaw 是什么
OpenClaw 是一个由 开发者 Peter Steinberger 于 2025 年 11 月以 Clawdbot 之名发起、2026 年 7 月移交 OpenClaw Foundation（美国 501(c)(3) 非营利组织）托管后继续维护的开源 自托管 AI Agent 网关。它的核心设计理念是： 运行一个 Gateway 进程，把 AI 接入你已有的所有聊天应用。
你可以在微信、飞书、Telegram、Discord、Slack、WhatsApp、iMessage 等多个平台里，直接发消息跟 AI 对话。它不是一个新的聊天 App，而是一个 让你现有的聊天 App 都能用上 AI 的网关。
核心特点： 多渠道消息网关 · 插件+技能双轨扩展 · 子智能体支持 · 浏览器自动化 · macOS 原生 App · 成熟稳定的生态
🚀二、不同环境安装方法
🍎 macOS（推荐，最省心）
方法一：下载 .app（最简单）
- 访问官方站点 openclaw.ai（下载入口以站点实际导航为准）
- 下载 macOS 版本的 OpenClaw.app
- 拖入 Applications 文件夹，双击打开
- 首次打开右键 → 打开（绕过 Gatekeeper）
- 按向导完成初始配置，Gateway 会自动以 LaunchAgent 后台运行
方法二：Homebrew（开发者推荐）
brew install openclaw # Homebrew formula 由社区维护，版本可能滞后于官方发布
openclaw setup # 运行初始配置向导（官方文档主推；另有 openclaw init 写法，请以 openclaw --help 为准）方法三：npm 全局安装（推荐，通用）
# 官方主推 npm 渠道（需 Node.js 18+）npm install -g openclaw🐧 Linux（服务器/桌面）
一键安装（推荐 Ubuntu/Debian/CentOS）
npm install -g openclaw
openclaw setupDocker 部署（服务器推荐）
docker run -d \
--name openclaw \
-p 18789:18789 \
-v ~/.openclaw:/root/.openclaw \
-v /var/run/docker.sock:/var/run/docker.sock \
--restart unless-stopped \
ghcr.io/openclaw/openclaw:latestsystemd 服务（开机自启）
sudo openclaw service install # 安装 systemd 服务
sudo systemctl enable openclaw # 开机自启
sudo systemctl start openclaw # 启动🪟 Windows
方法一：WSL2（推荐，兼容性最好）
# 在 PowerShell 中启用 WSL2
wsl --install
# 进入 Ubuntu 后执行
npm install -g openclaw方法二：原生 Windows 安装
# 下载 Windows 安装包
# 官方站点：openclaw.ai
# 或使用 npm（需 Node.js 18+）
npm install -g openclaw📦 其他环境
树莓派 / ARM 设备： 使用 Docker 部署，镜像支持 linux/arm64
NAS（群晖/威联通）： 在 Container Manager 中添加 ghcr.io/openclaw/openclaw
云服务器（阿里云/腾讯云/AWS）： 推荐 Docker + systemd，注意开放 18789 端口（或用反向代理）
源码安装（开发者）：
git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm run build
node dist/index.js gateway💻三、桌面版 vs 终端版：双形态操作指南
OpenClaw 提供 macOS 原生桌面 App （含 Control UI Dashboard）和 openclaw CLI 终端 两种操作形态，两者连接同一个 Gateway 后端，可同时使用。以下是常用操作的双版本对比：
| 操作 | 🖥️ 桌面版（macOS App / Control UI） | 💻 终端版（openclaw CLI） |
|---|---|---|
| 启动 Gateway | 双击 OpenClaw.app，菜单栏 → Start | openclaw gateway start |
| 停止/重启 | 菜单栏 → Stop/Restart | openclaw gateway stop —force / restart |
| 打开 Dashboard | App 内自动显示，菜单栏 → Open Dashboard | openclaw dashboard（浏览器打开） |
| 查看状态 | Dashboard 首页显示 Runtime/Connectivity | openclaw gateway status |
| 配置模型 | Dashboard → Settings → Models，可视化添加/切换 | openclaw config set agents.defaults.model ”…” |
| 安装插件 | Dashboard → Plugins → 搜索 → Install | openclaw plugins install @openclaw/feishu |
| 安装技能 | Dashboard → Skills → ClawHub 浏览 → Install | openclaw skills install @owner/name |
| 查看 Token 用量 | Dashboard → Usage，7/30/90 天图表+按模型/渠道统计 | 对话中 /usage full |
| 添加渠道 | Dashboard → Channels → Add Channel，向导式配置 | openclaw channels add feishu |
| 诊断修复 | Dashboard → Settings → Diagnostics → Run Doctor | openclaw doctor —fix |
| 查看日志 | Dashboard → Settings → Logs，实时滚动 | tail -50 ~/Library/Logs/openclaw/gateway.log |
| 设备级设置 | Cmd-, → This Mac（语音/浏览器导入/权限） | 不支持（仅桌面版有） |
| 更新 OpenClaw | App 自动更新，或菜单栏 → Check for Updates | openclaw update |
🖥️ 桌面版优势场景
- 日常对话和配置（可视化，不用记命令）
- 查看 Token 用量图表和趋势
- 浏览和安装 ClawHub 技能
- macOS 设备级功能（语音、浏览器 cookie 导入）
- 非技术用户首选
💻 终端版优势场景
- 服务器/SSH 远程管理（无 GUI 环境）
- 自动化脚本和 CI/CD 集成
- 批量配置（config set 管道操作）
- 查看原始日志和调试
- 开发者和运维首选
第三方 GUI 工具： ClawDeck X 是社区开发的 OpenClaw 可视化管理工具，提供模型配置、频道管理、插件安装等 GUI 界面，适合不想用命令行但又用非 macOS 系统的用户。抖音搜索“ClawDeck X”可找到安装教程。
🧰四、初始配置向导
安装完成后，运行 openclaw setup（macOS App 会自动弹出），按向导完成以下步骤：
▍步骤 1：选择 Gateway 模式
- local（推荐）：仅本地访问，127.0.0.1<18789>
- lan：局域网可访问，适合多设备使用
- tailscale：通过 Tailscale 组网访问
▍步骤 2：配置模型提供商
- 选择默认提供商（DeepSeek / OpenAI / Anthropic / Ollama 等）
- 输入 API Key（DeepSeek 用户在 platform.deepseek.com 获取）
- 选择默认模型（示例：deepseek-v4-pro / deepseek-v4-flash（模型名请以你的提供商实际模型列表为准））
▍步骤 3：添加聊天渠道（可选，可后加）
- 飞书：选择飞书，按提示创建机器人并填入 App ID / App Secret
- Telegram：在 @BotFather 创建机器人，填入 Token
- Discord：在 Discord Developer Portal 创建应用
- 微信：需先安装 openclaw-weixin 插件（后面详细讲）
▍步骤 4：设置命令所有者（可选但推荐）
- 设置 commands.ownerAllowFrom 为你的渠道用户 ID
- 用于运行 /diagnostics、/config 等 owner-only 命令
验证安装： 运行 openclaw gateway status，看到 “Runtime: running” 和 “Connectivity probe: ok” 即成功。macOS 用户可直接打开 App 查看 Dashboard。
📄五、核心配置文件详解
OpenClaw 的主配置文件位于 ~/.openclaw/openclaw.json。以下是完整的配置结构和每个字段的说明：
{ // ===== Gateway 网关配置 ===== "gateway": { "mode": "local", // local | lan | tailscale "port": 18789, // 网关端口 "bind": "loopback", // loopback | lan "auth": { "mode": "token", // none | token | password | trusted-proxy "token": "你的token" // 网关认证token } },
// ===== 模型提供商配置 ===== "models": { "providers": { "deepseek": { "baseUrl": "https://api.deepseek.com", "api": "openai-completions", "apiKey": "sk-xxx", // 或用环境变量 "models": [] // 空=自动获取模型列表 } } },
// ===== Agent 配置（核心）===== "agents": { "defaults": { "model": "deepseek/deepseek-v4-pro@deepseek:setup-xxx", "subagents": { "model": "deepseek/deepseek-flash@deepseek:setup-xxx" // 子任务用便宜模型！ }, "workspace": "~/clawd", // 官方默认工作区为 ~/clawd "imageMaxDimensionPx": 1024, // 图片最大维度，降低省token "compaction": { "enabled": true, // 启用上下文压缩！ "threshold": 0.7, // 上下文用到70%时压缩 "model": "deepseek-flash" // 压缩用便宜模型 } }, "entries": { "main": { // 主 Agent 配置 "models": { "deepseek/deepseek-v4-pro": { "alias": "DeepSeek", "agentRuntime": { "id": "openclaw" } } } } } },
// ===== 心跳配置（省token关键）===== "heartbeat": { "every": "55m", // 心跳间隔，别太勤！ "model": "deepseek-flash", // 心跳用最便宜模型 "enabled": true },
// ===== 插件配置 ===== "plugins": { "entries": { "deepseek": { "enabled": true }, "browser": { "enabled": true }, "signal": { "enabled": true } } },
// ===== 元信息 ===== "meta": { "lastTouchedVersion": "2026.9.4", "migrations": { "modelPolicyAllowlist": true } }}配置修改方法： 可以直接编辑 ~/.openclaw/openclaw.json，也可以用命令 openclaw config set <路径> <值>。修改后运行 openclaw gateway restart 生效。配置会自动备份为 openclaw.json.bak。
🤖六、模型配置与路由
▍添加模型提供商
DeepSeek（国内用户首选，性价比最高）
openclaw config set models.providers.deepseek.baseUrl "https://api.deepseek.com"
openclaw config set models.providers.deepseek.api "openai-completions"
openclaw config set models.providers.deepseek.apiKey "sk-你的key"OpenAI / 兼容端点（Kimi、GLM、通义等）
# 以 Kimi 为例
openclaw config set models.providers.kimi.baseUrl "https://api.moonshot.cn/v1"
openclaw config set models.providers.kimi.api "openai-completions"
openclaw config set models.providers.kimi.apiKey "sk-你的kimi-key"本地模型（Ollama，零成本）
openclaw config set models.providers.ollama.baseUrl "http://localhost:11434/v1"
openclaw config set models.providers.ollama.api "openai-completions"▍模型路由策略（省 Token 核心）
主模型用 Pro，子任务用 Flash（省 30-40%）
# 主对话用强模型
openclaw config set agents.defaults.model "deepseek/deepseek-v4-pro@deepseek:setup-xxx"
# 子智能体（读文件、搜网页、整理信息）用便宜模型
openclaw config set agents.defaults.subagents.model "deepseek/deepseek-flash@deepseek:setup-xxx"查看当前模型和认证配置
openclaw config get agents.defaults.model
openclaw auth list # 列出所有认证配置
openclaw models list # 列出可用模型🧑💻七、子智能体配置
子智能体是 OpenClaw 的强大功能——主 Agent 可以把任务分发给专门的子 Agent。合理配置子 Agent 不仅提升效率，还能省 Token（子任务用便宜模型）。
▍查看已有 Agent
openclaw agents list
openclaw agents show main # 查看主 Agent 详情▍创建专用子 Agent（如“研究员”用便宜模型）
openclaw agents create researcher \
--model "deepseek/deepseek-flash@deepseek:setup-xxx" \
--description "专门负责网页搜索和资料整理的研究助手"▍在对话中调用子 Agent
直接在对话中说：“让 researcher 帮我搜索一下最新的 AI 新闻并整理摘要”
💰八、省 Token 优化实战（上）：配置层
社区验证数据： 合理配置后普遍可省 50-80% Token。InsiderLLM 实测从 $150/天降到 $6/天（96%），BetterClaw 实测 $166/月降到 $27/月（84%）。以下按效果从大到小排列。
🔴 优化 1：启用上下文压缩（省 50-70%，效果最大）
长会话是 Token 消耗的最大元凶。OpenClaw 会把完整对话历史每次都发给模型。启用压缩后，上下文用到阈值时自动总结历史，只保留关键信息。
# 启用压缩（最关键的一步！）
openclaw config set agents.defaults.compaction.enabled true
agents.defaults.compaction.mode
openclaw config set agents.defaults.compaction.model "deepseek/deepseek-flash@deepseek:setup-xxx"日常命令：/compact 手动压缩当前会话，/new 开新会话（最省）
🟠 优化 2：子任务用便宜模型（省 30-40%）
读文件、搜网页、整理信息这些子任务不需要强模型。给子智能体配置便宜模型，主对话仍用强模型。
openclaw config set agents.defaults.subagents.model "deepseek/deepseek-flash@deepseek:setup-xxx"🟡 优化 3：心跳调优（省 5-10%，隐形烧钱大户）
很多人没意识到：每次心跳 = 一次完整的模型调用（系统提示词 + 上下文 + 推理），因此频率与所选模型直接决定成本。心跳（Heartbeat）是 OpenClaw 的正式机制——定期判断「是否需要主动做点什么」；具体默认间隔请以本机配置为准。
# 降低心跳频率 + 用最便宜模型
openclaw config set heartbeat.every "55m"
openclaw config set heartbeat.model "deepseek/deepseek-flash@deepseek:setup-xxx"🟢 优化 4：精简系统提示和技能（省 5-10%）
每个已启用的 Skill 和插件的描述都会进入系统提示词，每次调用都要发一遍。装几十个不用的 Skill 是纯浪费。
# 查看已安装的技能和插件
openclaw skills list
openclaw plugins list
# 卸载不用的
openclaw skills uninstall <技能名>
openclaw plugins uninstall <插件名>
# 降低图片最大维度（截图多的会话省明显）
openclaw config set agents.defaults.imageMaxDimensionPx 1024🔵 优化 5：限制工具输出大小
一个命令输出几 MB 日志全进上下文会爆 Token。OpenClaw 有 runtime context-share guard 限制单工具结果，可以调小。
# 工具输出裁剪（在对话中对 Agent 说）
"运行命令时只返回最后 50 行输出"
# 或让 Agent 把输出写入文件，只返回摘要
"把日志写入 /tmp/log.txt，只告诉我有没有错误"💰九、省 Token 优化实战（下）：使用习惯层
配置与使用习惯的收益很难精确拆分（下文给出的 30% / 70% 属经验性表述，非测量结果）。以下是社区验证的最有效使用习惯：
🆕 及时开新会话
上下文超过 50% 就用 /new 开新会话，把结论用一句话带过去。不要在一个会话里连续做 20 件事。零成本，效果最明显。
🔍 先定位后阅读
让 Agent 先用 grep/搜索定位文件和行号，再只读相关部分。不要说“看看这个项目”，要说“在 src/auth/ 目录下找登录相关的代码”。
📦 批量代替逐次
“写一个 Python 脚本批量重命名所有 .jpeg 为 .jpg 并执行”比“先改这个、再改那个”省 60%+。让 Agent 写脚本一次跑完，不要一步步来。
📏 输出限长
明确说“这部分不超过 800 字”或“用 3 句话总结”，比不限制省 40%+。Agent 默认会写很长，限制长度直接省输出 Token。
📄 输出即文件
长内容让 Agent 直接写文件，对话里只保留“已写入文件 X”的确认。下次需要时直接读文件，不用从对话历史里翻。
📊 先看消耗再优化
用 /usage full 看每条回复的 Token 数和费用，用 /status 看上下文使用情况。先找到消耗大头，再针对性优化，不要盲目换模型。
日常必备 4 条指令（博客园“养虾”经验）：/stop 停止当前生成 · /status 查看状态 · /compact 压缩会话 · /new 开新会话
💬十、渠道配置详解
📘 飞书（官方原生，推荐）
- 安装飞书插件：openclaw plugins install @openclaw/feishu
- 访问飞书开放平台（open.feishu.cn），创建企业自建应用
- 获取 App ID 和 App Secret
- 配置：openclaw channels add feishu 按提示输入
- 在飞书开放平台配置事件订阅（WebSocket 模式无需公网 URL）
- 添加机器人能力，发布版本
飞书特有能力： 支持文档/多维表格/Bitable 工具，可以直接读写飞书文档、操作多维表格，这是其他渠道没有的。
💬 微信（外部插件，需单独安装）
openclaw plugins install openclaw-weixin 2. 运行配置：openclaw channels add weixin 3. 用微信扫码登录（使用腾讯 iLink Bot API，非逆向协议） 4. 仅支持私聊，不支持群聊；机器人只能回复用户先发来的消息，不能主动发起对话；用户超过 24 小时未发消息需重新建立会话；开发者亦无法将 iLink Bot 拉入微信群。这些是官方接口的限制，不是实现缺陷
注意： 微信是外部插件，稳定性不如官方渠道。如果微信是主要使用场景，建议考虑 Hermes（官方原生 iLink 支持）。
✈️ Telegram（核心内置，最简单）
- 在 Telegram 中找 @BotFather，发送 /newbot 创建机器人
- 获取 Bot Token
- 运行：openclaw channels add telegram 输入 Token
- 给你的机器人发消息即可开始对话
📋 其他渠道一览
| 渠道 | 类型 | 安装命令 |
|---|---|---|
| Discord | 官方插件 | openclaw plugins install @openclaw/discord |
| 官方插件 | openclaw plugins install @openclaw/whatsapp | |
| Slack | 官方插件 | openclaw plugins install @openclaw/slack |
| Signal | 官方插件 | openclaw plugins install @openclaw/signal |
| Matrix | 官方插件 | openclaw plugins install @openclaw/matrix |
| MS Teams | 官方插件 | openclaw plugins install @openclaw/teams |
| QQ Bot | 官方插件 | openclaw plugins install @openclaw/qq |
| 企业微信 | 外部插件 | ClawHub 搜索 wecom |
| 腾讯元宝 | 外部插件 | ClawHub 搜索 yuanbao |
| iMessage | 核心内置 | 需 BlueBubbles 服务器（macOS） |
查看所有已配置渠道：openclaw channels list
🧱十一、插件与技能市场
🏪 ClawHub（官方技能市场）
OpenClaw 官方技能和插件注册中心，类似 npm 之于 Node.js。
- 网址： clawhub.ai
- 前端界面： hub.openclaw.ai
- 规模： 各来源口径差异较大，2026 年 2–3 月的公开统计约在 1,700–8,000 之间
- 内容： 效率工具、搜索研究、工作流自动化、通信协作
📚 中文社区资源
⚠️ 注意： 以下均为第三方 / 社区站点，非官方，内容与版本可能滞后，仅供参阅：
- OpenClaw 中文站： openclaw.cn
- OpenClaw 中文文档： openclaw.cc
- 学习站： learnopenclaw.org
- 官方文档： docs.openclaw.ai
- GitHub： github.com/openclaw/openclaw
- Discord 社区： OpenClaw 官方 Discord
🔧 技能和插件常用命令
# ===== Skills 技能 =====
openclaw skills search "关键词" # 搜索技能
openclaw skills install @owner/name # 安装技能
openclaw skills list # 列出已安装
openclaw skills update # 更新所有技能
openclaw skills uninstall # 卸载技能
# ===== Plugins 插件 =====
openclaw plugins install @openclaw/feishu # 安装官方插件
openclaw plugins install clawhub:<package> # 从 ClawHub 安装
openclaw plugins list # 列出已安装
openclaw plugins uninstall # 卸载插件⭐十二、常用插件与技能推荐
| 名称 | 类型 | 功能 | 推荐度 |
|---|---|---|---|
| @openclaw/feishu | 插件 | 飞书机器人，支持文档/多维表格工具 | ⭐⭐⭐⭐⭐ |
| @openclaw/browser | 插件 | Chrome MCP 浏览器自动化，网页操作 | ⭐⭐⭐⭐⭐ |
| openclaw-weixin | 插件 | 个人微信接入（iLink） | ⭐⭐⭐⭐ |
| @openclaw/whatsapp | 插件 | WhatsApp 接入（最受欢迎渠道） | ⭐⭐⭐⭐ |
| @openclaw/discord | 插件 | Discord 机器人，支持服务器/频道/私信 | ⭐⭐⭐⭐ |
| Tavily Search | 技能 | 通过 Tavily 搜索公开网页，返回结构化结果 | ⭐⭐⭐⭐⭐ |
| Skill Vetter | 技能 | 安全优先的技能审查，安装前检查安全性 | ⭐⭐⭐⭐ |
| Planning with files | 技能 | 基于文件的持久化计划管理，多步骤任务 | ⭐⭐⭐⭐ |
| token-saver | 技能 | Token 优化技能，清理 workspace，优化缓存 | ⭐⭐⭐⭐ |
| @openclaw/signal | 插件 | Signal 加密通讯接入 | ⭐⭐⭐ |
| coding-agent | 插件 | 编程 Agent 能力增强 | ⭐⭐⭐ |
| memory-core | 插件 | 记忆核心，跨会话记忆能力 | ⭐⭐⭐⭐ |
在 ClawHub（clawhub.ai）或运行 openclaw skills search “关键词” 发现更多技能。
❓十三、常见问题与排查
▍Q: Gateway 启动失败怎么办？
A: 运行 openclaw doctor —fix 自动诊断修复。查看日志：tail -50 ~/Library/Logs/openclaw/gateway.log（macOS）或 journalctl -u openclaw（Linux）。
▍Q: 怎么看当前用了多少 Token？
A: 在对话中发送 /usage full 查看每条回复的 Token 数和预估费用，/status 查看会话级上下文使用情况。
▍Q: 配置修改后不生效？
A: 运行 openclaw gateway restart 重启 Gateway。配置会自动备份为 openclaw.json.bak，改错了可以恢复。
▍Q: 怎么更新 OpenClaw？
A: macOS App 自动更新或下载新版覆盖。CLI 版本运行 openclaw update。更新后建议运行 openclaw doctor —fix。
▍Q: 技能安装后不生效？
A: 检查技能是否有有效的 description 字段（SKILL.md 中必须有 description）。运行 openclaw skills list 确认已启用。部分技能需要重启 Gateway。
📌 总结
OpenClaw 是最成熟稳定的多渠道 AI Agent 网关，macOS 用户和飞书用户的首选。
省 Token 三步走： ① 启用上下文压缩 + 子任务用便宜模型（配置层，省 50-70%）② 及时开新会话 + 先定位后阅读（习惯层，省 20-30%）③ 精简技能插件 + 心跳调优（细节层，省 5-10%）
配置只占 30%，使用习惯占 70%。先运行 /usage full 看消耗在哪，再针对性优化，不要盲目换模型。
参考来源：OpenClaw 官方文档与 Configuration Reference· OpenClaw Foundation 公告 · 腾讯 iLink Bot API 说明 · ClawHub · 以及社区教程（掘金 / CSDN / V2EX / 博客园等，二手，已在正文标注）
OpenClaw 完全配置优化指南 · 2026 年 9 月
本文已于 2026-09-23 依据官方文档与本机实测校订（命令与配置键以 Hermes v0.21.3 / OpenClaw 2026.9.5 / dsh 0.1.5-rc.2 为准）。
支持与分享
如果这篇文章对你有帮助，欢迎分享给更多人或打赏支持！