OpenClaw部署保姆级教程：手把手搭建你的大龙虾(ClawdBot)

什么是 OpenClaw

说到 2026 年最火的开源 AI Agent 项目，OpenClaw（之前叫 ClawdBot 或 Moltbot）绝对算一个。GitHub 上已经拿到超过 68,000 颗星，这可不是随便哪个项目都能做到的。它跟我们平时聊天的机器人完全不是一回事——这是一个真正能上手干活的个人 AI 助理。

它的核心特点，说白了就是这几点：

本地执行——所有数据都留在你自己的设备上，不用上传到任何云端。隐私和安全这块，你自己说了算。

真实执行——不只是跟你聊天，它能直接操作你的电脑。自动处理邮件、日历、文件管理这些琐事，是真真正正地动手去做。

多平台消息——WhatsApp、Telegram、Discord、Slack……主流的消息平台它基本都支持，少说也有十几个。你只需要从一个地方就能管住所有通讯，不用切来切去。

持久记忆——跨会话保持上下文，记住你的偏好。用得越久，它越懂你，效率自然也跟着上去。

开源免费——完全开源，你只需要自己准备一个 API Key。零成本，完全自主控制。

OpenClaw vs 传统 AI 助手

传统的 AI 助手，比如 ChatGPT，你让它“帮我整理桌面文件”，它会给你列一堆步骤建议：“建议创建文件夹……按类型分类……”

而 OpenClaw 呢？你同样说“帮我整理桌面文件”，它直接动手：重命名、分类、移动文件。完了告诉你：“搞定了！47 个文件按类型整理到了 5 个文件夹里。”

这就是“聊天机器人”和“AI Agent”最根本的区别——一个只会说，一个真的会做。

新手阶段：基础入门

第一步：环境准备

先看看你的电脑准备好没有。

系统要求

• 操作系统： macOS、Linux 或者 Windows（需要 WSL）
• Node.js： v18 或更高版本
• AI 模型 API Key： Claude 或 GPT 的 API 密钥

实践任务 1：检查环境

# 检查 Node.js 版本
node --version
# 如果版本低于 v18，需要升级
# macOS/Linux 使用 nvm
nvm install 18
nvm use 18
# Windows 访问 nodejs.org 下载安装

完成标准： 终端显示 Node.js 版本 >= v18.0.0

第二步：安装 OpenClaw

三种安装方式，挑一种你顺手的。

方法一：NPM 安装（推荐新手）

# 全局安装 OpenClaw
npm install -g openclaw
# 验证安装
openclaw --version

方法二：Docker 安装（推荐有 Docker 经验者）

# 拉取镜像
docker pull openclaw/openclaw:latest
# 运行容器
docker run -d --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

方法三：源码安装（开发者）

# 克隆项目
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 安装依赖
npm install
# 启动
npm run start

实践任务 2：完成安装

选一种方式完成安装。

完成标准： 运行 openclaw --version 或 openclaw --help 能正常显示信息

第三步：初始化配置

运行初始化向导

# 启动初始化向导
openclaw onboard

跟着向导一步步来就行：

1. 选择 AI 模型提供商（Anthropic Claude / OpenAI GPT / 本地模型）
2. 输入 API Key
3. 选择消息平台（Telegram / Discord / WhatsApp 等）
4. 配置系统权限（建议先选沙盒模式）

配置 API Key

如果还没有 API Key，两个主流渠道：

• Anthropic Claude： anthropic.com（推荐，$20/月 Pro 订阅）
• OpenAI GPT： platform.openai.com
• API 聚合服务： apiyi.com（支持多模型，新用户有免费额度）

实践任务 3：完成初始化

运行 openclaw onboard 并完成所有配置步骤。

完成标准：

• 成功配置 API Key
• 选择至少一个消息平台
• 完成权限设置（建议先选沙盒模式）

第四步：第一次对话

启动 OpenClaw

# 启动 OpenClaw
openclaw
# 或者启动 Dashboard（Web 界面）
openclaw dashboard

连接消息平台 Telegram 示例：

1. 在 Telegram 中搜索 @BotFather
2. 发送 /newbot 创建新机器人
3. 获取 Bot Token
4. 配置到 OpenClaw:

openclaw config set channels.telegram.botToken "YOUR_BOT_TOKEN"
openclaw config set channels.telegram.enabled true

1. 在 Telegram 中搜索你的机器人并开始对话

实践任务 4：第一次对话

跟你的 OpenClaw 助手聊几句，试试这些命令：

你好，介绍一下你自己
你能帮我做什么？
现在几点了？

完成标准： 机器人能正常回复你的消息

第五步：理解核心概念

Gateway（网关）

Gateway 是 OpenClaw 跟外部世界打交道的方式：

• 消息网关： Telegram、Discord、WhatsApp
• API 网关： HTTP API 接口
• CLI 网关： 命令行交互

Skills（技能）

Skills 就是 OpenClaw 的能力扩展包，相当于“插件”或“应用”。

• 每个 Skill 负责一组特定任务
• 可以从 Clawhub 安装第三方 Skills
• 也可以自己写自定义 Skills

Memory（记忆）

OpenClaw 能记住：

• 你的偏好和习惯
• 之前的对话上下文
• 重要的信息和任务

Sandbox（沙盒）

沙盒模式用来限制 OpenClaw 的系统访问权限，保护电脑安全：

• Sandbox Mode： 限制文件系统、网络、Shell 访问
• Full Access Mode： 完全权限（这个得小心用）

实践任务 5：探索工作空间

# 查看 OpenClaw 的工作目录
ls ~/.openclaw
# 查看配置文件
openclaw config list
# 查看已安装的 Skills
openclaw skills list
# 运行安全审计
openclaw security audit

完成标准： 理解 OpenClaw 的文件结构和基本配置

进阶阶段：实用技能

第六步：安装和使用 Skills

浏览 Skills 市场

去 Clawhub 逛逛，或者直接用命令搜：

# 搜索 Skills
openclaw skills search email
# 查看 Skill 详情
openclaw skills info @author/skill-name

安装常用 Skills

# 安装邮件管理 Skill
openclaw skills install @openclaw/email-manager
# 安装日历管理 Skill
openclaw skills install @openclaw/calendar
# 安装文件整理 Skill
openclaw skills install @openclaw/file-organizer
# 安装网页搜索 Skill（用 Ta vily 替代 Bra ve）
openclaw skills install @openclaw/ta vily-search

实践任务 6：安装并测试 Skills

1. 安装至少 3 个 Skills
2. 测试每个 Skill 的功能
3. 记下哪些 Skills 对你最有用

完成标准： 成功安装并使用至少 3 个 Skills

第七步：Google Workspace 集成

OpenClaw 能帮你管 Gmail、Google Calendar、Google Docs 这些。

配置步骤

1. 创建 Google Cloud 项目 去 console.cloud.google.com 建一个新项目，启用 Gmail API、Google Calendar API、Google Drive API。

2. 创建服务账号 在 IAM & Admin → Service Accounts 里创建服务账号，下载 JSON 密钥文件。

3. 配置 OpenClaw

openclaw config set integrations.google.enabled true
openclaw config set integrations.google.credentialsPath "/path/to/credentials.json"

4. 授权访问

openclaw integrations google authorize

实践任务 7：Google 集成实践

试试这些任务：

1. 日历管理： 让它给你建个会议

帮我在明天下午3点创建一个1小时的会议，主题是"项目评审"

2. 邮件处理： 检查未读邮件

检查我的未读邮件，总结最重要的3封

3. 文档编辑： 创建一个 Google Doc

创建一个新的 Google Doc，标题是"周报模板"，包含本周工作总结的框架

完成标准： 成功完成至少 2 个 Google Workspace 任务

第八步：设置定时任务（Cron Jobs）

让 OpenClaw 到点自动干活。

创建每日简报

我想让你每天早上 8 点给我发送一份简报，包含：
1. 今天的天气
2. 我的日历安排
3. 未读邮件数量
4. 一句励志的话

OpenClaw 会自动生成一个定时任务（cron job）。

管理定时任务

# 列出所有定时任务
openclaw cron list
# 查看任务详情
openclaw cron show 
# 禁用任务
openclaw cron disable 
# 删除任务
openclaw cron delete 

实践任务 8：创建定时任务

创建这几个：

1. 每日简报： 每天早上发天气和日程
2. 每周总结： 每周五下午发本周统计
3. 定时提醒： 每天下午 6 点提醒你收工

完成标准： 至少创建 2 个定时任务，验证能正常运行

第九步：配置持久记忆

记忆系统能让 OpenClaw 记住你的喜好。

训练你的助手

直接告诉它你的事：

记住以下关于我的信息：
- 我的名字是 [你的名字]
- 我的工作是 [你的职业]
- 我的工作时间是周一到周五 9:00-18:00
- 我喜欢简洁的回复，不要太啰嗦
- 我使用中文交流
- 我的时区是 GMT+8

查看记忆

# 查看记忆文件
cat ~/.openclaw/memory/long-term.json
# 或在对话中直接问
你记得我的哪些信息？

实践任务 9：个性化你的助手

1. 给它起个名字
2. 告诉它你的基本信息和偏好
3. 设置工作习惯和时间安排
4. 测试它记住了没有

完成标准： OpenClaw 能在对话中体现出对你的了解

中级阶段：高级应用

第十步：编写自定义 Skill

Skills 用 YAML 或 Markdown 格式来写。

Skill 基本结构

建个文件 ~/.openclaw/skills/my-first-skill.yaml：

name: "每日新闻摘要"
description: "获取并总结今日科技新闻"
version: "1.0.0"
triggers:
  - "今日新闻"
  - "科技新闻"
steps:
  - action: web_search
    query: "latest tech news today"
    max_results: 5
  - action: summarize
    content: "{{search_results}}"
    style: "bullet_points"
  - action: respond
    message: "? 今日科技新闻摘要：
{{summary}}"

安装自定义 Skill

# 重新加载 Skills
openclaw skills reload
# 测试 Skill
openclaw skills test "每日新闻摘要"

实践任务 10：创建自定义 Skill

挑一个场景创建一个：

1. 天气助手： 查城市天气并格式化输出
2. 任务管理器： 添加、查看、完成待办事项
3. 网站监控： 定期检查网站可访问性
4. 价格追踪： 监控商品价格变化

完成标准： 成功创建并运行一个自定义 Skill

第十一步：多 Agent 管理

可以跑多个 OpenClaw 实例，给它们不同的配置和用途。

创建多个 Agent

# 创建工作用 Agent
openclaw create-agent work
openclaw config --agent work set ai.model "claude-sonnet-4.6"
# 创建个人用 Agent
openclaw create-agent personal
openclaw config --agent personal set ai.model "gpt-5.3"
# 切换 Agent
openclaw switch-agent work
openclaw switch-agent personal
# 列出所有 Agent
openclaw list-agents

使用场景

• 工作 Agent： 连公司邮箱、项目管理工具
• 个人 Agent： 管个人日程、家里的事
• 实验 Agent： 测试新功能、新 Skills

实践任务 11：配置多 Agent

创建至少 2 个不同用途的 Agent，给它们配不同的：

• AI 模型
• 消息平台
• Skills
• 权限级别

完成标准： 能在不同 Agent 之间切换并使用

第十二步：Docker 沙盒安全实践

Docker 沙盒能提供最强的安全隔离。

配置 Docker 沙盒

# 安装 Docker（如果还没有）
# macOS: 下载 Docker Desktop
# Linux: sudo apt install docker.io
# 配置 OpenClaw 使用 Docker 沙盒
openclaw config set sandbox.mode "docker"
openclaw config set sandbox.docker.image "openclaw/sandbox:latest"
# 测试沙盒
openclaw sandbox test

沙盒限制

Docker 沙盒会限制这些：

• 文件系统访问（只能访问指定目录）
• 网络访问（可配置白名单）
• 系统命令执行
• 资源使用（CPU、内存限制）

实践任务 12：安全配置

1. 启用 Docker 沙盒模式
2. 运行安全审计：openclaw security audit --deep
3. 根据审计结果修问题
4. 测试沙盒限制是否生效

完成标准： 安全审计通过，沙盒正常工作

第十三步：浏览器控制

OpenClaw 能直接操控浏览器，干复杂的网页操作。

启用浏览器控制

# 安装浏览器控制插件
openclaw plugins install @openclaw/browser-control
# 配置浏览器
openclaw config set browser.enabled true
openclaw config set browser.headless false  # false 表示显示浏览器窗口

使用示例

打开浏览器，访问 GitHub，搜索 "openclaw"，并告诉我前 3 个结果

帮我在亚马逊上搜索 "机械键盘"，找到评分最高的 3 个产品，记录价格

实践任务 13：浏览器自动化

用浏览器控制完成其中一项：

1. 信息收集： 从某个网站抓数据并整理
2. 表单填写： 自动填一个在线表单
3. 价格比较： 在多个网站比价

完成标准： 成功完成至少 1 个浏览器自动化任务

第十四步：与其他工具集成

Linear 集成（项目管理）

# 安装 Linear Skill
openclaw skills install @openclaw/linear
# 配置 API Key
openclaw config set integrations.linear.apiKey "YOUR_LINEAR_API_KEY"

使用示例：

在 Linear 中创建一个新任务："修复登录页面的 bug"，优先级高

Obsidian 集成（笔记）

# 安装 Obsidian Skill
openclaw skills install @openclaw/obsidian
# 配置 Obsidian vault 路径
openclaw config set integrations.obsidian.vaultPath "/path/to/obsidian/vault"

使用示例：

在 Obsidian 中创建一篇新笔记，标题是"OpenClaw 学习笔记"

实践任务 14：集成第三方工具

挑至少 2 个你常用的工具，跟 OpenClaw 集成：

• 项目管理： Linear, Jira, Trello
• 笔记： Obsidian, Notion, Evernote
• 代码： GitHub, GitLab
• 通讯： Slack, Discord, Teams

完成标准： 成功集成并使用至少 2 个第三方工具

第十五步：高级配置优化

性能优化

# 配置缓存
openclaw config set cache.enabled true
openclaw config set cache.ttl 3600
# 配置并发请求
openclaw config set ai.maxConcurrentRequests 3
# 配置超时
openclaw config set ai.timeout 30000

成本控制

# 设置每日 API 调用限制
openclaw config set ai.dailyLimit 1000
# 设置每月预算（美元）
openclaw config set ai.monthlyBudget 50
# 查看使用统计
openclaw stats usage
openclaw stats cost

日志和调试

# 启用详细日志
openclaw config set logging.level "debug"
# 查看日志
openclaw logs
# 查看特定时间的日志
openclaw logs --since "2026-02-20"
# 导出日志
openclaw logs --export logs.txt

实践任务 15：优化配置

1. 根据使用情况优化性能配置
2. 设置成本控制，别让费用翻车
3. 配置日志，方便查问题
4. 监控一周的使用情况和成本

完成标准：

• 配置了成本控制
• 能查看使用统计
• 理解日志系统

实践任务清单

新手阶段（必做）

• 任务 1： 检查并安装 Node.js v18+
• 任务 2： 完成 OpenClaw 安装（选一种方式）
• 任务 3： 运行初始化向导，配置 API Key
• 任务 4： 跟 OpenClaw 完成第一次对话
• 任务 5： 探索工作空间和配置文件

进阶阶段（推荐）

• 任务 6： 安装并测试至少 3 个 Skills
• 任务 7： 完成 Google Workspace 集成（至少 2 个功能）
• 任务 8： 创建至少 2 个定时任务
• 任务 9： 个性化助手，配置记忆系统

中级阶段（进阶）

• 任务 10： 创建一个自定义 Skill
• 任务 11： 配置多个 Agent 用于不同场景
• 任务 12： 启用 Docker 沙盒并通过安全审计
• 任务 13： 完成一个浏览器自动化任务
• 任务 14： 集成至少 2 个第三方工具
• 任务 15： 优化配置并设置成本控制

实战项目（挑战）

• 项目 1： 构建自动化工作流，每天早上发个性化简报
• 项目 2： 创建邮件自动分类和回复系统
• 项目 3： 搭建多渠道消息聚合中心
• 项目 4： 开发价格监控和提醒系统
• 项目 5： 构建自动化内容发布系统（博客/社交媒体）

常见问题解答

Q1: OpenClaw 的技术要求是什么？

OpenClaw 主要面向有点技术背景的用户。你需要：

• 会敲命令行
• 理解环境变量配置
• 知道 API Key 是什么

不过安装过程已经大大简化了，只要能跑 npm 命令，就能用上 OpenClaw。

Q2: 如何管理安全风险？

关键安全建议：

1. 用沙盒模式： 初期测试时就用沙盒模式
2. 别存储敏感密码： 不要在配置文件里放明文密码
3. 定期审查： 定期检查自动化规则
4. 理解权限： 只开你需要的权限
5. 专用设备： 建议在专用设备上跑（比如 Mac Mini、旧笔记本）
6. 独立账号： 给 OpenClaw 创建独立的邮箱和账号

Q3: API 成本大概是多少？

看你怎么用了：

• 轻度使用（每天 10-20 次对话）：约 $5-10/月
• 中度使用（每天 50-100 次对话 + 定时任务）：约 $20-30/月
• 重度使用（大量自动化 + 浏览器控制）：约 $50-100/月

省钱技巧：

• 用 API 聚合服务拿更优惠的价格
• 设置每日/每月使用限制
• 优先用便宜点的模型
• 新用户通常有免费额度可薅

Q4: 可以用本地模型吗？

可以的！OpenClaw 支持通过 Ollama 接本地模型：

# 安装 Ollama
curl -fsSL https://ollama.ai/install.sh | sh
# 下载模型
ollama pull llama3.2
# 配置 OpenClaw
openclaw config set ai.provider "ollama"
openclaw config set ai.model "llama3.2"
openclaw config set ai.baseUrl "http://localhost:11434"

注意： 本地模型的能力通常比不上云端大模型，复杂任务可能会力不从心。

Q5: OpenClaw 支持中文吗？

完全支持！OpenClaw 有中文社区维护的汉化版本：

• 提供中文界面和中文文档
• 每小时自动同步官方更新

当然，你用英文版也没问题，它照样能理解和回复中文。

Q6: 如何备份我的配置？

# 备份整个工作目录
cp -r ~/.openclaw ~/.openclaw-backup
# 或使用 Git 同步（推荐）
cd ~/.openclaw
git init
git add .
git commit -m "Initial backup"
git remote add origin YOUR_GITHUB_REPO
git push -u origin main

OpenClaw 自带的 GitHub 同步功能，可以自动备份配置。

Q7: 遇到问题如何调试？

# 1. 查看日志
openclaw logs
# 2. 运行健康检查
openclaw doctor
# 3. 运行安全审计
openclaw security audit
# 4. 启用调试模式
openclaw config set logging.level "debug"
openclaw
# 5. 查看配置
openclaw config list

Q8: 可以在服务器上运行吗？

可以的！很多用户在 VPS 或云服务器上跑 OpenClaw：

推荐平台：

• DigitalOcean（有一键部署）
• AWS EC2
• 阿里云轻量应用服务器
• Cloudflare Workers（$5/月方案）

注意事项：

• 确保服务器安全配置
• 用 HTTPS 连接
• 配好防火墙
• 定期更新系统

学习资源

官方资源

• 官方网站： https://openclaw.ai/
• GitHub 仓库： github.com/openclaw/openclaw
• 官方文档： https://docs.openclaw.ai/zh-CN
• Skills 市场： github.com/VoltAgent/awesome-openclaw-skills

视频教程

• freeCodeCamp 完整教程 (1 小时）
• OpenClaw 新手入门 (30 分钟）
• 30 分钟精通 OpenClaw
• OpenClaw 速成课程

文字教程

• freeCodeCamp 新手教程
• DigitalOcean 部署教程
• Reddit 详细指南

中文资源

• CSDN 汉化版教程
• OpenClaw 中文使用教程
• 阿里云部署教程
• Apifox 安装指南

社区

• Reddit： r/clawdbot, r/AiForSmallBusiness
• Discord： OpenClaw 官方 Discord 服务器
• GitHub Discussions： 在 GitHub 仓库的 Discussions 区提问
• 中文社区： MaoTouHU/OpenClawChinese

下一步

走到这里，你应该已经掌握了 OpenClaw 从基础到中级的大部分核心技能。接下来可以：

1. 深入某个领域： 挑一个你最感兴趣的功能（比如浏览器自动化、邮件管理）深入研究
2. 参与社区： 在 GitHub 上贡献代码，或在 Clawhub 上分享你的 Skills
3. 构建实战项目： 用 OpenClaw 解决你实际工作或生活中的问题
4. 探索高级功能： 研究多 Agent 协作、自定义插件开发等更深入的话题

OpenClaw 代表了 AI 助手的下一步：从“会说话的工具”到“会做事的助手”。对于愿意花时间配置的用户来说，它完全可以成为你的数字分身。

来源：互联网