OpenClaw Guide: Build Your AI Assistant

摘要 (TL;DR)

OpenClaw 是一款拥有 13.5 万+ GitHub Star 的开源 AI 助手
在你的机器上 本地运行 —— 你的数据保持私密
通过 WhatsApp, Telegram, Discord, Slack, iMessage 等应用进行连接
拥有 3,000+ 社区技能，用于自动化、编程、智能家居等
免费（你只需支付 AI API Token 费用，通常每月 $10-50）
按照本指南操作，设置仅需 ~30 分钟

什么是 OpenClaw？

OpenClaw（前身为 Clawdbot，后更名为 Moltbot）是 2026 年最热门的开源 AI 项目。它是一个 个人 AI 助手，具备以下特点：

运行在 你自己的电脑或服务器 上
连接到你最喜欢的 即时通讯应用（WhatsApp, Telegram, Discord 等）
拥有 完全访问权限，可以操作你的文件系统、终端和浏览器
可以像“加强版”私人助理一样 自动执行任务

把它想象成你自己的贾维斯 (Jarvis) —— 一个可以搜索文件、运行命令、发送电子邮件、控制智能家居设备，并能完成你在电脑上能做的几乎任何事情的 AI。

发展历程：Clawdbot → Moltbot → OpenClaw

该项目的命名经历了一段曲折的冒险：

日期	名称	原因
2025 年 11 月	Clawdbot	创始人 Peter Steinberger 起的初始名称
2025 年 12 月	Moltbot	在 Anthropic 提出商标请求后更名
2026 年 1 月	OpenClaw	社区为了独立性而进行的品牌重塑

无论你叫它什么，它的功能始终如一 —— 一个运行在本地的、极其强大的 AI 助手。

为什么选择 OpenClaw？

对比 ChatGPT / Claude 网页版

功能	ChatGPT/Claude	OpenClaw
本地运行	❌	✅
访问你的文件	❌	✅
运行终端命令	❌	✅
控制你的电脑	❌	✅
在 WhatsApp 中使用	❌	✅
数据隐私	基于云端	100% 本地
技能扩展	有限	3,000+ 技能

对比其他 AI Agent

OpenClaw 的杀手级特性：

多渠道收件箱：一个 AI，可通过 WhatsApp, Telegram, Discord, Slack, iMessage 等 12 多个平台访问
持久记忆：能够记住跨对话的上下文
技能生态系统：通过 ClawHub 提供 3,000+ 社区插件
模型无关：支持 Claude, GPT, Gemini, DeepSeek, 本地 Ollama 模型等
开源：MIT 许可证，代码完全可审计

前提条件

在开始之前，请确保你拥有：

[ ] 一台电脑（Mac，安装了 WSL2 的 Windows，或 Linux）
[ ] 已安装 Node.js v22+ (点击此处下载)
[ ] 一个 AI API 密钥（Anthropic Claude, OpenAI 或其他）
[ ] 大约 30 分钟的时间

硬件要求

配置	RAM	存储	备注
最低配置	4GB	1GB	基础功能
推荐配置	8GB+	2GB+	流畅体验
运行本地模型	16GB+	50GB+	用于运行 Ollama

安装方法

方法 1：一行命令安装（推荐）

最快的入门方式：

bash

curl -fsSL https://openclaw.bot/install.sh | bash

该脚本将执行：

检查你的系统要求

安装 OpenClaw

启动新手配置向导

方法 2：Docker（推荐服务器使用）

如果你更喜欢容器化部署：

bash

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 运行 Docker 设置
./docker-setup.sh

Docker 设置会创建两个重要的目录：

~/.openclaw/ —— 配置文件、记忆、API 密钥

~/openclaw/workspace/ —— AI Agent 可访问的文件

方法 3：从源码构建

适合想要完全控制的开发者：

bash

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖
pnpm install

# 构建 UI
pnpm ui:build

# 构建项目
pnpm build

# 运行配置向导
pnpm openclaw onboard --install-daemon

分步设置

第 1 步：运行配置向导

安装后，配置向导会自动启动。如果没有启动，请运行：

bash

openclaw onboard --install-daemon

向导将引导你完成：

选择模型供应商 (Model Provider Selection)
配置 API 密钥 (API Key Configuration)
设置通讯平台 (Messaging Platform Setup)
安全设置 (Security Settings)

第 2 步：配置你的 AI 模型

OpenClaw 支持多个 AI 供应商。请选择其中一个：

选项 A：Anthropic Claude（推荐）

bash

# 设置你的 API 密钥
export ANTHROPIC_API_KEY=sk-ant-xxxxx

# 或者使用 config 命令
openclaw config set 'models.default' 'claude-sonnet-4'

选项 B：OpenAI

bash

export OPENAI_API_KEY=sk-xxxxx
openclaw config set 'models.default' 'gpt-4o'

选项 C：DeepSeek（高性价比）

bash

openclaw config set 'models.providers.deepseek' --json '{
  "baseUrl": "https://api.deepseek.com/v1",
  "apiKey": "your-api-key",
  "api": "openai-completions",
  "models": [
    { "id": "deepseek-chat", "name": "DeepSeek Chat" },
    { "id": "deepseek-reasoner", "name": "DeepSeek Reasoner" }
  ]
}'

选项 D：使用 Ollama 运行本地模型

为了实现完全的隐私，可以在本地运行模型：

bash

# 首先安装 Ollama: https://ollama.ai
ollama pull llama3.3

# 配置 OpenClaw 使用它
openclaw config set 'models.providers.ollama' --json '{
  "baseUrl": "http://localhost:11434/v1",
  "api": "openai-completions",
  "models": [
    { "id": "llama3.3", "name": "Llama 3.3" }
  ]
}'

第 3 步：连接通讯平台

这是 OpenClaw 的亮点所在 —— 随时随地与你的 AI 聊天。

Telegram（最简单）

在 Telegram 上给 @BotFather 发消息
发送 /newbot 并按照提示操作
复制你的 Bot Token
配置 OpenClaw：

bash

openclaw config set 'channels.telegram.token' 'YOUR_BOT_TOKEN'
openclaw config set 'channels.telegram.allowlist' '["your_telegram_username"]'

OpenClaw 使用 WhatsApp Web 进行连接：

bash

# 启用 WhatsApp 渠道
openclaw config set 'channels.whatsapp.enabled' true

# 重启网关
openclaw gateway restart

# 扫描出现的二维码

终端中会出现一个二维码。用手机上的 WhatsApp 扫描它（设置 → 已链接设备 → 链接设备）。

Discord

在 discord.com/developers 创建一个 Discord 应用
创建一个 Bot 并复制 Token
配置：

bash

openclaw config set 'channels.discord.token' 'YOUR_BOT_TOKEN'
openclaw config set 'channels.discord.allowlist' '["your_discord_user_id"]'

iMessage（仅限 Mac）

对于 Mac 用户，OpenClaw 可以直接连接到 iMessage：

bash

openclaw config set 'channels.imessage.enabled' true

第 4 步：启动网关 (Gateway)

网关是让 OpenClaw 持续运行的后台服务：

bash

# 作为守护进程（后台服务）启动
openclaw gateway start

# 或者在前台运行以进行调试
openclaw gateway

# 检查状态
openclaw gateway status

# 查看日志
openclaw logs --follow

第 5 步：访问 Web 仪表盘

OpenClaw 包含一个用于配置和直接聊天的 Web 界面：

bash

# 在浏览器中打开仪表盘
openclaw dashboard

这将打开 http://127.0.0.1:18789/ 并带有一个临时登录 Token。

通过仪表盘，你可以：

直接与 AI 聊天

管理设置

查看对话历史

安装技能

你的第一次对话

一切设置就绪后，给你的 Bot 发送一条消息（通过 Telegram, WhatsApp 或 Web UI）：

你好！能告诉我你能做什么吗？

OpenClaw 将介绍它自己及其功能。尝试一些实际任务：

我的下载文件夹里有哪些文件？

在我的文档中搜索任何关于“2025 年税收”的内容

创建一个将 CSV 转换为 JSON 的 Python 脚本

我电脑上什么东西占用的磁盘空间最多？

安装技能

技能可以扩展 OpenClaw 的能力。浏览 ClawHub 注册表或直接安装：

技能分类

分类	热门技能	使用场景
开发者	github, gitlab, jira, linear	PR 评审、问题管理
效率	calendar, email, notion, todoist	日程安排、任务管理
自动化	agent-browser, puppeteer, selenium	网页抓取、表单填写
智能家居	homeassistant, philips-hue, tuya	灯光控制、场景联动
金融	crypto-prices, stock-tracker	投资组合监控
媒体	spotify, youtube-dl, plex	音乐控制、下载

安全提示

⚠️ 重要提示：在安装技能前请先检查。ClawHub 的开放性意味着可能存在恶意技能。使用 openclaw skill inspect 查看代码，或让 Claude Code / Codex 为你审计。

高级配置

配置文件结构

OpenClaw 将配置存储在 ~/.openclaw/：

~/.openclaw/
├── openclaw.json    # 主配置
├── env              # 环境变量（API 密钥）
├── memory/          # 持久记忆存储
├── skills/          # 已安装技能
├── backups/         # 配置备份
└── logs/            # 日志文件

编辑配置

bash

# 查看当前配置
openclaw config get

# 设置一个值
openclaw config set 'key.path' 'value'

# 在默认编辑器中编辑
openclaw config edit

记忆管理

OpenClaw 跨对话维护持久记忆：

bash

# 查看记忆统计
openclaw memory stats

# 清除所有记忆（慎用！）
openclaw memory clear

# 导出记忆用于备份
openclaw memory export > memory-backup.json

运行健康检查

bash

# 全面的健康检查
openclaw doctor

# 检查特定组件
openclaw doctor --check api
openclaw doctor --check channels
openclaw doctor --check skills

安全最佳实践

OpenClaw 拥有 完整的系统访问权限 —— 这既是它的强大之处，也是风险所在。请遵循以下准则：

1. 使用专用机器

不要在你的主要工作电脑上运行 OpenClaw。可选方案：

VPS: DigitalOcean, Vultr, AWS (每月 $5-20)
旧笔记本电脑: 重新利用旧硬件
树莓派 (Raspberry Pi): 适用于轻量级使用
Docker: 提供一定的隔离性

2. 启用沙盒模式

对于非信任会话（群聊、频道）：

bash

openclaw config set 'agents.defaults.sandbox.mode' 'non-main'

这会在 Docker 沙盒中运行群组/频道会话。

3. 使用白名单

仅允许特定用户与你的 Bot 交互：

bash

# Telegram
openclaw config set 'channels.telegram.allowlist' '["username1", "username2"]'

# Discord
openclaw config set 'channels.discord.allowlist' '["user_id_1", "user_id_2"]'

4. 保持更新

旧版本中曾发现安全漏洞。请始终运行最新版本：

bash

# 检查更新
openclaw update --check

# 更新到最新版本
openclaw update

注意：2026.1.29 之前的版本存在已知的安全漏洞。如果你使用的是旧版本，请立即更新。

5. 安装前审计技能

bash

# 检查技能的代码
openclaw skill inspect <skill-name>

# 查看技能信誉
openclaw skill info <skill-name>

自动化示例

这里是 OpenClaw 真正发挥威力的地方：

晨间简报

设置每天早上 8 点的摘要：

bash

# 在配置中添加一个 cron 任务
openclaw config set 'automations.morning-briefing' --json '{
  "cron": "0 8 * * *",
  "action": "发给我一份摘要，包括：天气预报、今天的日历事件、未读的重要邮件以及前 3 条新闻头条"
}'

GitHub PR 评审机器人

在被指派时自动评审 PR：

bash

openclaw skill install github

# 配置 Webhook 或轮询
openclaw config set 'automations.pr-review' --json '{
  "trigger": "github.pr.assigned",
  "action": "评审该 PR，检查是否存在 Bug、安全问题和样式违规。发布一条总结评论。"
}'

智能家居场景

bash

openclaw skill install homeassistant

# “离家”自动化
openclaw config set 'automations.leaving-home' --json '{
  "trigger": "location.leave_home",
  "action": "关闭所有灯，将温控器设置为节能模式，启动安防系统"
}'

文件整理

让 OpenClaw 整理你的下载文件夹：

整理我的下载文件夹：将图片移动到 ~/Pictures，文档移动到 ~/Documents，并删除任何超过 30 天的文件

故障排除

常见问题

"Command not found: openclaw"

bash

# 添加到 PATH
export PATH="$HOME/.openclaw/bin:$PATH"
# 添加到你的 shell 配置文件 (.bashrc, .zshrc)

"API key invalid"

bash

# 检查你的环境变量
openclaw config get models

# 重新运行配置向导
openclaw onboard

"WhatsApp QR code not appearing"

bash

# 检查日志
openclaw logs --channel whatsapp

# 重启网关
openclaw gateway restart

"Skills not loading"

bash

# 重建技能索引
openclaw skill rebuild

# 检查冲突
openclaw doctor --check skills

获取帮助

官方文档: docs.openclaw.ai
GitHub Issues: github.com/openclaw/openclaw/issues
Discord 社区: discord.gg/openclaw
Reddit: r/OpenClaw

费用明细

OpenClaw 本身是免费的。你的成本主要来自 AI API 的使用：

使用程度	每月 Token	估算成本
轻度使用	~100 万 Token	$3-10
中度使用	~500 万 Token	$15-40
重度使用	~2000 万 Token	$60-150
极客用户	5000 万+ Token	$150+

省钱技巧

使用 DeepSeek 处理常规任务（每百万 Token $0.14，而 Claude 为 $3）
本地模型 处理简单查询（硬件投入后免费）
设置单次对话 Token 限制
对重复查询 使用缓存

下一步计划？

现在你已经运行了 OpenClaw，这里有一些进阶想法：

构建你自己的技能

根据你的特定需求创建自定义技能：

bash

# 创建一个新技能
openclaw skill create my-custom-skill

# 编辑技能
code ~/.openclaw/skills/my-custom-skill/SKILL.md

连接更多平台

添加多个 WhatsApp 账号（个人 + 工作）
连接 Slack 用于工作，Discord 用于个人
为 Apple 生态系统设置 iMessage

探索生态系统

在 ClawHub 浏览 3,000+ 技能
加入 Discord 社区获取提示和技巧
关注 @OpenClaw 获取更新

进阶方案：部署你自己的 AI 产品

一旦你体验了 AI 助手的强大功能，你可能会想为他人构建产品。这就是 Y Build 的用武之地。

Y Build 帮助你将 AI 驱动的想法转变为上线的项目：

AI 编程：描述你想要的功能，AI 生成代码
一键部署：通过全球 CDN 立即上线
增长工具：演示视频、SEO 优化、数据分析

无论你想构建：

一个由 AI 驱动的 SaaS 工具
一个像 OpenClaw 这样的自动化平台
一个为你业务定制的聊天机器人

Y Build 处理部署和增长，让你专注于产品开发。 免费试用 Y Build →

结论

OpenClaw 代表了个人 AI 的新范式 —— 一个具备以下特征的助手：

本地化：你的数据永远不会离开你的机器
强大：完全的系统访问权限意味着真正的自动化
可扩展：3,000+ 技能且在不断增长
多平台：一个 AI，处处可用

在 30 分钟内，你已经设置好了自己的 AI 助手，它可以：

通过 WhatsApp 回答问题
搜索并整理你的文件
自动执行重复性任务
控制你的智能家居
以及更多

AI 的未来不仅仅是云端的聊天机器人 —— 它是运行在你自己的基础设施上、受你控制的个人 AI Agent。

欢迎加入 OpenClaw 社区。 🦞

参考资料：

摘要 (TL;DR)

OpenClaw 是一款拥有 13.5 万+ GitHub Star 的开源 AI 助手
在你的机器上 本地运行 —— 你的数据保持私密
通过 WhatsApp, Telegram, Discord, Slack, iMessage 等应用进行连接
拥有 3,000+ 社区技能，用于自动化、编程、智能家居等
免费（你只需支付 AI API Token 费用，通常每月 $10-50）
按照本指南操作，设置仅需 ~30 分钟

什么是 OpenClaw？

OpenClaw（前身为 Clawdbot，后更名为 Moltbot）是 2026 年最热门的开源 AI 项目。它是一个 个人 AI 助手，具备以下特点：

运行在 你自己的电脑或服务器 上
连接到你最喜欢的 即时通讯应用（WhatsApp, Telegram, Discord 等）
拥有 完全访问权限，可以操作你的文件系统、终端和浏览器
可以像“加强版”私人助理一样 自动执行任务

发展历程：Clawdbot → Moltbot → OpenClaw

该项目的命名经历了一段曲折的冒险：

日期	名称	原因
2025 年 11 月	Clawdbot	创始人 Peter Steinberger 起的初始名称
2025 年 12 月	Moltbot	在 Anthropic 提出商标请求后更名
2026 年 1 月	OpenClaw	社区为了独立性而进行的品牌重塑

无论你叫它什么，它的功能始终如一 —— 一个运行在本地的、极其强大的 AI 助手。

为什么选择 OpenClaw？

对比 ChatGPT / Claude 网页版

功能	ChatGPT/Claude	OpenClaw
本地运行	❌	✅
访问你的文件	❌	✅
运行终端命令	❌	✅
控制你的电脑	❌	✅
在 WhatsApp 中使用	❌	✅
数据隐私	基于云端	100% 本地
技能扩展	有限	3,000+ 技能

对比其他 AI Agent

OpenClaw 的杀手级特性：

多渠道收件箱：一个 AI，可通过 WhatsApp, Telegram, Discord, Slack, iMessage 等 12 多个平台访问
持久记忆：能够记住跨对话的上下文
技能生态系统：通过 ClawHub 提供 3,000+ 社区插件
模型无关：支持 Claude, GPT, Gemini, DeepSeek, 本地 Ollama 模型等
开源：MIT 许可证，代码完全可审计

前提条件

在开始之前，请确保你拥有：

[ ] 一台电脑（Mac，安装了 WSL2 的 Windows，或 Linux）
[ ] 已安装 Node.js v22+ (点击此处下载)
[ ] 一个 AI API 密钥（Anthropic Claude, OpenAI 或其他）
[ ] 大约 30 分钟的时间

硬件要求

配置	RAM	存储	备注
最低配置	4GB	1GB	基础功能
推荐配置	8GB+	2GB+	流畅体验
运行本地模型	16GB+	50GB+	用于运行 Ollama

安装方法

方法 1：一行命令安装（推荐）

最快的入门方式：

bash

curl -fsSL https://openclaw.bot/install.sh | bash

该脚本将执行：

检查你的系统要求

安装 OpenClaw

启动新手配置向导

方法 2：Docker（推荐服务器使用）

如果你更喜欢容器化部署：

bash

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 运行 Docker 设置
./docker-setup.sh

Docker 设置会创建两个重要的目录：

~/.openclaw/ —— 配置文件、记忆、API 密钥

~/openclaw/workspace/ —— AI Agent 可访问的文件

方法 3：从源码构建

适合想要完全控制的开发者：

bash

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖
pnpm install

# 构建 UI
pnpm ui:build

# 构建项目
pnpm build

# 运行配置向导
pnpm openclaw onboard --install-daemon

分步设置

第 1 步：运行配置向导

安装后，配置向导会自动启动。如果没有启动，请运行：

bash

openclaw onboard --install-daemon

向导将引导你完成：

选择模型供应商 (Model Provider Selection)
配置 API 密钥 (API Key Configuration)
设置通讯平台 (Messaging Platform Setup)
安全设置 (Security Settings)

第 2 步：配置你的 AI 模型

OpenClaw 支持多个 AI 供应商。请选择其中一个：

选项 A：Anthropic Claude（推荐）

bash

# 设置你的 API 密钥
export ANTHROPIC_API_KEY=sk-ant-xxxxx

# 或者使用 config 命令
openclaw config set 'models.default' 'claude-sonnet-4'

选项 B：OpenAI

bash

export OPENAI_API_KEY=sk-xxxxx
openclaw config set 'models.default' 'gpt-4o'

选项 C：DeepSeek（高性价比）

bash

openclaw config set 'models.providers.deepseek' --json '{
  "baseUrl": "https://api.deepseek.com/v1",
  "apiKey": "your-api-key",
  "api": "openai-completions",
  "models": [
    { "id": "deepseek-chat", "name": "DeepSeek Chat" },
    { "id": "deepseek-reasoner", "name": "DeepSeek Reasoner" }
  ]
}'

选项 D：使用 Ollama 运行本地模型

为了实现完全的隐私，可以在本地运行模型：

bash

# 首先安装 Ollama: https://ollama.ai
ollama pull llama3.3

# 配置 OpenClaw 使用它
openclaw config set 'models.providers.ollama' --json '{
  "baseUrl": "http://localhost:11434/v1",
  "api": "openai-completions",
  "models": [
    { "id": "llama3.3", "name": "Llama 3.3" }
  ]
}'

第 3 步：连接通讯平台

这是 OpenClaw 的亮点所在 —— 随时随地与你的 AI 聊天。

Telegram（最简单）

在 Telegram 上给 @BotFather 发消息
发送 /newbot 并按照提示操作
复制你的 Bot Token
配置 OpenClaw：

bash

openclaw config set 'channels.telegram.token' 'YOUR_BOT_TOKEN'
openclaw config set 'channels.telegram.allowlist' '["your_telegram_username"]'

OpenClaw 使用 WhatsApp Web 进行连接：

bash

# 启用 WhatsApp 渠道
openclaw config set 'channels.whatsapp.enabled' true

# 重启网关
openclaw gateway restart

# 扫描出现的二维码

终端中会出现一个二维码。用手机上的 WhatsApp 扫描它（设置 → 已链接设备 → 链接设备）。

Discord

在 discord.com/developers 创建一个 Discord 应用
创建一个 Bot 并复制 Token
配置：

bash

openclaw config set 'channels.discord.token' 'YOUR_BOT_TOKEN'
openclaw config set 'channels.discord.allowlist' '["your_discord_user_id"]'

iMessage（仅限 Mac）

对于 Mac 用户，OpenClaw 可以直接连接到 iMessage：

bash

openclaw config set 'channels.imessage.enabled' true

第 4 步：启动网关 (Gateway)

网关是让 OpenClaw 持续运行的后台服务：

bash

# 作为守护进程（后台服务）启动
openclaw gateway start

# 或者在前台运行以进行调试
openclaw gateway

# 检查状态
openclaw gateway status

# 查看日志
openclaw logs --follow

第 5 步：访问 Web 仪表盘

OpenClaw 包含一个用于配置和直接聊天的 Web 界面：

bash

# 在浏览器中打开仪表盘
openclaw dashboard

这将打开 http://127.0.0.1:18789/ 并带有一个临时登录 Token。

通过仪表盘，你可以：

直接与 AI 聊天

管理设置

查看对话历史

安装技能

你的第一次对话

一切设置就绪后，给你的 Bot 发送一条消息（通过 Telegram, WhatsApp 或 Web UI）：

你好！能告诉我你能做什么吗？

OpenClaw 将介绍它自己及其功能。尝试一些实际任务：

我的下载文件夹里有哪些文件？

在我的文档中搜索任何关于“2025 年税收”的内容

创建一个将 CSV 转换为 JSON 的 Python 脚本

我电脑上什么东西占用的磁盘空间最多？

安装技能

技能可以扩展 OpenClaw 的能力。浏览 ClawHub 注册表或直接安装：

技能分类

分类	热门技能	使用场景
开发者	github, gitlab, jira, linear	PR 评审、问题管理
效率	calendar, email, notion, todoist	日程安排、任务管理
自动化	agent-browser, puppeteer, selenium	网页抓取、表单填写
智能家居	homeassistant, philips-hue, tuya	灯光控制、场景联动
金融	crypto-prices, stock-tracker	投资组合监控
媒体	spotify, youtube-dl, plex	音乐控制、下载

安全提示

⚠️ 重要提示：在安装技能前请先检查。ClawHub 的开放性意味着可能存在恶意技能。使用 openclaw skill inspect 查看代码，或让 Claude Code / Codex 为你审计。

高级配置

配置文件结构

OpenClaw 将配置存储在 ~/.openclaw/：

~/.openclaw/
├── openclaw.json    # 主配置
├── env              # 环境变量（API 密钥）
├── memory/          # 持久记忆存储
├── skills/          # 已安装技能
├── backups/         # 配置备份
└── logs/            # 日志文件

编辑配置

bash

# 查看当前配置
openclaw config get

# 设置一个值
openclaw config set 'key.path' 'value'

# 在默认编辑器中编辑
openclaw config edit

记忆管理

OpenClaw 跨对话维护持久记忆：

bash

# 查看记忆统计
openclaw memory stats

# 清除所有记忆（慎用！）
openclaw memory clear

# 导出记忆用于备份
openclaw memory export > memory-backup.json

运行健康检查

bash

# 全面的健康检查
openclaw doctor

# 检查特定组件
openclaw doctor --check api
openclaw doctor --check channels
openclaw doctor --check skills

安全最佳实践

OpenClaw 拥有 完整的系统访问权限 —— 这既是它的强大之处，也是风险所在。请遵循以下准则：

1. 使用专用机器

不要在你的主要工作电脑上运行 OpenClaw。可选方案：

VPS: DigitalOcean, Vultr, AWS (每月 $5-20)
旧笔记本电脑: 重新利用旧硬件
树莓派 (Raspberry Pi): 适用于轻量级使用
Docker: 提供一定的隔离性

2. 启用沙盒模式

对于非信任会话（群聊、频道）：

bash

openclaw config set 'agents.defaults.sandbox.mode' 'non-main'

这会在 Docker 沙盒中运行群组/频道会话。

3. 使用白名单

仅允许特定用户与你的 Bot 交互：

bash

# Telegram
openclaw config set 'channels.telegram.allowlist' '["username1", "username2"]'

# Discord
openclaw config set 'channels.discord.allowlist' '["user_id_1", "user_id_2"]'

4. 保持更新

旧版本中曾发现安全漏洞。请始终运行最新版本：

bash

# 检查更新
openclaw update --check

# 更新到最新版本
openclaw update

注意：2026.1.29 之前的版本存在已知的安全漏洞。如果你使用的是旧版本，请立即更新。

5. 安装前审计技能

bash

# 检查技能的代码
openclaw skill inspect <skill-name>

# 查看技能信誉
openclaw skill info <skill-name>

自动化示例

这里是 OpenClaw 真正发挥威力的地方：

晨间简报

设置每天早上 8 点的摘要：

bash

# 在配置中添加一个 cron 任务
openclaw config set 'automations.morning-briefing' --json '{
  "cron": "0 8 * * *",
  "action": "发给我一份摘要，包括：天气预报、今天的日历事件、未读的重要邮件以及前 3 条新闻头条"
}'

GitHub PR 评审机器人

在被指派时自动评审 PR：

bash

openclaw skill install github

# 配置 Webhook 或轮询
openclaw config set 'automations.pr-review' --json '{
  "trigger": "github.pr.assigned",
  "action": "评审该 PR，检查是否存在 Bug、安全问题和样式违规。发布一条总结评论。"
}'

智能家居场景

bash

openclaw skill install homeassistant

# “离家”自动化
openclaw config set 'automations.leaving-home' --json '{
  "trigger": "location.leave_home",
  "action": "关闭所有灯，将温控器设置为节能模式，启动安防系统"
}'

文件整理

让 OpenClaw 整理你的下载文件夹：

整理我的下载文件夹：将图片移动到 ~/Pictures，文档移动到 ~/Documents，并删除任何超过 30 天的文件

故障排除

常见问题

"Command not found: openclaw"

bash

# 添加到 PATH
export PATH="$HOME/.openclaw/bin:$PATH"
# 添加到你的 shell 配置文件 (.bashrc, .zshrc)

"API key invalid"

bash

# 检查你的环境变量
openclaw config get models

# 重新运行配置向导
openclaw onboard

"WhatsApp QR code not appearing"

bash

# 检查日志
openclaw logs --channel whatsapp

# 重启网关
openclaw gateway restart

"Skills not loading"

bash

# 重建技能索引
openclaw skill rebuild

# 检查冲突
openclaw doctor --check skills

获取帮助

官方文档: docs.openclaw.ai
GitHub Issues: github.com/openclaw/openclaw/issues
Discord 社区: discord.gg/openclaw
Reddit: r/OpenClaw

费用明细

OpenClaw 本身是免费的。你的成本主要来自 AI API 的使用：

使用程度	每月 Token	估算成本
轻度使用	~100 万 Token	$3-10
中度使用	~500 万 Token	$15-40
重度使用	~2000 万 Token	$60-150
极客用户	5000 万+ Token	$150+

省钱技巧

使用 DeepSeek 处理常规任务（每百万 Token $0.14，而 Claude 为 $3）
本地模型 处理简单查询（硬件投入后免费）
设置单次对话 Token 限制
对重复查询 使用缓存

下一步计划？

现在你已经运行了 OpenClaw，这里有一些进阶想法：

构建你自己的技能

根据你的特定需求创建自定义技能：

bash

# 创建一个新技能
openclaw skill create my-custom-skill

# 编辑技能
code ~/.openclaw/skills/my-custom-skill/SKILL.md

连接更多平台

添加多个 WhatsApp 账号（个人 + 工作）
连接 Slack 用于工作，Discord 用于个人
为 Apple 生态系统设置 iMessage

探索生态系统

在 ClawHub 浏览 3,000+ 技能
加入 Discord 社区获取提示和技巧
关注 @OpenClaw 获取更新

进阶方案：部署你自己的 AI 产品

一旦你体验了 AI 助手的强大功能，你可能会想为他人构建产品。这就是 Y Build 的用武之地。

Y Build 帮助你将 AI 驱动的想法转变为上线的项目：

AI 编程：描述你想要的功能，AI 生成代码
一键部署：通过全球 CDN 立即上线
增长工具：演示视频、SEO 优化、数据分析

无论你想构建：

一个由 AI 驱动的 SaaS 工具
一个像 OpenClaw 这样的自动化平台
一个为你业务定制的聊天机器人

Y Build 处理部署和增长，让你专注于产品开发。 免费试用 Y Build →

结论

OpenClaw 代表了个人 AI 的新范式 —— 一个具备以下特征的助手：

本地化：你的数据永远不会离开你的机器
强大：完全的系统访问权限意味着真正的自动化
可扩展：3,000+ 技能且在不断增长
多平台：一个 AI，处处可用

在 30 分钟内，你已经设置好了自己的 AI 助手，它可以：

通过 WhatsApp 回答问题
搜索并整理你的文件
自动执行重复性任务
控制你的智能家居
以及更多

AI 的未来不仅仅是云端的聊天机器人 —— 它是运行在你自己的基础设施上、受你控制的个人 AI Agent。

欢迎加入 OpenClaw 社区。 🦞

参考资料：

摘要 (TL;DR)

什么是 OpenClaw？

发展历程：Clawdbot → Moltbot → OpenClaw

为什么选择 OpenClaw？

对比 ChatGPT / Claude 网页版

对比其他 AI Agent

前提条件

硬件要求

安装方法

方法 1：一行命令安装（推荐）

方法 2：Docker（推荐服务器使用）

方法 3：从源码构建

分步设置

第 1 步：运行配置向导

第 2 步：配置你的 AI 模型

选项 A：Anthropic Claude（推荐）

选项 B：OpenAI

选项 C：DeepSeek（高性价比）

选项 D：使用 Ollama 运行本地模型

第 3 步：连接通讯平台

Telegram（最简单）

WhatsApp

Discord

iMessage（仅限 Mac）

第 4 步：启动网关 (Gateway)

第 5 步：访问 Web 仪表盘

你的第一次对话

安装技能

热门技能

技能分类

安全提示

高级配置

配置文件结构

编辑配置

记忆管理

运行健康检查

安全最佳实践

1. 使用专用机器

2. 启用沙盒模式

3. 使用白名单

4. 保持更新

5. 安装前审计技能

自动化示例

晨间简报

GitHub PR 评审机器人

智能家居场景

文件整理

故障排除

常见问题

获取帮助

费用明细

省钱技巧

下一步计划？

构建你自己的技能

连接更多平台

探索生态系统

进阶方案：部署你自己的 AI 产品

结论

摘要 (TL;DR)

什么是 OpenClaw？

发展历程：Clawdbot → Moltbot → OpenClaw

为什么选择 OpenClaw？

对比 ChatGPT / Claude 网页版

对比其他 AI Agent

前提条件

硬件要求

安装方法

方法 1：一行命令安装（推荐）

方法 2：Docker（推荐服务器使用）

方法 3：从源码构建

分步设置

第 1 步：运行配置向导

第 2 步：配置你的 AI 模型

选项 A：Anthropic Claude（推荐）

选项 B：OpenAI

选项 C：DeepSeek（高性价比）

选项 D：使用 Ollama 运行本地模型

第 3 步：连接通讯平台

Telegram（最简单）

WhatsApp