OpenClaw 知识库 (完整版)

沈馆长专用 · 2026-03-16 更新
基于官方文档整理的完整知识库,包含部署、配置、变现全链路

---

一、OpenClaw 是什么?

OpenClaw 是一个自托管的 AI 助手网关,可以连接多个聊天应用到 AI 代理。

核心特点

说明 |
------|
运行在你的服务器/电脑上,数据自己掌控 |
WhatsApp、Telegram、Discord、企业微信、QQ Bot 等 15+ 平台 |
内置编码代理,支持工具调用、会话、记忆 |
支持 Mattermost、飞书等额外渠道 |
可运行多个隔离的独立代理 |
浏览器控制面板 |
Cron 定时任务、Heartbeat 心跳、Webhook 钩子 |

支持的渠道

状态
------
✅ 稳定
✅ 稳定
✅ 稳定
✅ 稳定
✅ 稳定
✅ 稳定
✅ 稳定
✅ 稳定
✅ 稳定
✅ 稳定
✅ 稳定
✅ 稳定
✅ 稳定
✅ 稳定

---

二、安装与快速开始

方式一:npm/pnpm 安装(推荐)

方式二:Docker 部署(服务器推荐)

快速启动

---

三、配置文件详解

配置文件位置

完整配置模板

配置管理命令

热重载

Gateway 会监视配置文件,大部分修改会自动生效,无需重启。

---

四、渠道配置

4.1 QQ Bot 配置(当前使用)

配置步骤:
1. 在 QQ 开放平台 (https://open.qq.com/) 创建机器人
2. 获取 AppID 和 AppSecret
3. 添加测试用户或发布机器人
4. 配置 openclaw.json

重要提示:

  • 未添加测试用户会出现"灵魂不在线"
  • 沙箱环境需要先添加测试 QQ 号

4.2 企业微信配置

4.3 Telegram 配置

4.4 DM 策略

说明 |
------|
默认,未知发送者需要配对码 |
仅允许列表中的用户 |
允许所有消息 |
禁用 |

---

五、多实例部署

端口分配

目录 用途 |
------------|
日常任务 + 企业微信 |
专用 QQ Bot |

多实例配置要点

systemd 服务配置

---

六、自动化功能

6.1 Cron 定时任务

6.2 Heartbeat 心跳

6.3 QQ Bot 提醒配置(重要)

要点:

  • 必须是 (不是 systemEvent)
  • 、、 缺一不可

---

七、模型配置

支持的模型提供商

模型示例
----------
tc-code-latest
claude-sonnet-4-5, claude-opus-4-6
gpt-4o, gpt-4o-mini
moonshot-v1-8k
qwen-turbo
ernie-4.0-8k
abab6.5s-chat
llama2, mistral

配置示例

---

八、工作区与记忆系统

工作区结构

核心文件说明

用途
------
AI 人格和语气定义
用户个人信息
长期记忆库
定期检查任务
工作区规则和约定

---

九、Skills 技能系统

安装技能

创建自定义技能

常用技能

功能 |
------|
天气查询 |
GitHub 操作 |
Obsidian 笔记 |
视频帧提取 |
内容摘要 |
网页搜索研究 |

---

十、常用命令速查

Gateway 管理

消息发送

Cron 任务

配置管理

诊断

---

十一、故障排除

常见问题

解决方法 |
----------|
检查 |
|
检查日志 |
确认热重载或手动重启 |
检查 API Key 配置 |
添加测试用户到 QQ 开放平台 |
查看占用 |

重置配置

---

十二、企业服务变现路径

产品矩阵

价格
------
¥3,999-19,999
¥1,999-9,999/月
¥999-4,999/月
¥12,999-49,999+

目标客户画像

核心需求
----------
客服自动化、会员管理
客户跟进、话术库
家长沟通、课程提醒
文档生成、日程管理

变现优势

说明 |
------|
茶馆可现场演示体验 |
1000+老板资源 |
自己在用,有真实案例 |
不用租办公室,茶馆就是办公地 |

---

十三、安全配置

访问控制

敏感操作审批

---

十四、资源链接

  • 官网文档:https://docs.openclaw.ai
  • ClawHub 技能市场:https://clawhub.com
  • GitHub:https://github.com/openclaw
  • Discord 社区:https://discord.com/invite/clawd

---

附录:当前部署状态

信息 |
------|
VM-0-6-ubuntu (腾讯云) |
/.openclaw-bot2 |
18790 |
tencentcodingplan/tc-code-latest |
QQ Bot |
v22.22.1 |
Ubuntu 24.04 LTS |

---

本知识库基于 OpenClaw 官方文档整理
最后更新: 2026-03-16

---

附录二:技能市场(已安装)

已安装技能目录

功能
------
浏览器自动化
抖音视频发布
ClawHub 技能发现
前端页面设计
GitHub 操作
HTML 开发
落地页生成
Obsidian 笔记
静态网站部署
内容摘要
Tavily 网络搜索
腾讯云轻量服务器
腾讯云对象存储
腾讯文档
天气查询
网页内容获取
网页搜索研究
小红书

待配置技能

依赖
------
TAVILYAPIKEY
PERPLEXITYAPIKEY

---

附录三:晚间学习记录(2026-03-16)

今日完成

1. 技能资产盘点:17个技能已安装
2. 知识库更新:新增技能目录和待配置清单
3. 版本跟踪:OpenClaw v2026.3.13-1 发布

明日计划

1. 配置网络搜索 API(PERPLEXITYAPIKEY / TAVILYAPIKEY)
2. 测试 agent-browser 网页抓取能力
3. 开发企业微信智能客服技能
4. 升级 A股行情监控 cron 任务

商业机会

  • 餐饮零售 AI 客服:¥3,999-9,999
  • 销售跟进系统:¥9,999-19,999
  • 教育机构内容生成:¥5,999-15,999
  • 律师咨询自动化:¥15,999-29,999

---

更新记录:2026-03-16 23:30