夜雨聆风什么是 OpenClaw
OpenClaw 是开源、自托管的 AI Agent 网关，绰号「龙虾」（Lobster）。与 ChatGPT 等对话式 AI 不同，OpenClaw 是主动执行任务的 Agent——它可以管理你的邮件、操作浏览器、执行 Shell 命令、读写文件，并同时接入 20+ 消息平台，让 AI 真正成为你 24 小时在线的个人助理。所有数据完全存储在你自己的服务器上。
OpenClaw 的核心理念是：将 AI 大模型的能力接入你日常使用的每一个消息平台，实现真正的跨平台 AI 自动化。
1.1 项目基本信息
1.2 OpenClaw 的三大核心能力
生活自动化：接管邮件、日历、消息管理；浏览网页、填写表单、数据抽取；文件读写、Shell 命令执行；智能提醒与行程规划。
多平台接入：支持 20+ 聊天平台，包括 Telegram、Discord、WhatsApp、Slack、飞书、钉钉、QQ、企业微信等。一个 Agent 实例可以同时在所有平台上响应指令。
企业部署：作为客服机器人、运营助手、数据分析员，通过 openclaw-china 插件三步完成国内企业平台的 Docker 部署。
1.3 OpenClaw vs ChatGPT：核心区别
2. 核心架构解析
理解 OpenClaw 的架构是用好它的前提。整个系统由三个核心层次构成：
2.1 Gateway（消息网关）
Gateway 是 OpenClaw 的核心枢纽，默认监听 ws://127.0.0.1:18789。负责统一接收来自所有消息平台的消息、路由给 AI 模型处理、将响应发回对应平台、管理 Skills 的加载与执行。
openclaw gateway --port 18789 --verbose2.2 四层记忆系统
四层记忆系统是 OpenClaw 区别于普通聊天机器人的关键特性，从持久到临时依次为：
*重要提示：SOUL.md 是 Agent 的「灵魂文件」。ClawHavoc 供应链攻击中，恶意 Skill 专门篡改此文件来「洗脑」Agent。请务必定期检查其内容。*
2.3 配置文件体系
3. 安装与初始化
3.1 环境要求
• Node.js：>= 22（建议 LTS 版本）• 操作系统：macOS / Linux / Windows（WSL2）• 网络：能够访问 AI 模型 API
3.2 标准安装三步流程
第一步：全局安装 OpenClaw
npm install -g openclaw@latest⚠️ 安全警告：请务必使用官方包名 openclaw，不要安装任何带前缀的变体（如@openclaw-ai/openclawai）。2026年3月曾出现恶意 npm 包@openclaw-ai/openclawai伪装成官方安装器，实际安装的是 GhostLoader 远程访问木马。
第二步：引导式初始化
openclaw onboard --install-daemon此命令会引导你完成：
• 选择 AI 模型提供商并配置 API Key• 选择消息渠道（Telegram、Discord 等）• 安装守护进程（确保 Gateway 开机自启）
3.3 版本管理与更新
# 检查当前版本 openclaw version # 更新到最新版 npm update -g openclaw@latest # 查看所有可用版本 npm view openclaw versions --json3.4 本地备份
建议在升级版本或修改配置前先创建备份：
# 创建完整备份 openclaw backup create # 仅备份配置文件 openclaw backup create --only-config # 验证备份完整性 openclaw backup verify # 列出已有备份 openclaw backup list # 从备份恢复 openclaw backup restore <备份名>4. 部署方案选择
4.1 各方案对比
4.2 npm 本地安装
npm install -g openclaw@latest openclaw onboard --install-daemon4.3 Docker 部署
# docker-compose.yml 示例 version: '3.8' services: openclaw: image: openclaw/openclaw:latest restart: unless-stopped ports: - "18789:18789" volumes: - ~/.openclaw:/root/.openclaw # 后台启动 docker-compose up -d # 查看实时日志 docker-compose logs -f # 更新到最新镜像 docker-compose pull && docker-compose up -d4.4 云服务器部署（推荐）
适合需要 24/7 在线服务的大多数用户。国内云服务器约 68 元/年 起即可运行 OpenClaw。
推荐配置：
• CPU：2 核• 内存：2 GB• 带宽：1 Mbps• 系统：Ubuntu 22.04 LTS
4.5 远程访问配置
Tailscale（官方推荐）
# 安装 Tailscale curl -fsSL https://tailscale.com/install.sh | sh # 登录 tailscale up # 仅 Tailscale 网络内可访问（推荐） tailscale serve --bg https+insecure://127.0.0.1:18789 # 公网可访问（适合 webhook 回调） tailscale funnel --bg https+insecure://127.0.0.1:18789SSH 端口转发
ssh -L 18789:127.0.0.1:18789 user@your-server*核心建议：大部分渠道（Telegram long-polling、Discord、Slack Socket Mode、钉钉 Stream 模式）都是 bot 主动连接服务器，不需要公网 IP。只有需要 webhook 回调的场景才需要 Funnel 暴露公网地址。*
5. 渠道接入指南
OpenClaw 通过 Gateway 架构统一连接 20+ 聊天平台，所有渠道共享三步接入模式：
在平台创建凭证 → 写入 openclaw.yaml → 启动 Gateway → 完成配对5.1 新手推荐接入顺序
1. Telegram（推荐入门，5分钟）— 不需要公网 IP
2. QQ（国内首选，1分钟）— 扫码即用
3. 飞书（内置支持）— 企业用户首选
4. Discord（社区场景，15分钟）
5.2 Telegram（推荐入门 · 5 分钟）
Telegram 是 OpenClaw 官方推荐的入门渠道，使用 long-polling 模式，不需要公网 IP、反向代理或端口转发。
Step 1：创建 Bot
在 Telegram 搜索 @BotFather，发送 /newbot，按提示设置 bot 名称和用户名，获取 Bot Token。
Step 2：写入配置
# ~/.openclaw/openclaw.yaml channels: telegram: enabled: true botToken: "YOUR_BOT_TOKEN" dmPolicy: pairing # 陌生用户需配对码Step 3：重启并配对
openclaw gateway restart在 Telegram 中给 bot 发消息，输入配对码即可开始对话。
5.3 Discord（社区场景首选 · 15-20 分钟）
Step 1：创建 Application
在 discord.com/developers/applications 创建 Application → Bot → 获取 Token
Step 2：配置权限
开启以下权限：
• Message Content Intent• Server Members Intent
Step 3：邀请 Bot
生成邀请链接，加入服务器
Step 4：写入配置
channels: discord: enabled: true botToken: "YOUR_DISCORD_BOT_TOKEN" guildId: "YOUR_SERVER_ID" dmPolicy: pairing5.4 WhatsApp（日常通讯 · 10-15 分钟）
WhatsApp 使用 Baileys 库通过 QR 码扫码连接，不需要 WhatsApp Business API。
openclaw onboard # 选择 WhatsApp 渠道，扫描终端显示的 QR 码*注意：建议使用独立号码运行 WhatsApp，不要用主号。Gateway 运行时建议用 Node 而非 Bun。*
5.5 Slack（企业团队场景 · 25-40 分钟）
Slack 默认使用 Socket Mode（WebSocket），不需要公网 URL。
Step 1：创建 Slack App
在 api.slack.com/apps 创建 App
Step 2：启用 Socket Mode
App Settings → Socket Mode → Enable
Step 3：配置权限范围
chat:write channels:history groups:history im:history mpim:historyStep 4：安装到 Workspace，获取 Token 写入配置
channels: slack: enabled: true appToken: "xapp-xxxxx" botToken: "xoxb-xxxxx"5.6 国内平台接入
#### 飞书（OpenClaw 2026.2 起内置）
openclaw onboard # 选择 Feishu channel，按提示配置 App ID 和 App Secret或在 open.feishu.cn/app 创建企业自建应用获取凭证。
#### QQ（国内首选 · 扫码即用）
腾讯官方开放了 QQ Bot 能力，扫码 1 分钟完成绑定，支持 Markdown、图片、语音、文件等多媒体消息。
channels: qq: enabled: true platform: qq # 通过扫码绑定#### 微信（官方插件接入）
需要微信 8.0.70 版本，通过「设置 → 插件 → 微信 ClawBot」执行安装命令：
npx -y @tencent-weixin/openclaw-weixin-cli@latest install#### 钉钉（Stream 模式免公网）
openclaw plugins install @soimy/dingtalk#### openclaw-china 统一插件
一站式国内平台支持，覆盖飞书、钉钉、QQ、企微、微信：
git clone https://github.com/BytePioneer-AI/openclaw-china.git cd openclaw-china pnpm install && pnpm build openclaw china setup # 交互式配置向导6. Skills 技能系统
Skills 是 OpenClaw 的能力扩展单元，相当于 AI Agent 的「插件」，类似 npm 之于 Node.js。
6.1 三层优先级体系
6.2 ClawHub 技能市场
常用命令：
# 安装 Skill（交互式） openclaw skills install # 搜索 Skill（支持自然语言） openclaw skills search "browser automation" openclaw skills search "发送邮件" # 列出已安装的 Skills openclaw skills list # 查看 Skill 详情 openclaw skills info <skill-name> # 卸载 Skill openclaw skills uninstall <skill-name> # 更新所有 Skills openclaw skills update6.3 必装 Top 10 Skills（推荐精选）
*实用建议：不要一次性安装太多 Skills。每个 Skill 都会增加 system prompt 长度，占用上下文窗口。建议从 Top 10 中选择真正需要的 3-5 个开始。*
6.4 自建 Skill 指南
一个 Skill 的最小单位就是一个目录加一个 SKILL.md 文件：
my-skill/ ├── SKILL.md # 必须。Skill 的核心定义文件 ├── scripts/ # 可选。辅助脚本 │ └── helper.py ├── templates/ # 可选。模板文件 │ └── report.md └── README.md # 可选。说明文档SKILL.md 完整格式示例：
# My Custom SkillDescription
帮助用户进行每日工作汇总，生成结构化的日报。
Trigger
当用户提到「日报」「工作总结」「今日汇报」时激活。
Instructions
1. 询问用户今天完成了哪些工作
2. 按项目分类整理
3. 标注每项工作的状态（已完成 / 进行中 / 阻塞）
4. 生成 markdown 格式的日报
5. 保存到 ~/reports/YYYY-MM-DD.md
Environment Variables
• REPORTS_DIR: 日报存储目录（默认 ~/reports）
Tools Required
• file_write• memory_search
Examples
用户：「帮我写个日报」
助手：「好的，请告诉我你今天完成了哪些工作？」
7. 模型配置与选型
OpenClaw 最大的优势之一是模型自由：可以灵活切换主力模型、设置 Fallback 备选链、让不同任务走不同模型。
7.1 核心配置结构
// ~/.openclaw/openclaw.json { "env": { "API_KEY_NAME": "sk-xxx" }, "agents": { "defaults": { "model": { "primary": "provider/model-name", "fallbacks": ["provider/model-b"] } } }, "models": { "mode": "merge", "providers": { } } }*重要：务必设置 models.mode: "merge"，否则自定义配置会覆盖所有内置 Provider。*
7.2 国际模型对比
⚠️ Claude OAuth 警告：Anthropic 已封杀 OAuth 认证方式。使用 Claude Pro/Max 订阅账户通过 OAuth 连接 OpenClaw 的用户会被警告甚至锁定账户。目前唯一合法路径是使用 API Key（按量付费）。
省钱技巧：
• Batch API 享 50% 折扣• Prompt Caching 可降低重复上下文成本达 90%• 日常任务用 Sonnet，复杂任务再升级 Opus
7.3 国产模型对比
7.4 DeepSeek 配置示例
{ "env": { "DEEPSEEK_API_KEY": "sk-xxx" }, "models": { "mode": "merge", "providers": { "deepseek": { "baseUrl": "https://api.deepseek.com/v1", "apiKey": "${DEEPSEEK_API_KEY}", "api": "openai-completions", "models": [ { "id": "deepseek-chat", "contextWindow": 128000, "maxTokens": 8192 } ] } } } }7.5 GLM-5 配置（极简）
# OpenClaw 内置 zai Provider，配置极简 openclaw onboard --auth-choice zai-api-key7.6 Qwen 3.5 配置
# 启用千问插件 openclaw plugins enable qwen-portal-auth openclaw gateway restart openclaw models auth login --provider qwen-portal --set-default7.7 聚合平台
7.8 本地模型（完全免费）
通过 Ollama 运行本地模型：
# 安装 Ollama curl -fsSL https://ollama.com/install.sh | sh # 拉取模型 ollama pull qwen2.5:32b ollama pull llama3.2:3b ollama pull deepseek-v3:14b # OpenClaw 配置本地模型 openclaw models add ollama --local7.9 推荐配置方案
方案一：混合最优（推荐）
{ "agents": { "defaults": { "model": { "primary": "anthropic/claude-sonnet-4-6", "fallbacks": [ "anthropic/claude-haiku-4-5", "deepseek/deepseek-chat" ] } } } }方案二：国内省钱
{ "agents": { "defaults": { "model": { "primary": "deepseek/deepseek-chat", "fallbacks": [ "qwen/qwen-turbo" ] } } } }方案三：零成本
{ "agents": { "defaults": { "model": { "primary": "google/gemini-flash-2.0-exp", "fallbacks": [ "ollama/qwen2.5:32b" ] } } } }8. 安全防护指南
8.1 默认安全机制
Gateway 认证配置：
{ "gateway": { "bind": "127.0.0.1", "port": 18789, "auth": { "mode": "token", "token": "your-secret-token" } } }8.2安全最佳实践
# 1. 定期检查 SOUL.md 和 MEMORY.md cat ~/.openclaw/workspace/SOUL.md cat ~/.openclaw/workspace/MEMORY.md # 2. 安装前审查 Skill 源码 # 查看 SKILL.md 中的 scripts/ 和 tools # 拒绝任何要求下载 zip/execute shell 的 Skill # 3. 使用安全扫描工具 npm install -g secureclaw secureclaw scan ~/.openclaw/skills/ # 4. 检查 Gateway 是否只绑定 localhost # 确保未暴露公网 openclaw gateway status # 5. 定期更新 OpenClaw npm update -g openclaw@latest # 6. 查看安全公告 openclaw security --check*创始人的坦诚：OpenClaw 创始人 Peter Steinberger 曾公开表示：「This is all vibe code. Prompt injection hasn't been solved. There are absolute risks.」如果要在生产环境中使用 OpenClaw，安全防护必须由你自己负责。*
9. 成本控制策略
9.1 为什么成本会失控
OpenClaw 的 Token 消耗远超普通聊天场景：
• 一个简单任务可能触发 5-10 次 API 调用• Skills 描述会注入 system prompt，占用上下文• 记忆系统在每次请求中附带上下文• Agent 24/7 运行，定时任务不断触发• 多轮思考 + 多工具调用的 Token 消耗是传统聊天的 几十甚至上百倍
9.2 Fallback 链：核心省钱策略
从 Claude Sonnet 切换到三级 Fallback 链，可降低 80-95% 的 API 成本：
Claude Sonnet（贵） ↓ 失败/超时报错 Claude Haiku（中等） ↓ 失败/超时报错 DeepSeek（便宜）9.3 设置每日预算上限
强烈建议所有用户设置日预算上限——哪怕你不差钱，$5 的限额也能在 Agent 进入循环推理时保护你的钱包：
{ "agents": { "defaults": { "budget": { "maxTokensPerDay": 500000, "maxCostPerDay": 5.00 } } } }9.4 国内套餐推荐
9.5 各模型月费估算
10. 国内生态与平替产品
10.1 国内生态概况
「云养虾」社区用户超 10 万，国内最省心方案：
阿里云一键部署 + openclaw-china 插件接入钉钉/QQ + DeepSeek 或 GLM-5 主力模型
整套成本可控制在每月 100 元以内
10.2 OpenClaw vs Claude Code：互补关系
通过 openclaw-claude-code-skill 的 MCP 协议桥接两者，在飞书对话框里就能调用 Claude Code 完成代码重构。
10.3 国产平替产品对比
11. 常见问题 FAQ
Q：OpenClaw 是免费的吗？
OpenClaw 软件本身 MIT 开源免费。运行需要两项成本：服务器（本地或云）+ AI 模型 API 费用。如果用本地 Ollama 模型，API 费用也可以免费。软件免费，算力不免费。
Q：需要什么技术水平才能使用？
能用命令行安装 npm 包就够了。最基础的安装只需两行命令：
npm install -g openclaw@latest openclaw onboard --install-daemon阿里云/腾讯云一键部署方案门槛更低。
Q：一个月大概花多少钱？
参考区间：
• 完全免费（本地模型）• $2-5/月（DeepSeek 为主）• $5-15/月（GLM-5 为主）• $10-30/月（Claude Sonnet 为主）
务必设置消费限额，避免多轮工具调用导致费用失控。
Q：安全吗？数据会泄露吗？
OpenClaw 自托管，数据默认存储在你自己的服务器上。需注意三点：
1. 更新到最新版（已修复 CVE-2026-25253 RCE 漏洞）
2. 安装第三方 Skill 前审查源码
3. Gateway 需设置认证，不要裸露在公网
Q：可以用国产模型吗？
完全可以。DeepSeek-V3（$0.14/M）和 GLM-5（$0.80/M）最受国内用户欢迎。效果不如 Claude Sonnet，但日常任务已够用。推荐用 Fallback 机制混合搭配。
Q：OpenClaw 和 Claude Code 可以一起用吗？
可以，且是推荐用法。社区提供 openclaw-claude-code-skill 通过 MCP 协议桥接两者，在飞书对话框里就能调用 Claude Code 完成代码重构。
Q：更新 OpenClaw 后需要重新配置吗？
不一定，但建议更新后运行：
openclaw doctor openclaw backup create # 更新前先备份 npm update -g openclaw@latest openclaw gateway restartQ：如何迁移到新服务器？
# 旧服务器：创建备份 openclaw backup create --only-config # 备份文件通常在 ~/.openclaw/backups/ # 新服务器：安装 OpenClaw 后恢复 npm install -g openclaw@latest openclaw backup restore <备份文件路径> openclaw gateway restart12. 命令速查表
安装与更新
# 安装 OpenClaw npm install -g openclaw@latest # 检查版本 openclaw version # 更新到最新版 npm update -g openclaw@latest # 诊断检查 openclaw doctor # 查看所有可用版本 npm view openclaw versions --json初始化与配置
# 引导式初始化 openclaw onboard # 引导式初始化 + 安装守护进程 openclaw onboard --install-daemon # 导出配置 openclaw config export # 导入配置 openclaw config import <文件路径>Gateway 管理
# 启动 Gateway openclaw gateway start # 停止 Gateway openclaw gateway stop # 重启 Gateway openclaw gateway restart # 查看 Gateway 状态 openclaw gateway status # 带日志启动 openclaw gateway --verbose # 指定端口启动 openclaw gateway --port 18789Skills 管理
# 安装 Skill（交互式） openclaw skills install # 搜索 Skill openclaw skills search "<关键词>" # 列出已安装 Skills openclaw skills list # 查看 Skill 详情 openclaw skills info <skill-name> # 卸载 Skill openclaw skills uninstall <skill-name> # 更新所有 Skills openclaw skills update插件管理
# 安装插件 openclaw plugins install <plugin-name> # 列出已安装插件 openclaw plugins list # 启用插件 openclaw plugins enable <plugin-name> # 禁用插件 openclaw plugins disable <plugin-name> # 卸载插件 openclaw plugins uninstall <plugin-name>备份与恢复
# 创建完整备份 openclaw backup create # 仅备份配置文件 openclaw backup create --only-config # 验证备份完整性 openclaw backup verify # 列出已有备份 openclaw backup list # 从备份恢复 openclaw backup restore <备份名>安全扫描
# 安装安全扫描工具 npm install -g secureclaw # 扫描 Skills 目录 secureclaw scan ~/.openclaw/skills/ # 检查 Gateway 配置 openclaw security --check # 查看 Gateway 绑定地址 openclaw gateway status模型管理
# 添加自定义模型 openclaw models add <provider> # 列出可用模型 openclaw models list # 设置默认模型 openclaw models set-default <model-id> # 登录模型提供商 openclaw models auth login --provider <provider> # 列出已登录的提供商 openclaw models auth list渠道管理
# 配置渠道（交互式） openclaw channel add # 列出已配置渠道 openclaw channel list # 测试渠道连接 openclaw channel test <channel-name> # 移除渠道 openclaw channel remove <channel-name>日志与调试
# 查看实时日志 openclaw logs # 查看最近 N 行日志 openclaw logs --lines 100 # 搜索日志关键词 openclaw logs --grep "error" # 导出日志 openclaw logs --export <文件路径>
