OpenClaw 完全上手指南（新人上手通关指南）

写在前面：这不是一本技术文档，而是一本"保姆级"教程。我会手把手带你从零开始，搭建属于你自己的AI助理。不需要编程基础，只需要一台能上网的电脑和一点耐心。

目录

第一部分：认识 OpenClaw

• 1.1 OpenClaw 是什么？
• 1.2 为什么选择 OpenClaw？
• 1.3 十个真实应用场景
• 1.4 开始之前你需要知道的

第二部分：准备工作

• 2.1 本地部署准备
• 2.2 云端部署准备
• 2.3 获取 API Key（四种方案对比）

第三部分：快速安装

• 3.1 本地安装 OpenClaw 
• 3.2 云端一键部署
• 3.3 初始化配置
• 3.4 首次对话测试

第四部分：接入飞书（实战）

• 4.1 飞书开放平台配置
• 4.2 在 OpenClaw 中配置飞书
• 4.3 完成配对并测试

第五部分：接入钉钉（企业必备）

• 5.1 钉钉开放平台配置
• 5.2 在 OpenClaw 中配置钉钉
• 5.3 完成配对并测试

第六部分：接入 QQ（个人用户友好）

• 6.1 QQ 机器人注册
• 6.2 在 OpenClaw 中配置 QQ
• 6.3 完成 IP 白名单配置

第七部分：安全配置（必看）

• 7.1 个人用户安全配置
• 7.2 企业用户安全配置
• 7.3 工具权限限制
• 7.4 预算控制设置
• 7.5 v2026.3.7 安全更新说明

第八部分：模型选择与配置

• 8.1 四大平台对比
• 8.2 阿里百炼详细配置
• 8.3 KIMI 配置方法
• 8.4 MiniMax 配置方法
• 8.5 GLM 配置方法
• 8.6 模型切换与回退
• 8.7 成本监控

第九部分：技能系统

• 9.1 什么是 ClawHub？
• 9.2 搜索技能
• 9.3 安装技能
• 9.4 使用技能
• 9.5 管理技能
• 9.6 热门技能推荐

第十部分：进阶技巧

• 10.1 自定义 Prompt 模板
• 10.2 批量任务处理
• 10.3 自动化工作流
• 10.4 性能优化建议

第十一部分：故障排除

• 11.1 网络连接问题
• 11.2 API 调用失败
• 11.3 消息无响应
• 11.4 获取帮助

第十二部分：云服务商部署方案对比

• 12.1 阿里云部署方案
• 12.2 腾讯云部署方案
• 12.3 火山引擎部署方案
• 12.4 华为云部署方案
• 12.5 云服务商对比表

第十三部分：平替竞品对比

• 13.1 EasyClaw（极简版）
• 13.2 QoderWork（阿里桌面代理）
• 13.3 StepFun/阶跃AI助手
• 13.4 MiniMax助手（开源框架）
• 13.5 CoPaw（企业级智能体工作站）
• 13.6 竞品对比表

第一部分：认识 OpenClaw

1.1 OpenClaw 是什么？

简单来说，OpenClaw 是一个 AI 智能体平台，它让你能在自己的电脑上运行 AI 助理，并把它接入到你日常使用的工具里——比如飞书、钉钉、QQ、企业微信。

用个通俗的比喻：

你招了一个实习生，这个实习生特别聪明，能帮你查资料、写文档、整理数据，还能24小时在线。但你不需要给它交社保，也不用担心它跳槽。

OpenClaw 就是这个实习生，只不过它住在你的电脑里。

核心概念先了解一下

后面会详细讲，这里先混个脸熟：

• Agent（智能体）：能自主执行任务的 AI 程序，就像一个带工具箱的实习生。你告诉它"帮我整理今天的会议纪要"，它会自己决定用什么工具、分几步完成。

• Gateway（网关）：系统的总调度室，负责消息路由和协调。默认地址是 127.0.0.1:18789，就是你电脑上开的一个端口。

• Channel（渠道）：连接各种聊天平台的接口，比如飞书、钉钉、QQ、企业微信。

• Tool（工具）：Agent 能调用的具体功能，比如读写文件、执行命令、搜索网页。

• Skill（技能）：告诉 Agent 什么时候用什么工具的"说明书"。

别慌，这些词用几遍就熟了。

1.2 为什么选择 OpenClaw？

1.2.1 数据完全掌控

OpenClaw 最大的特点之一：它运行在你的电脑上。

• 你的聊天记录存在本地
• 你的文件处理在本地完成
• 你的 API Key 不会经过第三方服务器

对于担心数据隐私的企业和个人，这是巨大的优势。

注意：虽然 OpenClaw 本身在本地运行，但它调用 AI 模型时需要联网。你的消息会发送到对应的 AI 服务商（如阿里百炼、KIMI 等）。

1.2.2 多平台接入

一个 OpenClaw，可以同时接入：

• 飞书（国内最常用）
• 钉钉（企业必备）
• QQ（个人用户友好）
• 企业微信（腾讯生态）
• Telegram（注重隐私）
• Slack（企业协作）

1.2.3 丰富的技能生态

OpenClaw 有一个官方技能商店（ClawHub），里面有 3000+ 现成的技能可以一键安装。

比如：

• 自动生成日报
• 代码审查
• 邮件自动化
• 会议纪要生成
• 数据抓取与可视化

1.2.4 持续更新

2026年3月发布的版本带来了史无前例的重大升级：

核心亮点：

• ContextEngine 插件接口
  ：上下文管理终于可以「自由插拔」，不动核心代码就能换策略
• GPT-5.4 + Gemini 3.1 双首发
  ：全面适配 OpenAI 最新 GPT-5.4 和 Google Gemini 3.1 Flash
• ACP 持久化频道绑定
  ：Discord/Telegram 绑定重启后自动恢复
• 200+ Bug 修复
  ：史上最大规模修复，稳定性大幅提升
• 安全性增强
  ：网关锁升级至 SHA-256，配置验证 CLI，沙箱逃逸防范

1.3 十个真实应用场景

场景一：自动整理日报（拯救打工人）

以前： 小王每天下班前要发日报，总结今天做了什么。他要翻聊天记录、看邮件、回忆一天的工作，至少花20分钟。

现在： 小王在钉钉群里 @OpenClaw 机器人：

“帮我整理今天的日报，从项目群提取关键进展，从邮件提取待跟进事项。”

机器人自动：

1. 读取指定群聊的今日消息
2. 提取关键信息
3. 按格式生成日报
4. 发到指定文档

省下的20分钟，小王可以准时下班了。

场景二：查资料写报告（研究员的福音）

以前： 小李需要写一篇行业分析报告，涉及大量资料搜集。他要在十几个网站间来回切换，复制粘贴到手软。

现在： 小李告诉 OpenClaw：

“搜索 2026 年 AI 编程助手的市场规模，整理成表格，包含数据来源。”

Agent 自动：

1. 调用搜索工具查找资料
2. 访问多个网页提取信息
3. 整理成结构化表格
4. 标注数据来源

小李从"体力活"中解放出来，专注在分析和判断上。

场景三：飞书群消息自动总结

以前： 产品经理小张每天要从多个飞书群里找产品反馈，几百条消息一条条翻，眼睛都花了。

现在： 小张告诉 OpenClaw：

“帮我总结产品群今天关于用户反馈的消息，按问题类型分类。”

机器人自动：

1. 读取产品群今天的所有消息
2. 智能筛选出反馈类消息
3. 按问题类型（bug/功能需求/体验问题）分类
4. 生成总结报告

场景四：钉钉审批流程自动化

以前： 企业HR每天要处理几十条请假申请，人工审核效率低，还容易出错。

现在： 通过 OpenClaw 接入钉钉，配置自动化审批规则：

• 请假1天以下：自动审批
• 请假3天以上：需要部门负责人确认
• 关键岗位：需要 HR 复核

机器人自动：

1. 接收钉钉审批消息
2. 根据规则判断审批路径
3. 自动转发或审批
4. 生成审批记录

场景五：QQ群智能问答助手

以前： 技术群里每天有大量重复问题，老手们要一遍遍回答"怎么连接数据库"“怎么配置环境”。

现在： 在 QQ 群里接入 OpenClaw 机器人，配置常见问题知识库：

• 数据库连接步骤
• 环境配置教程
• 常见错误及解决方案

机器人自动：

1. 监听群内问题
2. 匹配知识库
3. 自动回答或引导到文档
4. 收录新问题到知识库

场景六：企业知识库智能检索

以前： 公司有上千份文档，员工要找某个信息，要翻几十个文件夹，效率极低。

现在： 通过 OpenClaw 接入企业内部知识库：

• 上传所有文档
• 配置权限管理
• 设置检索规则

员工直接在飞书/钉钉问机器人：

“帮我找一下关于 2026 年销售政策的文档”

机器人自动：

1. 在知识库中搜索
2. 匹配相关文档
3. 提取关键信息
4. 直接在聊天框返回

场景七：代码自动审查与修复

以前： 开发者小王每天要 review 团队代码，逐行检查，容易漏掉问题。

现在： 小王提交代码到 Git 仓库，触发 OpenClaw 的代码审查技能：

• 检查代码规范
• 识别潜在 bug
• 提出优化建议
• 生成审查报告

场景八：邮件自动分类与回复

以前： 客服小刘每天收到几百封邮件，手动分类回复，效率低，还容易漏掉。

现在： 通过 OpenClaw 配置邮件自动化：

• 自动识别邮件类型（咨询/投诉/建议）
• 按类型分配到不同文件夹
• 自动回复常见问题
• 复杂问题标记待处理

场景九：会议纪要自动生成

以前： 会议结束后，要花30分钟整理会议纪要，经常遗漏重要信息。

现在： 在会议开始前，让 OpenClaw 加入会议（需配合语音转写功能）：

• 实时转录语音为文字
• 识别发言人
• 提取关键决策和待办事项
• 自动生成会议纪要

场景十：个人日程智能管理

以前： 小张每天要手动管理日程，容易忘记重要事项。

现在： 通过 OpenClaw 接入日历：

• 自然语言添加日程：“明天下午2点开会”
• 智能提醒会议
• 自动安排空闲时间
• 冲突检测和建议

1.4 开始之前你需要知道的

1.4.1 它不是什么

误解一：它是 ChatGPT 替代品

不是。ChatGPT 是一个 AI 对话产品，你打开网页就能聊。OpenClaw 是一个平台，让你能搭建自己的 AI 助理。

可以这样理解：

• ChatGPT = 一个训练有素的客服
• OpenClaw = 一个可以训练自己客服的系统

实际上，OpenClaw 可以接入阿里百炼、KIMI、MiniMax、GLM 等多种模型。它是模型的使用者，不是模型的竞争者。

误解二：它是云端服务，数据存在别人服务器上

不是。这是 OpenClaw 最大的特点之一：它运行在你的电脑上（后面第2章会教你怎么安装）。

误解三：它会自己上网乱买东西、乱发邮件

不会。OpenClaw 的设计理念是最小权限原则。默认情况下，它什么都不能做。

• 想让它读写文件？你需要明确授权
• 想让它发邮件？你需要配置邮件工具
• 想让它执行命令？你需要开启沙箱并设置权限

而且，高风险操作可以设置二次确认，确保它不会"自作主张"。

1.4.2 适用人群

OpenClaw 适合：

• 经常重复处理相似内容的职场人士
• 需要整理大量信息的研发、产品、运营
• 想学习 AI 工具使用的技术爱好者
• 担心数据隐私的企业用户
• 需要多平台统一管理的团队

不推荐给：

• 只需要偶尔 AI 聊天的人（直接用 KIMI/通义千问更简单）
• 完全不懂电脑操作的人（需要一定的技术素养）

1.4.3 学习路径建议

根据你的目标，选择最适合的学习路径：

路径 A：个人用户快速上手

• 目标：在 QQ/飞书里 @AI 机器人，让它帮你办事
• 阅读顺序：第1章 → 第2章（本地部署）→ 第3章 → 第4章或第6章 → 第7章（个人安全配置）
• 预计时间：2-3小时

路径 B：企业用户快速部署

• 目标：在钉钉/企业微信里 @AI 机器人，提升团队效率
• 阅读顺序：第1章 → 第2章（云端部署）→ 第3章 → 第5章 → 第7章（企业安全配置）
• 预计时间：3-4小时

路径 C：深度定制

• 目标：让 AI 助理完成你的专属任务（如数据分析、报告生成）
• 阅读顺序：路径A或B + 第8章 + 第9章 + 第10章
• 预计时间：1-2天

第二部分：准备工作

2.1 本地部署准备

2.1.1 硬件要求

简单说：只要是近5年的电脑，基本都能跑。

2.1.2 网络要求

• 需要能访问 npm registry（安装 OpenClaw）
• 需要能访问你选择的 AI 服务商（如 KIMI、MiniMax、阿里百炼等）
• 如果接入 QQ，需要固定 IP 或动态 DNS 服务

2.1.3 安装 Node.js

Node.js 是一个让 JavaScript 能在电脑本地运行的环境。

检查是否已安装

打开终端（Terminal），输入：

node -v

期望看到的结果：

v22.0.0

判断标准：

• ✅ 版本 >= v22：可以继续
• ❌ 版本 < v22：需要升级
• ❌ 提示"command not found"：需要安装

macOS 安装/升级

使用 Homebrew：

brew install node@22

或者使用 nvm：

nvm install 22nvm use 22

Windows 安装/升级

推荐方式：使用 winget

winget install OpenJS.NodeJS.LTS

或者手动下载：

1. 访问 https://nodejs.org
2. 下载 LTS 版本（长期支持版）
3. 按向导安装

Windows 用户注意：官方推荐在 WSL2 中运行 OpenClaw，能避免很多奇怪问题。

Linux 安装/升级

Ubuntu/Debian：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -sudo apt-get install -y nodejs

CentOS/RHEL/Fedora：

curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo -E bash -sudo yum install -y nodejs

2.2 云端部署准备

2.2.1 云服务商推荐

详细对比见第12.5节。

2.2.2 阿里云部署方案

方案一：轻量应用服务器（推荐个人用户）

1. 访问阿里云轻量应用服务器：https://www.aliyun.com/product/swas
2. 选择镜像：OpenClaw 专属镜像
3. 选择套餐：2核4G 起步
4. 选择地域：建议华东（杭州）或华北（北京）
5. 完成购买

方案二：无影云电脑（需要可视化界面）

1. 访问阿里云无影：https://www.aliyun.com/product/wuying-dc
2. 选择 OpenClaw 专属套餐
3. 选择配置：4核8G 起步
4. 完成购买

方案三：函数计算 AgentRun（适合开发者）

1. 访问函数计算 AgentRun：https://www.aliyun.com/product/fc/agentrun
2. 选择运行时：Python 3.10+
3. 配置网络：VPC、交换机
4. 一键部署

2.2.3 腾讯云部署方案

Lighthouse 轻量应用服务器

1. 访问腾讯云 Lighthouse：https://cloud.tencent.com/product/lighthouse
2. 选择镜像：OpenClaw 专属镜像
3. 选择套餐：2核4G 起步
4. 选择地域：建议广州、上海或北京
5. 完成购买

2.2.4 云端部署注意事项

1. 固定 IP
   ：如果接入 QQ 机器人，需要固定 IP，建议选择云服务器
2. 安全组配置
   ：开放 18789 端口（OpenClaw Gateway 默认端口）
3. 防火墙设置
   ：配置入站规则，允许必要端口访问
4. 数据备份
   ：定期备份配置文件和数据库
5. 监控告警
   ：配置云监控，及时发现异常

2.3 获取 API Key（四种方案对比）

2.3.1 API Key 是什么？

API Key（应用编程接口密钥），听起来很高大上，其实就是一串密码。

类比一下：

• 饭店的 VIP 卡 → 证明你有资格享受服务
• 小区的门禁卡 → 证明你有权限进入
• API Key → 证明你有权限调用 AI 服务

每次 OpenClaw 让 AI 帮你干活，都要出示这个 Key。AI 服务商根据 Key 来：

1. 确认你是谁
2. 计算你用了多少额度
3. 决定是否响应你的请求

2.3.2 四大平台对比

对于国内用户，我推荐优先选择以下四家。它们都有专门针对开发者的 Coding Plan。

快速对比表

💡 说明：阿里百炼价格为新用户首月优惠价，活动时间为 2026.02.19 - 2026.04.01，后续如有变动，请以实时页面为准。

我的建议

先选你已开通套餐的一家（最稳妥）

先跑通、再优化，是对小白最友好的路径。先用已开通套餐的那一家完成第3章的安装和首轮对话，避免在起步阶段增加变量。

如果四家都能用，再按任务类型切：

• 性价比首选
  ：阿里百炼（新用户首月7.9元起）
• 长文档处理、知识问答
  ：优先 KIMI（kimi-k2.5，256K上下文）
• 响应速度优先、需要快速往返
  ：先试 MiniMax（MiniMax-M2.5-Lightning）
• 代码生成
  ：优先 GLM（glm-5）或阿里百炼的 qwen3-coder-plus

2.3.3 方案 A：阿里百炼（性价比首选）

申请步骤

1. 访问 https://common-buy.aliyun.com/?commodityCode=sfm_codingplan_public_cn#/buy
2. 登录/注册阿里云账号
3. 选择套餐（Lite 基础版或 Pro 高级版）
4. 完成支付（支持支付宝/微信）
5. 进入控制台，创建 API Key
6. 复制生成的 Key（格式为 sk-sp-xxxxx）

提示：Key 创建后只显示一次，务必保存好。如果丢了，只能重新创建。

可用模型

2.3.4 方案 B：KIMI（长文档处理首选）

申请步骤

1. 访问 https://www.kimi.com/code
2. 登录/注册 KIMI 账号
3. 点击"订阅 Coding Plan"
4. 完成支付（支持支付宝/微信）
5. 进入控制台，点击"创建 API Key"
6. 复制生成的 Key（以 sk- 开头）

2.3.5 方案 C：MiniMax（响应速度优先）

申请步骤

1. 访问 https://platform.minimaxi.com/subscribe/coding-plan
2. 注册/登录账号
3. 完成实名认证（需要身份证）
4. 订阅 Coding Plan
5. 进入"API 管理"页面
6. 创建 API Key 并复制

2.3.6 方案 D：GLM（代码能力强）

申请步骤

1. 访问 https://bigmodel.cn/glm-coding
2. 注册/登录智谱 AI 账号
3. 进入控制台
4. 点击"API Keys"菜单
5. 创建新的 API Key
6. 复制保存

2.3.7 保存 API Key 的建议

1. 不要直接保存在微信/QQ聊天记录里
2. 不要截图保存在相册里
3. 推荐保存在： 
• 密码管理器（1Password、Bitwarden 等）
• 本地文本文件（放在安全的位置）
• 备忘录（如果支持加密）

重要：API Key 就像银行卡密码，泄露了别人就能花你的钱。妥善保管！

第三部分：快速安装

3.1 本地安装 OpenClaw

确认 Node.js >= v22 后，执行安装命令：

npm install -g openclaw@latest

这行命令在做什么？

• npm
  ：Node.js 的包管理器
• install
  ：安装
• -g
  ：全局安装（在任何目录都能用 openclaw 命令）
• openclaw@latest
  ：安装最新版本

等待时间：取决于你的网络，通常 30 秒到 2 分钟。

验证安装成功

安装完成后，检查版本：

openclaw --version

期望看到类似输出：

openclaw/3.7.0 darwin-arm64 node-v22.0.0

❌ 如果提示"command not found"

可能原因：npm 全局路径未加入系统 PATH

解决方法：

1. 重启终端
2. 如果还不行，检查 npm 全局路径：npm prefix -g
3. 把返回的路径加入 PATH 环境变量

3.2 云端一键部署

3.2.1 阿里云轻量应用服务器部署

1. 登录阿里云控制台，进入轻量应用服务器实例管理页面
2. 选择购买的 OpenClaw 专属镜像实例
3. 点击"远程连接"，进入服务器终端
4. 执行以下命令验证安装：

openclaw --version

3.2.2 腾讯云 Lighthouse 部署

1. 登录腾讯云控制台，进入 Lighthouse 实例管理页面
2. 选择购买的 OpenClaw 专属镜像实例
3. 点击"登录"，进入服务器终端
4. 执行以下命令验证安装：

openclaw --version

3.2.3 获取服务器访问地址

云端部署后，需要获取服务器公网 IP，用于后续配置：

# 查看公网 IP（阿里云/腾讯云通用）curl ifconfig.me

记录这个 IP 地址，后续配置渠道时需要使用。

3.3 初始化配置

安装完成后，运行初始化向导：

openclaw onboard --install-daemon

参数说明：

• --install-daemon
  ：同时安装后台服务（推荐）

3.3.1 第一步：风险确认

启动向导后，通常会先看到：

⚠️ OpenClaw has full access to your system.⚠️ It can read/write files, execute commands, and access network.⚠️ Only proceed if you understand the risks.I understand this is powerful and inherently risky. Continue? (y/N)

输入 y 并回车。

如果你之前装过 OpenClaw，还会看到：

Existing configuration found in ~/.openclawWhat would you like to do? (Use arrow keys)> Reset - Start fresh (recommended for new users)  Merge - Keep existing config (for advanced users)  Abort - Cancel installation

首次安装通常不会出现这一段，直接进入下一步。

3.3.2 第二步：选择模式

向导会问你：

Onboarding mode: (Use arrow keys)> QuickStart - Fast setup with default settings  Manual - Advanced configuration

怎么选？

我的建议：第一次选 QuickStart，后面可以随时改配置。

3.3.3 第三步：选择模型提供商

向导会提示你选择模型提供商：

Model/auth provider: (Use arrow keys)> 阿里百炼 (Bailian)  KIMI (Moonshot)  MiniMax  GLM (智谱AI)  OpenAI  Anthropic (Claude)  Skip for now

先选你在第2章申请的厂商（推荐阿里百炼新用户优惠）。

3.3.4 第四步：选择鉴权方式

在你选完厂商后，通常不会立刻要 Key，而是先进入该厂商的鉴权方式选择。

以阿里百炼为例：

阿里百炼 auth method: (Use arrow keys)> Coding Plan (CN)  API Key (Global)  OAuth (Advanced)

国内读者建议：优先选 Coding Plan 对应项。

• 阿里百炼：优先 Coding Plan (CN)
• KIMI：优先 Coding Plan (CN)
• MiniMax：优先 MiniMax OAuth (CN) 路径
• GLM（Z.AI）：优先 Coding-Plan-CN 路径

3.3.5 第五步：输入 API Key 并选模型

如果选择阿里百炼

Enter your 阿里百炼 API Key: [输入你的Key]Default model: (Use arrow keys)> qwen3.5-plus  kimi-k2.5  glm-4.7  qwen3-coder-plus

如果选择 KIMI

Enter your KIMI API Key: [输入你的Key]Default model: (Use arrow keys)> kimi-k2.5  kimi-k2-0905-preview  kimi-k2-thinking

如果选择 MiniMax

Enter your MiniMax API Key: [输入你的Key]Default model: (Use arrow keys)> MiniMax-M2.5  MiniMax-M2.5-Lightning  MiniMax-M2.1

如果选择 GLM

Enter your GLM API Key: [输入你的Key]Default model: (Use arrow keys)> glm-5  glm-4.7  glm-4.7-flash

💡 提示：粘贴 API Key 时，终端不会显示任何字符（为了安全），这是正常的。直接粘贴后按回车即可。

3.3.6 第六步：配置 Channel（先 Skip！）

在 QuickStart 路径下，向导会直接进入渠道单选列表：

Select channel (QuickStart): (Use arrow keys)> Skip for now  Feishu (飞书)  DingTalk (钉钉)  QQ  Telegram

选择 Skip for now。

为什么先Skip？

这是多轮实测验证出的最佳实践：

1. 先把"TUI 里能稳定对话"跑通
2. 确认模型、鉴权、Gateway 都正常
3. 再接入渠道，出错时能明确判断是"渠道配置问题"还是"基础环境问题"

放心，后面第4、5、6章会详细讲飞书、钉钉、QQ 接入。

3.3.7 第七步：配置 Skills

接下来常见会看到：

Configure skills now? (recommended) (Y/n)

输入 y 并回车。

然后会让你选择技能安装方式：

Skill installation method: (Use arrow keys)> npm (recommended)  pnpm  yarn  manual

给新手的默认建议：

1. 如果你准备立刻玩 Skills：按需勾选安装项
2. node manager
    选你本机已经在用的那个（不确定就用 npm）

3.3.8 第八步：配置 Hooks

Skills 后会进入 Hooks 配置：

Enable hooks? (space to select, enter to confirm)[ ] session-memory - Persist chat history[ ] auto-summary - Auto-summarize long conversations[ ] error-recovery - Auto-retry failed tool calls[ ] daily-report - Generate daily activity report

本书建议的最小策略：

1. 首次可先启用 1 个最核心 hook（最小可用，优先 session-memory）
2. 如果你现在还分不清 hook 的作用，也可以先 Skip for now
3. 先跑通主线，后面再系统化管理 hooks

3.3.9 第九步：选择 Hatch 方式

在收尾阶段，向导会给你一个启动入口选择：

How do you want to hatch your bot? (Use arrow keys)> Hatch in TUI (recommended)  Open the Web UI  Do this later

怎么选：

• Hatch in TUI
  ：在终端里启动（推荐新手）
• Open the Web UI
  ：打开浏览器控制台（图形化）
• Do this later
  ：先结束向导，稍后再进

为什么默认选 TUI：

1. 我们无法假设你一定在本机操作；很多读者是在云主机/VPS 上跑
2. 如果是 VPS，Open the Web UI 往往还要做端口转发，对新手不友好
3. 选 Hatch in TUI 可以立刻开始对话，不被网络与端口问题卡住

3.3.10 第十步：记录 Dashboard 链接

如果一切顺利，最后会看到类似：

✅ OpenClaw installed successfully!✅ Gateway daemon installed and runningDashboard: http://127.0.0.1:18789TUI: openclaw chatLogs: ~/.openclaw/logs

如果是云端部署，Dashboard 地址会是：

Dashboard: http://你的服务器公网IP:18789

复制 Dashboard 链接备用。如果没记住也没关系，后面可以通过：

openclaw dashboard

再次获取控制台入口。

3.4 首次对话测试

3.4.1 完成初始化对话

onboard 完成后，建议先在 TUI 里完成第一轮对话。这一步建议你主动讲清楚下面 5 件事：

1. 你是谁：怎么称呼你、你的时区和工作语言
2. 你要它扮演什么角色：比如"我的技术写作助手"
3. 你平时的工作场景：常用工具、文件目录、沟通方式（飞书/钉钉/QQ 等）
4. 你的偏好：回答风格、长度、是否先给结论
5. 你的边界：哪些操作必须先确认、哪些内容不要碰

这一步做得越清楚，后续它越像"你自己的实例"，而不是"一个通用聊天机器人"。

3.4.2 发送第一条测试消息

完成初始化后，建议先发一条不依赖你工作背景的消息做冒烟测试。

推荐你先用这条：

用清单格式列出今天的待办事项建议

如果你想测"查询能力"，可再补一条：

查询今天北京的天气，给出穿衣建议

按回车发送。

期望的回复： 它应该直接给出结构化结果（清单或天气建议），而不是继续做泛泛自我介绍。

如果看到回复，恭喜你！安装成功！

第四部分：接入飞书（实战）

4.1 飞书开放平台配置

4.1.1 创建企业应用

1. 打开飞书开放平台：https://open.feishu.cn/app
2. 登录你的飞书账号（需要有企业管理员权限）
3. 点击"创建企业自建应用"

填写应用信息：

• 应用名称：建议用"AI助手"或"OpenClaw"
• 应用描述：内部使用的 AI 助手
• 图标：可以上传一个机器人图标

4.1.2 获取 App ID 与 App Secret

创建完成后，进入应用详情页：

1. 点击左侧"凭证与基础信息"
2. 记录以下信息： 
• App ID（形如 cli_xxxxxxxxxxxxxxxx）
• App Secret（点击"查看"按钮显示）

重要：App Secret 务必保密，不要截图外传，不要发到群里。泄露了别人就能控制你的机器人。

4.1.3 权限配置

1. 点击左侧"权限管理"
2. 点击"批量导入权限"
3. 粘贴以下内容：

[  {    "permission": "im:message",    "level": 1  },  {    "permission": "im:message:send_as_bot",    "level": 1  },  {    "permission": "contact:user.base",    "level": 1  },  {    "permission": "im:chat",    "level": 1  }]

1. 点击"确定"

这些权限是做什么的？

4.1.4 启用 Bot 能力

1. 点击左侧"应用能力"
2. 找到"机器人"卡片，点击"启用"
3. 设置机器人名称（建议和应用名称一致）
4. 点击"保存"

4.1.5 首次发布应用（⚠️ 关键步骤！）

切记：这一步必须在开启长连接之前完成！

实测经验：如果还没先发布应用就直接开启"长连接订阅"，通常会持续失败。

发布步骤：

1. 点击左侧"版本管理与发布"
2. 点击"创建版本"
3. 填写版本信息： 
• 版本号：1.0.0
• 更新说明：初始版本
4. 点击"保存"
5. 点击"申请发布"
6. 等待企业管理员审批（如果是你自己的企业，通常自动通过）

💡 提示：审批通过后，应用状态会变为"已发布"。这时候才能进行下一步。

4.2 在 OpenClaw 中配置飞书

4.2.1 启用飞书插件

先查看插件列表：

openclaw plugins list

如果看到 @openclaw/channel-feishu 是未启用状态，执行：

openclaw plugins enable @openclaw/channel-feishu

4.2.2 交互式添加 Channel

运行命令：

openclaw channels add

按提示完成配置：

问题1：选择渠道类型

Channel type: (Use arrow keys)> feishu  dingtalk  qq  telegram  ...

选择 feishu

问题2：输入 App ID

Enter App ID: [粘贴你在 4.1.2 获取的 App ID]

问题3：输入 App Secret

Enter App Secret: [粘贴你在 4.1.2 获取的 App Secret]

粘贴时不显示字符，这是正常的

问题4：选择飞书域名

Feishu domain: (Use arrow keys)> feishu.cn (国内版)  larksuite.com (国际版)

国内用户选 feishu.cn

问题5：群聊策略

Group chat policy: (Use arrow keys)> allowAll  allowList  blockAll

新手建议先选 allowAll，后面再收紧（第7章会详细讲安全配置）

问题6：需要 mention 才回复？

Require mention in groups? (y/N)

输入 y（群聊中需要 @ 才回复）

4.2.3 验证配置

配置完成后，查看 Channel 列表：

openclaw channels list

应该显示：

┌──────────┬─────────┬───────────┬─────────────┐│ Name     │ Type    │ Status    │ Config      │├──────────┼─────────┼───────────┼─────────────┤│ feishu-1 │ feishu  │ enabled   │ App ID: cli_│└──────────┴─────────┴───────────┴─────────────┘

4.3 完成配对并测试

4.3.1 关键时序（⚠️ 血的教训）

正确的时序是：

1. ✅ 飞书侧：创建应用 → 配置权限 → 发布应用
2. ✅ OpenClaw 侧：channels add 配置渠道
3. ✅ OpenClaw 侧：启动 Gateway
4. ✅ 飞书侧：开启事件订阅（长连接）
5. ✅ 飞书侧：配置事件订阅地址

如果顺序错了，长连接会订阅失败，表现为"消息发出去，机器人没反应"。

4.3.2 启动 Gateway

本地部署：

openclaw gateway start

云端部署：

openclaw gateway start --host 0.0.0.0

确认输出：

✅ Gateway started (pid: 12345)

4.3.3 在飞书平台开启事件订阅

回到飞书开放平台

1. 点击左侧"事件与回调"
2. 在"事件订阅方式"中，选择"长连接"
3. 点击"保存"

4.3.4 添加事件订阅

在"订阅事件"区域，点击"添加事件"：

1. 搜索 im.message.receive_v1
2. 勾选并确认添加

这个事件表示"收到消息时通知我"。

4.3.5 私聊机器人触发配对

在飞书里：

1. 搜索你的机器人名称
2. 进入私聊界面
3. 发送任意消息，比如"你好"

这时候消息还到不了 OpenClaw，因为需要先"配对"。

飞书机器人会回复类似：

需要管理员批准才能开始使用。请管理员在 OpenClaw 终端执行:openclaw pair approve [6位数字code]

这就是对用户最直观、最容易拿到 code 的路径。

4.3.6 批准配对

然后在终端执行：

openclaw pair approve [6位数字code]

例如：

openclaw pair approve 123456

如果你没看到私聊里的 code，或者想二次核对，再在终端运行：

openclaw pair list

应该显示：

Pending pairing requests:- Feishu user [用户名] (user_id: ou_xxxxxx) - Code: 123456

再执行批准：

openclaw pair approve 123456

4.3.7 验证私聊

回到飞书，再次发送消息：

你好，测试消息

期望结果：机器人回复消息！

第五部分：接入钉钉（企业必备）

5.1 钉钉开放平台配置

5.1.1 创建企业内部应用

1. 打开钉钉开放平台：https://open.dingtalk.com/
2. 登录你的钉钉账号（需要有企业管理员权限）
3. 进入"应用开发"→"企业内部开发"
4. 点击"创建应用"

填写应用信息：

• 应用名称：建议用"AI助手"或"OpenClaw"
• 应用描述：内部使用的 AI 助手
• 应用图标：可以上传一个机器人图标

5.1.2 获取 App ID 与 App Secret

创建完成后，进入应用详情页：

1. 点击左侧"凭证与基础信息"
2. 记录以下信息： 
• AppKey（Client ID，形如 dingxxxxxxxxxxxxx）
• AppSecret（Client Secret，点击"查看"按钮显示）

重要：AppSecret 务必保密，不要截图外传，不要发到群里。泄露了别人就能控制你的机器人。

5.1.3 获取企业 ID

在钉钉开放平台首页，右侧可以看到：

• 企业 ID（Corp ID，形如 dingxxxxxxxxxxxxx）

记录这个 ID，后续配置时需要使用。

5.1.4 添加机器人能力

1. 点击左侧"应用能力"→"添加应用能力"
2. 选择"机器人"，点击"添加"
3. 配置机器人信息： 
• 机器人名称：建议和应用名称一致
• 机器人描述：内部使用的 AI 助手
• 消息接收模式：选择"HTTP 模式"（OpenClaw 推荐）
• 机器人消息推送：开启
4. 点击"确定"

5.1.5 申请必要权限

1. 点击左侧"权限管理"
2. 搜索并申请以下权限： 
• contact:user.base
  ：获取用户基本信息
• contact:user.email
  ：获取用户邮箱
• im:message
  ：发送消息
3. 点击"批量申请"，等待审批（通常即时生效）

5.1.6 发布应用

1. 点击左侧"版本管理与发布"
2. 点击"创建版本"
3. 填写版本信息： 
• 版本号：1.0.0
• 更新说明：初始版本
4. 点击"保存"
5. 点击"申请发布"
6. 等待企业管理员审批（如果是你自己的企业，通常自动通过）

5.2 在 OpenClaw 中配置钉钉

5.2.1 启用钉钉插件

先查看插件列表：

openclaw plugins list

如果看到 @openclaw/channel-dingtalk 是未启用状态，执行：

openclaw plugins enable @openclaw/channel-dingtalk

5.2.2 交互式添加 Channel

运行命令：

openclaw channels add

按提示完成配置：

问题1：选择渠道类型

Channel type: (Use arrow keys)> dingtalk  feishu  qq  ...

选择 dingtalk

问题2：输入 AppKey (Client ID)

Enter AppKey (Client ID): [粘贴你在 5.1.2 获取的 AppKey]

问题3：输入 AppSecret (Client Secret)

Enter AppSecret (Client Secret): [粘贴你在 5.1.2 获取的 AppSecret]

粘贴时不显示字符，这是正常的

问题4：输入企业 ID (Corp ID)

Enter Corp ID: [粘贴你在 5.1.3 获取的企业 ID]

问题5：选择群聊策略

Group chat policy: (Use arrow keys)> allowAll  allowList  blockAll

新手建议先选 allowAll，后面再收紧（第7章会详细讲安全配置）

问题6：需要 mention 才回复？

Require mention in groups? (y/N)

输入 y（群聊中需要 @ 才回复）

5.2.3 验证配置

配置完成后，查看 Channel 列表：

openclaw channels list

应该显示：

┌──────────┬──────────┬───────────┬─────────────┐│ Name     │ Type     │ Status    │ Config      │├──────────┼──────────┼───────────┼─────────────┤│ dingtalk-1 │ dingtalk │ enabled   │ AppKey: ding_│└──────────┴──────────┴───────────┴─────────────┘

5.3 完成配对并测试

5.3.1 启动 Gateway

本地部署：

openclaw gateway start

云端部署：

openclaw gateway start --host 0.0.0.0

确认输出：

✅ Gateway started (pid: 12345)

5.3.2 在钉钉中测试机器人

1. 在钉钉中搜索你的机器人名称
2. 进入私聊界面
3. 发送测试消息：

   你好，测试消息

期望结果：机器人回复消息！

5.3.3 群聊测试

1. 在钉钉中创建一个测试群
2. 将机器人添加到群聊
3. 在群里 @ 机器人发送测试消息：

   @AI助手 你好，群聊测试

期望结果：机器人回复消息！

第六部分：接入 QQ（个人用户友好）

6.1 QQ 机器人注册

6.1.1 注册 QQ 开放平台账号

1. 访问 QQ 开放平台：https://q.qq.com
2. 点击"注册"，使用手机号注册账号
3. 完成实名认证（需要身份证信息）

6.1.2 创建 QQ 机器人

1. 登录 QQ 开放平台，进入"机器人"页面
2. 点击"创建机器人"
3. 填写机器人信息： 
• 机器人名称：建议用"AI助手"或"OpenClaw"
• 机器人简介：个人使用的 AI 助手
• 机器人类型：选择"个人机器人"
4. 上传机器人头像（建议 240x240px）
5. 点击"提交"

6.1.3 获取机器人凭证

创建成功后，进入机器人管理页面：

1. 记录以下信息： 
• AppID（机器人 ID）
• AppSecret（机器人密钥，点击"查看"显示）
• Token（格式为 AppID:AppSecret，需要自己拼接）

重要：AppSecret 只显示一次，务必保存好。如果丢了，只能重置。

6.1.4 配置沙箱环境（重要！）

QQ 机器人需要在沙箱环境中测试，配置步骤：

1. 在机器人管理页面，点击"沙箱配置"
2. 点击"添加成员"，输入你的 QQ 号
3. 创建 QQ 频道（如果需要群聊功能）： 
• 在手机 QQ 中创建频道
• 返回沙箱配置，绑定该频道
4. 设置私聊/群聊权限： 
• 私聊：选择"在消息列表配置"，添加成员
• 群聊：选择"在 QQ 群配置"，选择群 ID
5. 设置回复模式： 
• 私聊：即时回复
• 群聊：@ 机器人时回复

⚠️ 注意：QQ 机器人对网络环境要求极高，家用宽带 IP 会频繁变化，建议使用云服务器部署。

6.2 在 OpenClaw 中配置 QQ

6.2.1 启用 QQ 插件

先查看插件列表：

openclaw plugins list

如果看到 @openclaw/channel-qq 是未启用状态，执行：

openclaw plugins enable @openclaw/channel-qq

6.2.2 交互式添加 Channel

运行命令：

openclaw channels add

按提示完成配置：

问题1：选择渠道类型

Channel type: (Use arrow keys)> qq  feishu  dingtalk  ...

选择 qq

问题2：输入 AppID

Enter AppID: [粘贴你在 6.1.3 获取的 AppID]

问题3：输入 AppSecret

Enter AppSecret: [粘贴你在 6.1.3 获取的 AppSecret]

粘贴时不显示字符，这是正常的

问题4：输入 Token

Enter Token (AppID:AppSecret): [拼接 AppID 和 AppSecret]

格式为 AppID:AppSecret，例如：12345678:abcdefg

6.2.3 验证配置

配置完成后，查看 Channel 列表：

openclaw channels list

应该显示：

┌──────────┬───────┬───────────┬─────────────┐│ Name     │ Type   │ Status    │ Config      │├──────────┼───────┼───────────┼─────────────┤│ qq-1     │ qq     │ enabled   │ AppID: 1234│└──────────┴───────┴───────────┴─────────────┘

6.3 完成 IP 白名单配置

6.3.1 获取服务器公网 IP

如果是本地部署，获取本地公网 IP：

curl ifconfig.me

如果是云端部署，使用云服务器的公网 IP。

6.3.2 配置 QQ 机器人 IP 白名单

1. 回到 QQ 开放平台，进入机器人管理页面
2. 点击"开发管理"→"IP 白名单"
3. 添加服务器公网 IP
4. 点击"保存"

⚠️ 注意：如果使用家用宽带，IP 会频繁变化，需要定期更新白名单，非常麻烦。建议使用云服务器部署。

6.3.3 测试机器人

1. 在手机 QQ 中搜索你的机器人名称
2. 添加机器人为好友（已在沙箱配置中）
3. 发送测试消息：

   你好，测试消息

期望结果：机器人回复消息！

第七部分：安全配置（必看）

7.1 个人用户安全配置

7.1.1 基础安全策略

对于个人用户，建议采用以下基础安全策略：

1. 私聊策略：allowlist（白名单）

• 只允许自己和自己信任的人使用机器人
• 配置方式：

  openclaw channels edit feishu-1# 设置 privatePolicy: "allowlist"# 设置 allowFrom: ["ou_xxxxxxxxxxxxxxxx"]

2. 群聊策略：requireMention（需要 @ 才回复）

• 群里只有 @ 机器人时才回复，避免误触发
• 配置方式：

  openclaw channels edit feishu-1# 设置 requireMention: true

3. 工具权限：只允许安全工具

• 禁止高风险工具（如 system.exec）
• 配置方式：

  {  "agents": {      "defaults": {        "tools": {          "allowed": ["search", "file.read"],          "blocked": ["system.exec", "file.write"]        }      }  }}

4. 预算控制：设置月度上限

• 防止意外超支
• 配置方式：

  {  "agents": {      "defaults": {        "budget": {          "monthly": 100,          "alertAt": 80        }      }  }}

7.1.2 本地部署安全建议

1. 使用非管理员账号运行

• 避免以 root/administrator 登录运行 OpenClaw
• 创建普通用户账号专门用于运行 OpenClaw

2. 限制文件访问权限

• 在配置文件中限制工作目录
• 配置方式：

  {  "workspace": {      "allowedPaths": [          "~/Documents/",          "~/Downloads/"        ]  }}

3. 定期备份配置文件

• 定期备份 ~/.openclaw/ 目录
• 避免配置丢失后无法恢复

4. 不要在公网开放管理端口

• 本地部署时，不要开放 18789 端口到公网
• 只在本地访问 Dashboard

7.2 企业用户安全配置

7.2.1 企业级安全策略

对于企业用户，建议采用以下企业级安全策略：

1. 私聊策略：pairing（配对机制）

• 用户需要申请配对，管理员批准后才能使用
• 配置方式：

  openclaw channels edit dingtalk-1# 设置 privatePolicy: "pairing"

• 管理员在终端执行：

  openclaw pair approve [配对码]

2. 群聊策略：allowlist + requireMention

• 只允许特定群聊使用
• 群聊中需要 @ 机器人才回复
• 配置方式：

  openclaw channels edit dingtalk-1# 设置 groupPolicy: "allowlist"# 设置 groupAllowFrom: ["oc_xxxxxxxxxxxxxxxx"]# 设置 requireMention: true

3. 多重认证机制

• 结合企业 SSO 系统
• 使用企业 CA 证书
• 配置方式：

  {  "auth": {      "sso": {            "enabled": true,            "provider": "dingtalk"          }  }}

4. 企业级审计日志

• 记录所有操作日志
• 日志上传到企业日志系统
• 配置方式：

  {  "logging": {      "level": "debug",      "destination": "elasticsearch",      "endpoint": "https://log.company.com"  }}

7.2.2 云端部署安全建议

1. 使用 VPC 隔离

• 将 OpenClaw 部署在独立的 VPC 中
• 配置安全组规则，只允许必要端口访问

2. 启用 HTTPS

• 使用 Nginx 反向代理，配置 SSL 证书
• 示例配置：

  server {      listen 443 ssl;      server_name openclaw.company.com;      ssl_certificate /path/to/cert.pem;      ssl_certificate_key /path/to/key.pem;      location / {          proxy_pass http://127.0.0.1:18789;      }  }

3. 定期更新 OpenClaw

• 及时更新到最新版本
• 获取安全补丁
• 配置方式：

  npm update -g openclawopenclaw gateway restart

4. 数据加密存储

• 配置文件、数据库使用加密存储
• API Key 使用密钥管理系统（KMS）

7.3 工具权限限制

在配置文件中，限制 Agent 能使用的工具：

{  "agents": {    "defaults": {      "tools": {        "allowed": ["search", "file.read", "email.send"],        "blocked": ["system.exec", "file.write"]      }    }  }}

常用工具：

• search
  ：搜索网页
• file.read
  ：读取文件
• file.write
  ：写入文件
• system.exec
  ：执行系统命令（高风险）
• email.send
  ：发送邮件

7.4 预算控制设置

在 OpenClaw 配置文件中设置：

{  "agents": {    "defaults": {      "budget": {        "monthly": 100, // 月度预算100元        "alertAt": 80, // 达到80%时发警告        "stopAt": 100 // 达到100%时停止调用      }    }  }}

达到预算上限后，OpenClaw 会：

• 发送警告通知
• 暂停非必要调用
• 保留紧急功能

7.5 v2026.3.7 安全更新说明

v2026.3.7 版本在安全方面做了重大升级，主要包括：

7.5.1 网关层安全

• 网关锁与工具调用 ID 哈希从 SHA-1 升级至 SHA-256
• 强制配置 gateway.trustedProxies 含 loopback 地址，防止同主机代理错误阻断
• 修复 Control UI 权限边界问题：即使允许不安全认证，也必须配合配对设备检查
• 阻止原型链注入 payload 数据泄漏
• 严格解析 X-Forwarded-For 以防代理链伪造

7.5.2 执行系统强化

• 阻塞 Shell heredoc 未引号的执行体注入，防止替换攻击
• 阻止环境变量（BASH_ENV、LD_* 等）注入，防止执行前恶意命令劫持
• Windows 环境中标准化 cmd.exe /c 执行文本，防止尾参数越权
• Sandbox 浏览器容器默认启用专属网络与 VNC 密码验证机制

7.5.3 Docker 与系统级安全强化

• 所有 Docker 构建基准镜像固定 SHA256 摘要，避免标签漂移
• 测试镜像与 E2E 镜像改为非 root 运行，强化沙箱隔离
• systemd 单元文件拒绝 CR/LF 注入，并修复参数逃逸漏洞

第八部分：模型选择与配置

8.1 四大平台对比

8.1.1 快速对比表

8.2 阿里百炼详细配置

8.2.1 获取 API Key

1. 访问 https://common-buy.aliyun.com/?commodityCode=sfm_codingplan_public_cn#/buy
2. 登录/注册阿里云账号
3. 选择套餐（Lite 基础版或 Pro 高级版）
4. 完成支付（支持支付宝/微信）
5. 进入控制台，创建 API Key
6. 复制生成的 Key（格式为 sk-sp-xxxxx）

8.2.2 在 OpenClaw 配置阿里百炼

方式一：通过向导配置

openclaw config wizard# 选择"Model & Auth" → "阿里百炼 (Bailian)" → 粘贴 API Key

方式二：手动配置 编辑配置文件：

nano ~/.openclaw/openclaw.json

添加以下配置：

{  "agents": {    "defaults": {      "model": {        "primary": "bailian/qwen3.5-plus"      },      "auth": {        "provider": "bailian",        "apiKey": "sk-sp-xxxxxxxxxxxxxxxx"      }    }  }}

8.2.3 阿里百炼可用模型

8.3 KIMI 配置方法

8.3.1 获取 API Key

1. 访问 https://www.kimi.com/code
2. 登录/注册 KIMI 账号
3. 订阅 Coding Plan
4. 创建 API Key

8.3.2 配置 OpenClaw

{  "agents": {    "defaults": {      "model": {        "primary": "moonshot/kimi-k2.5"      },      "auth": {        "provider": "moonshot",        "apiKey": "sk-xxxxxxxxxxxxxxxx"      }    }  }}

8.4 MiniMax 配置方法

8.4.1 获取 API Key

1. 访问 https://platform.minimaxi.com/subscribe/coding-plan
2. 注册/登录账号
3. 完成实名认证
4. 订阅 Coding Plan
5. 创建 API Key

8.4.2 配置 OpenClaw

{  "agents": {    "defaults": {      "model": {        "primary": "minimax/MiniMax-M2.5"      },      "auth": {        "provider": "minimax",        "apiKey": "sk-xxxxxxxxxxxxxxxx"      }    }  }}

8.5 GLM 配置方法

8.5.1 获取 API Key

1. 访问 https://bigmodel.cn/glm-coding
2. 注册/登录智谱 AI 账号
3. 进入控制台
4. 创建 API Key

8.5.2 配置 OpenClaw

{  "agents": {    "defaults": {      "model": {        "primary": "zai/glm-5"      },      "auth": {        "provider": "glm",        "apiKey": "xxxxxxxxxxxxxxxx"      }    }  }}

8.6 模型切换与回退

8.6.1 配置主模型和备用模型

OpenClaw 支持配置主模型（primary）和备用模型（fallbacks）：

{  "agents": {    "defaults": {      "model": {        "primary": "bailian/qwen3.5-plus",        "fallbacks": [          "bailian/kimi-k2.5",          "bailian/glm-4.7"        ]      }    }  }}

工作原理：

1. 优先使用 primary 模型
2. 如果 primary 失败（如额度用完、服务异常），自动切换到 fallbacks[0]
3. 如果 fallbacks[0] 也失败，切换到 fallbacks[1]
4. 以此类推

8.6.2 动态切换模型

在对话中临时切换模型：

/model bailian/kimi-k2.5

或在配置中设置规则：

{  "agents": {    "defaults": {      "model": {        "rules": [          {            "when": "message contains '代码'",            "use": "bailian/glm-4.7"          },          {            "when": "message length > 1000",            "use": "bailian/kimi-k2.5"          }        ]      }    }  }}

8.7 成本监控

8.7.1 查看使用统计

openclaw usage

会显示类似：

Monthly usage:- Model: bailian/qwen3.5-plus- Total cost: ¥87.50 (43.75% of budget)- Tokens used: 1,250,000- Requests: 320

第九部分：技能系统

9.1 什么是 ClawHub？

ClawHub 是 OpenClaw 的官方技能注册表，就像手机的应用商店。你可以在这里找到各种现成的技能，一键安装到你的 OpenClaw。

官方地址：https://clawhub.com

截至 2026 年 3 月，ClawHub 已收录超过 3000 个技能，awesome-openclaw-skills 仓库精选了其中 3002 个高质量技能，GitHub 星标 14.5k。

技能涵盖：

• 办公自动化（日报生成、邮件处理）
• 开发辅助（代码生成、调试）
• 内容创作（文案、摘要、翻译）
• 数据分析（数据抓取、可视化）
• 系统管理（文件操作、命令执行）

9.2 搜索技能

openclaw skills search daily-report

应该能看到类似结果：

Found 3 skills matching "daily-report":1. daily-report (v1.2.0) - 自动从飞书群和邮件生成日报   Author: ClawTeam   Rating: ★★★★☆ (128 reviews)   Installation: npx clawhub install daily-report2. feishu-daily (v0.8.5) - 飞书专用日报生成工具   Author: FeishuDev   Rating: ★★★☆ (42 reviews)   Installation: npx clawhub install feishu-daily3. report-assistant (v2.1.3) - 多平台日报/周报生成器   Author: ReportLab   Rating: ★★★★★ (89 reviews)   Installation: npx clawhub install report-assistant

9.3 安装技能

选择第一个 daily-report：

npx clawhub install daily-report

安装过程会显示：

Installing daily-report@1.2.0...- Downloading skill package...- Validating manifest...- Installing dependencies...- Registering with OpenClaw...✅ Skill installed successfully!

9.4 使用技能

在飞书私聊机器人：

生成今天的日报，从"产品研发群"提取关键进展，从邮件提取待办事项

机器人会：

1. 调用飞书 API 读取指定群聊消息
2. 调用邮件 API 获取今日邮件
3. 提取关键信息并整理成日报格式
4. 询问是否保存到本地或发送到指定渠道

9.5 管理技能

9.5.1 查看技能详情

openclaw skills info daily-report

显示技能的详细信息，包括：

• 版本和更新日志
• 所需权限和工具
• 配置选项
• 使用示例

9.5.2 更新技能

npx clawhub update daily-report

或更新所有技能：

npx clawhub update --all

9.5.3 禁用/启用技能

# 禁用openclaw skills disable daily-report# 启用openclaw skills enable daily-report

9.5.4 卸载技能

npx clawhub uninstall daily-report

9.6 热门技能推荐

9.6.1 开发辅助类

coding-agent - 代码自动生成、优化、调试

npx clawhub install coding-agent

critical-code-reviewer - 代码审核，识别潜在问题

npx clawhub install critical-code-reviewer

api-doc-generator - 根据代码注释生成标准化 API 文档

npx clawhub install api-doc-generator

9.6.2 办公自动化类

email-automation - 邮件自动回复、分类、归档

npx clawhub install email-automation

meeting-minutes - 从会议录音/转录生成会议纪要

npx clawhub install meeting-minutes

humanizer - 去除 AI 写作痕迹，让文本更自然

npx clawhub install humanizer

9.6.3 内容创作类

social-media-helper - 社交媒体内容生成（适配不同平台风格）

npx clawhub install social-media-helper

translation-helper - 多语言翻译与本地化适配

npx clawhub install translation-helper

image-prompt-generator - 图片生成提示词优化

npx clawhub install image-prompt-generator

第十部分：进阶技巧

10.1 自定义 Prompt 模板

你可以创建自定义的 Prompt 模板，让 AI 助理按照固定的格式回复。

创建模板文件 ~/.openclaw/templates/daily-report.md：

# 日报模板## 今日完成- [任务1]- [任务2]## 遇到的问题- [问题描述]## 明日计划- [计划1]- [计划2]

然后在对话中引用：

使用 daily-report 模板整理今天的日报

10.2 批量任务处理

OpenClaw 支持批量处理任务，提高效率。

示例：批量生成周报

帮我生成本周的周报，包含以下内容：1. 项目 A 的进度2. 项目 B 的进度3. 遇到的问题4. 下周计划

10.3 自动化工作流

你可以配置自动化工作流，让 AI 助理在特定条件下自动执行任务。

示例配置：

{  "workflows": {    "daily-report": {      "trigger": "cron 0 18 * * 1-5",      "action": "generate daily report",      "output": "send to #report-channel"    }  }}

10.4 性能优化建议

1. 选择合适的模型

• 简单任务用轻量模型
• 复杂任务用大模型

2. 缓存常用结果

• 开启 session-memory hook
• 避免重复计算

3. 限制上下文长度

• 设置合理的 maxTokens 参数
• 避免传递过多无关信息

4. 使用 fallback 模型

• 主模型失败时自动切换
• 提高可用性

第十一部分：故障排除

11.1 网络连接问题

11.1.1 检查网络连接

# 测试 AI 服务商连通性curl https://api.moonshot.cn/v1/chat/completionscurl https://api.minimax.chat/v1/text/chatcompletion

11.1.2 配置代理

如果需要代理，在配置文件中设置：

{  "network": {    "proxy": "http://127.0.0.1:7890"  }}

11.2 API 调用失败

11.2.1 检查 API Key

openclaw config get agents.defaults.auth.apiKey

11.2.2 检查额度

openclaw usage

11.2.3 查看详细日志

openclaw logs --level=debug

11.3 消息无响应

11.3.1 检查 Gateway 状态

openclaw gateway status

如果 Gateway 没运行，执行：

openclaw gateway start

11.3.2 检查 Channel 状态

openclaw channels list

确认 Channel 状态为 enabled。

11.3.3 检查配对状态

openclaw pair list

确认用户已通过配对。

11.4 获取帮助

如果以上方法都无法解决问题，可以通过以下方式获取帮助：

1. 查看官方文档：https://github.com/alexmelges/openclaw
2. 加入 OpenClaw 社区：[社区链接]
3. 提交 Issue：https://github.com/alexmelges/openclaw/issues

第十二部分：云服务商部署方案对比

12.1 阿里云部署方案

12.1.1 轻量应用服务器（推荐）

优势：

• 开箱即用，预装 OpenClaw 专用镜像
• 一键部署，无需复杂配置
• 成本低，2核4G 起步 50-100元/月
• 国内访问速度快

部署步骤：

1. 访问 https://www.aliyun.com/product/swas
2. 选择应用镜像 → AI智能体 → OpenClaw(Clawdbot)
3. 选择实例规格：2核4G 起步
4. 选择地域：华东（杭州）或华北（北京）
5. 完成支付

12.1.2 无影云电脑（需要可视化界面）

优势：

• 提供完整的云电脑体验
• 可视化桌面界面
• 支持图形化操作

部署步骤：

1. 访问 https://www.aliyun.com/product/wuying-dc
2. 选择 OpenClaw 专属套餐
3. 选择配置：4核8G 起步

12.1.3 函数计算 AgentRun（适合开发者）

优势：

• 按需计费，成本更低
• 自动弹性伸缩
• 无需管理服务器

部署步骤：

1. 访问 https://www.aliyun.com/product/fc/agentrun
2. 选择运行时：Python 3.10+
3. 配置网络：VPC、交换机
4. 一键部署

12.2 腾讯云部署方案

12.2.1 Lighthouse 轻量应用服务器

优势：

• 开箱即用，预装 OpenClaw 专属镜像
• 一键部署，无需复杂配置
• 成本低，2核4G 起步 50-100元/月
• 广州/上海节点，国内访问速度快

部署步骤：

1. 访问 https://cloud.tencent.com/product/lighthouse
2. 选择应用镜像 → AI智能体 → OpenClaw(Clawdbot)
3. 选择实例规格：2核4G 起步
4. 选择地域：广州、上海或北京
5. 完成支付

12.2.2 云函数（适合轻量场景）

优势：

• 按需计费，成本更低
• 自动弹性伸缩
• 无需管理服务器

部署步骤：

1. 访问腾讯云函数计算
2. 选择 Python 3.10+ 运行时
3. 配置触发器和函数逻辑
4. 部署函数

12.3 火山引擎部署方案

12.3.1 火山引擎 ECS

优势：

• 字节跳动云服务
• 高性能计算
• AI 算力优化
• 支持大规模并发

部署步骤：

1. 访问火山引擎控制台
2. 选择 ECS 实例
3. 选择镜像：OpenClaw 镜像
4. 选择配置：4核8G 起步

12.3.2 火山引擎函数计算

优势：

• 按需计费
• 无服务器管理
• 自动伸缩

部署步骤：

1. 访问火山引擎函数计算
2. 选择 Python 3.10+ 运行时
3. 配置函数逻辑
4. 部署函数

12.4 华为云部署方案

12.4.1 华为云 ECS

优势：

• 国有云，安全可靠
• 企业级服务
• 等保三级认证
• 政府机构首选

部署步骤：

1. 访问华为云控制台
2. 选择 ECS 实例
3. 选择镜像：OpenClaw 镜像
4. 选择配置：4核8G 起步

12.4.2 华为云函数计算

优势：

• 按需计费
• 自动伸缩
• 成本优化

部署步骤：

1. 访问华为云函数计算
2. 选择 Python 3.10+ 运行时
3. 配置函数逻辑
4. 部署函数

12.5 云服务商对比表

选型建议：

• 个人用户快速体验
  ：推荐阿里云或腾讯云轻量应用服务器，一键部署，成本最低
• 中小企业长期使用
  ：推荐阿里云或腾讯云轻量应用服务器，稳定可靠
• AI 开发者
  ：推荐火山引擎，高性能计算，AI 算力优化
• 政府机构/大型企业
  ：推荐华为云，安全可靠，等保三级认证
• 成本敏感场景
  ：推荐阿里云 AgentRun 或腾讯云函数，按需计费，成本更低

第十三部分：平替竞品对比

13.1 EasyClaw（极简版）

简介

EasyClaw 是由猎豹移动推出的桌面端 AI Agent 应用，基于 OpenClaw 框架，实现"一键安装、零配置、无需API Key"。

核心特点

1. 极简安装

• 一键安装包，开箱即用
• 无需配置环境，无需 Docker
• 支持 macOS / Windows / Linux

2. 零配置运行

• 无需 API Key，开箱即用
• 数据完全私有，运行在本地

3. 与本地文件深度联动

• 直接操作本地文件
• 支持多格式文档处理

4. 开源透明

• 开源项目，可自由定制
• 代码完全透明

5. 多渠道接入

• 飞书
• 钉钉
• QQ
• WhatsApp
• Telegram
• Discord

适用场景

• 个人用户快速体验
• 不想折腾配置的小白
• 注重数据隐私的用户
• 只需要基础 AI 助理功能的场景

优势

✅ 零门槛：无需任何技术基础，一键安装 ✅ 开箱即用：无需配置环境、API Key ✅ 数据安全：本地运行，数据不离开电脑 ✅ 快速上手：30秒内完成安装

劣势

❌ 功能限制：相比 OpenClaw，功能简化 ❌ 灵活性低：不支持复杂自定义和二次开发 ❌ 扩展性差：技能生态不如 OpenClaw 丰富

获取方式

1. 访问 EasyClaw 官网：https://sanwan.ai/easyclaw.html
2. 下载安装包（支持 macOS / Windows / Linux）
3. 一键安装

13.2 QoderWork（阿里桌面代理）

简介

QoderWork 是阿里旗下 Qoder 团队开发的首个桌面 AI 代理，不是聊天机器人，而是一个真正能"做事"的 AI 办公伙伴。

核心特点

1. 本地优先，隐私安全

• 所有操作在本地沙箱环境运行
• 数据不离本地
• 明确授权，AI 只有在你授权后才能访问文件和应用

2. 自主工作流规划

• 理解你的自然语言描述
• 自动创建执行计划
• 独立完成整个工作流程
• 直接操作本地文件

3. 直接操作本地文件

• 支持 Excel、Word、PDF、PPT 等主流格式
• 无需手动上传下载
• 直接读取、编辑、创建文件

4. MCP 协议支持

• 可扩展的工具生态系统
• 标准化的技能插拔机制
• 跨工具协作能力

5. 多渠道支持

• macOS 11+（完全支持）
• Windows 10/11（完全支持）

适用场景

• 数据分析师：分析销售数据，生成可视化报告和 PPT
• 内容创作者：将 1 小时播客录音整理成双语字幕文件
• 文件整理：按类别整理文件，去重
• 视频生成：将 PDF 文档或一句话生成视频

优势

✅ 背靠大厂：阿里出品，技术实力有保障 ✅ 本地优先：数据安全，隐私可控 ✅ 开箱即用：无需复杂部署 ✅ 中文友好：原生支持中文交互 ✅ 技能系统：支持自定义技能创建

劣势

❌ 系统限制：目前主要支持 macOS，Windows 支持有限 ❌ 渠道集成：渠道生态不如 OpenClaw 丰富 ❌ 开源程度：不开源，定制能力有限

获取方式

1. 访问 QoderWork 官网：https://www.qoderwork.org/
2. 下载安装包
3. 安装并配置

13.3 StepFun/阶跃AI助手

简介

阶跃AI（StepFun）是由上海阶跃星辰智能科技有限公司开发的多功能 AI 助手，搭载自研的 Step 系列大模型，在中国 AI 领域被称为"六小虎"之一。

核心特点

1. 多模态交互能力

• 支持文本、图像、文档、网页等多类型输入
• 图文语音混合问答
• 上传学术论文、合同等长文档进行结构化分析

2. 强大的内容处理功能

• 长文总结能力：处理高达十万字的文本报告
• 文档解析：支持 PDF、Word 等格式
• 拍照解题：针对学生群体，通过拍照获得数学题解题思路

3. AI 创作与编辑功能

• AI 写作：文章撰写、邮件写作、创意文案
• 智能生图：根据文字描述生成图片
• 视频生成：输入脚本生成高质量视频，支持最长 10 秒 1080P 视频

4. 语音交互与克隆

• 自然对话：能够根据不同场景生成情绪、方言、语种表达
• 音色复刻：仅需 5 秒声纹样本即可实现个性音色克隆
• 多语言支持：在汉语水平考试六级评测中表现突出

适用场景

• 学习辅助：拍照解题、长文总结、知识库问答
• 内容创作：AI 写作、生图、视频生成
• 多模态理解：图片识别、文档解析、网页摘要
• 语音交互：音色克隆、语音通话

优势

✅ 完全免费：目前完全免费向用户开放 ✅ 多模态能力强：文本、图像、语音、视频全覆盖 ✅ 中文优化：针对中文语境深度优化，能很好地处理古诗文和网络流行语 ✅ 语音交互突出：Step-Audio 模型在多项测试中超过同类型开源模型 ✅ 视频生成性能：Step-Video-T2V 是目前全球范围内参数量最大、性能最好的开源视频生成模型

劣势

❌ 不是 Agent 框架：更像是全能 AI 助手应用，而不是可编程的 Agent 平台 ❌ 扩展性有限：无法像 OpenClaw 那样自由扩展和自定义 ❌ 本地运行限制：主要是云端服务，本地化能力有限

获取方式

1. 访问阶跃 AI 官网：https://www.stepfun.com/chats/new
2. 注册账号
3. 直接使用

13.4 MiniMax助手（开源框架）

简介

MiniMax Agent 是由 MiniMax 公司开源的极简而专业的 AI Agent 开发框架，旨在展示使用 MiniMax-M2.1 模型构建智能代理的最佳实践。

核心特点

1. 完整的 Agent 执行循环

• 感知 → 思考 → 行动 → 反馈
• 通过 LLM 进行决策，调用工具执行任务
• 将执行结果反馈给 LLM，形成闭环

2. 持久化记忆能力

• 内置的 Session Note Tool 确保 Agent 能够在多个会话中保留关键信息
• 实现跨会话的记忆持久化

3. 智能上下文管理

• 采用自动摘要机制处理长对话场景
• 当上下文接近 Token 限制时，自动压缩历史对话

4. 丰富的工具生态

• 基础工具集：文件读写、Shell 命令执行
• Claude Skills 集成：内置 15 种专业技能
• MCP 工具支持：原生支持 Model Context Protocol (MCP)

5. 兼容多种 API

• 兼容 Anthropic 和 OpenAI 的 API 接口
• 支持不同模型厂家的 LLM API 接入

适用场景

• Agent 开发：快速构建自己的智能体
• 代码开发：利用 MiniMax-M2.1 的强大代码能力
• 办公自动化：文件处理、数据分析、任务自动化

优势

✅ 极简设计：轻量、简洁、易扩展 ✅ 核心能力：完整的 Agent 执行循环 ✅ 开源可定制：完全开源，可自由定制 ✅ 模型强大：基于 MiniMax-M2.1 模型 ✅ 中文优化：针对中文场景优化

劣势

❌ 学习曲线：相比 EasyClaw，需要一定的学习成本 ❌ 功能单一：专注于 Agent 开发，不像 OpenClaw 那样功能全面 ❌ 生态较小：社区和技能生态不如 OpenClaw 成熟

获取方式

1. 访问 MiniMax Agent 官网：https://agent.minimaxi.com/
2. 下载开源代码
3. 本地部署或云端部署

13.5 CoPaw（企业级智能体工作站）

简介

CoPaw（Co Personal Agent Workstation）是基于 AgentScope 框架构建的开源个人 AI 助手，支持本地或云端部署，连接你常用的聊天应用，运行本地大模型，完全掌控隐私。

核心特点

1. 多渠道聊天集成

• 原生连接钉钉、飞书、QQ、Discord、iMessage 等平台
• 一个助手，多个渠道
• 在你沟通的任何地方使用 AI

2. 本地大模型运行

• 在本地完整运行大语言模型
• 无需 API 密钥，无需云依赖
• 支持 llama.cpp（跨平台）和 MLX（Apple Silicon M1–M4）

3. 模块化 Agent 架构

• Prompt、Hooks、Tools、Memory 均为解耦组件
• 可独立替换或扩展任何模块
• 组装你自己的 Agent

4. 可扩展技能系统

• 内置定时调度和自定义技能
• 从工作区自动加载
• 开箱即用提供实用技能

5. 长期记忆与心跳

• 持久化长期记忆，主动记住你的决策、偏好和待办事项
• 创新的心跳机制让它能自主执行定时任务

适用场景

• 个人数字助手：日常任务自动化、信息管理
• 多平台统一管理：一个助手连接多个聊天平台
• 企业级应用：团队协作、知识管理、流程自动化

优势

✅ 完全开源：基于 AgentScope 框架，完全开源 ✅ 模块化设计：Prompt、Hooks、Tools、Memory 完全解耦 ✅ 本地模型支持：支持 llama.cpp 和 MLX 本地运行 ✅ 多渠道集成：原生支持钉钉、飞书、QQ、Discord、iMessage ✅ 企业级安全：数据完全掌控，支持企业级部署

劣势

❌ 学习曲线：模块化设计，学习曲线较陡 ❌ 配置复杂：相比 EasyClaw，配置较为复杂 ❌ 社区生态：社区和技能生态不如 OpenClaw 成熟

获取方式

1. 访问 CoPaw 官网：https://copaw.bot/zh/
2. 下载开源代码
3. 本地部署或云端部署

13.6 竞品对比表

选型建议：

• 完全新手，不想折腾
  ：EasyClaw（极简安装，一键上手）
• 阿里生态用户
  ：QoderWork（阿里出品，与阿里云深度集成）
• 多模态内容创作
  ：StepFun/阶跃AI（免费、全能、视频生成能力强）
• Agent 开发学习
  ：MiniMax Agent（极简设计，学习 Agent 原理）
• 个人/企业级应用
  ：CoPaw（模块化设计，本地模型支持）
• 全面自定义，最强生态
  ：OpenClaw （功能最全，社区最活跃）

结语

恭喜你完成了 OpenClaw 的学习！

通过本指南，你已经掌握了：

• ✅ OpenClaw  的本地和云端安装
• ✅ 飞书、钉钉、QQ 三大平台接入
• ✅ 个人和企业级安全配置
• ✅ 模型的选择和切换
• ✅ 技能系统的使用
• ✅ 进阶技巧和故障排除
• ✅ 云服务商对比（阿里云、腾讯云、火山引擎、华为云）
• ✅ 平替竞品对比（EasyClaw、QoderWork、StepFun、MiniMax、CoPaw）

OpenClaw  的生态还在不断发展，新的技能和功能每天都在涌现。建议你：

1. 定期更新 OpenClaw 到最新版本（3.7+），以获取最新的安全补丁和功能增强
2. 关注 ClawHub 上的热门技能，扩展你的 AI 助手能力
3. 加入 OpenClaw 社区，分享你的使用经验
4. 尝试开发自己的技能，解决特定领域的问题
5. 根据实际需求选择合适的云服务商和竞品，构建最适合你的 AI 解决方案

记住，AI 工具的价值在于解决实际问题。从今天开始，让 OpenClaw 帮你处理重复工作，释放你的创造力！

参考来源：

• OpenClaw 官方 GitHub 仓库
• OpenClaw v2026.3.7 更新日志
• 阿里云 OpenClaw 部署教程
• 腾讯云 OpenClaw 部署教程
• EasyClaw 官网
• QoderWork 官网
• StepFun/阶跃AI 官网
• MiniMax Agent 官网
• CoPaw 官网