一、什么是 OpenClaw

1.1 认识 OpenClaw

OpenClaw 是一个完全开源、可以在你自己设备上运行的私人 AI 助手。 它由开发者 Peter Steinberger 于 2025 年底创建（原名 Clawdbot），短短数周内便成为 AI 社区最受关注的项目之一，在 GitHub 上获得了 超过 145,000 颗星。

🦞 为什么叫"龙虾"（Lobster Way）？

OpenClaw 的名字来源于"Claw"（龙虾钳）与"Bot"的组合，其官方吉祥物是一只可爱的龙虾。这个命名寓意着它像龙虾钳一样强大有力，能够精准地抓取和处理各种任务。

名称变更历史：

1.2 OpenClaw 与传统 AI 助手的本质区别

1.3 OpenClaw 能做什么？

根据 官方文档 和 Codecademy 教程，OpenClaw 不仅仅是一个聊天机器人，它是一个真正的"数字员工"：

🗣️ 多平台消息响应

• 支持 WhatsApp、Telegram、Discord、Slack、Signal、iMessage、Microsoft Teams、Google Chat、Matrix、Zalo 等 50+ 平台
• 你在任何聊天软件里 @它 或私聊它，它都能响应

🧠 持久记忆系统

• 记忆以 Markdown 文件形式存储在本地，类似 Obsidian 知识库
• 它能记住你的偏好、过往对话、重要信息
• 不会像普通 AI 那样"失忆"——支持跨越数天的长期任务

⚡ 主动行动能力

• 定时提醒、日程汇报、新闻摘要
• 监控任务并主动通知你结果
• 可以执行终端命令、编写并运行脚本、操控浏览器

🔌 强大的扩展系统

• Skills（技能）：类似插件，教会 AI 如何使用特定工具
• MCP 服务器：连接外部数据源和服务（100+ 第三方服务集成）
• ClawdHub：官方技能市场，565+ 社区技能一键安装

二、准备工作

2.1 硬件要求

根据 Hostinger 教程 和 DigitalOcean 指南，OpenClaw 对硬件要求非常友好：

💡 技术小白提示：如果你只是想体验，用你日常使用的 Mac 或 Windows 电脑就完全足够！

2.2 软件环境要求

📌 核心要求：Node.js 22 或更高版本

Node.js 是什么？

Node.js 是一个让 JavaScript 代码能在电脑上运行的环境。OpenClaw 是用 JavaScript/TypeScript 编写的，所以需要 Node.js 来运行它。你可以把 Node.js 理解为"OpenClaw 的运行引擎"。

2.3 获取 AI 模型的 API Key

OpenClaw 本身不包含 AI 大脑，它需要连接到 AI 模型服务。最推荐的选择是 Anthropic 的 Claude 模型。

🎯 获取 Claude API Key 的三种方式：

💡 官方强烈推荐：Claude Max/Pro 订阅 + Opus 4.5 模型

原因：更长的上下文窗口、更强的抗提示注入能力、可复用订阅额度无需额外购买 API

三、安装 OpenClaw（分系统详解）

3.1 🍎 macOS 安装

macOS 是 OpenClaw 支持最好的平台，有专门的 Mac 应用可用。

步骤一：安装 Node.js

打开"终端"（在启动台搜索"终端"或按 Cmd + 空格 搜索 Terminal），输入：

# 检查是否已安装 Node.js
node --version

如果显示 v22.x.x 或更高版本，跳到步骤二。如果提示"command not found"或版本低于 22，继续安装：

# 使用官方安装脚本（推荐新手）
curl -fsSL https://nodejs.org/install.sh | bash

或者使用 Homebrew（如果你已安装 Homebrew）：

brew install node@22

步骤二：安装 OpenClaw

# 官方一键安装脚本
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

或者使用 npm 手动安装：

npm install -g openclaw@latest

步骤三：运行初始化向导

openclaw onboard --install-daemon

🎯 这个命令会做什么？

• 引导你配置 AI 模型（选择 Anthropic、OpenAI 等）
• 输入你的 API Key 或登录凭据
• 安装 Gateway 守护进程（让 OpenClaw 作为后台服务持续运行）
• 配置消息通道（Telegram、Discord 等）

3.2 🪟 Windows 安装

⚠️ 重要提示：官方强烈推荐在 WSL2 中运行 OpenClaw

根据 官方文档：WSL2 is strongly recommended; native Windows is untested, more problematic, and has poorer tool compatibility.

什么是 WSL2？

WSL2（Windows Subsystem for Linux 2）让你可以在 Windows 上运行完整的 Linux 环境。OpenClaw 在 Linux 环境中运行更稳定，所以推荐使用 WSL2。

步骤一：启用 WSL2

以管理员身份打开 PowerShell，运行：

wsl --install

安装完成后重启电脑。重启后会自动打开 Ubuntu 终端，设置用户名和密码。

步骤二：在 WSL2 中安装 Node.js

# 更新系统包
sudo apt update && sudo apt upgrade -y

# 安装 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 验证安装
node --version  # 应显示 v22.x.x

步骤三：安装 OpenClaw

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon

3.3 🐧 Linux 安装（Ubuntu/Debian）

# 1. 更新系统
sudo apt update && sudo apt upgrade -y

# 2. 安装 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 3. 安装 OpenClaw
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

# 4. 初始化（安装为 systemd 服务）
openclaw onboard --install-daemon

3.4 🐳 Docker 安装（高级用户/服务器部署）

根据 DigitalOcean 一键部署教程：

# 拉取官方镜像
docker pull openclaw/openclaw:latest

# 运行容器
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

⚠️ v2026.1.29 更新：配置目录已从 ~/.clawdbot 迁移至 ~/.openclaw

3.5 🔧 从源码安装（开发者）

如果你想参与开发或使用最新特性：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build  # 首次运行时自动安装 UI 依赖
pnpm build
pnpm openclaw onboard --install-daemon

四、配置详解

4.1 配置 AI 模型（以 Anthropic Claude 为例）

📍 方式一：交互式配置（推荐新手）

openclaw onboard

运行后选择 "Anthropic API key"，按提示输入你的 API Key。

📍 方式二：命令行直接配置

openclaw onboard --anthropic-api-key "sk-ant-api03-你的密钥"

📍 方式三：配置文件

配置文件位于 ~/.openclaw/openclaw.json（JSON5 格式，支持注释），你可以直接编辑：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-5"
      }
    }
  },
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-api03-你的密钥"
  }
}

💡 验证配置：运行 openclaw doctor 检查配置是否正确

🎯 推荐模型选择：

4.2 配置消息通道

🔍 查看当前通道状态：

openclaw channels status

📱 配置 Telegram

1. 在 Telegram 中搜索 @BotFather，发送 /newbot
2. 按提示设置机器人名称，获取 Bot Token
3. 运行配置：

openclaw channels login --provider telegram

按提示输入你的 Bot Token。

💬 配置 Discord

1. 访问 Discord 开发者门户
2. 创建新应用 → 进入 Bot 设置 → 开启必要权限
3. 点击 "Reset Token" 获取 Bot Token
4. 运行配置：

openclaw channels login --provider discord

📲 配置 WhatsApp

WhatsApp 使用 WhatsApp Web 协议，需要扫码登录：

openclaw channels login --provider whatsapp

终端会显示一个二维码，用 WhatsApp 扫描即可。

⚠️ 重要限制：一台主机只能运行一个 Gateway 进程，因为它独占 WhatsApp Web 会话。

4.3 安全设置：DM 权限控制

🔒 从 v2026.1.8 版本开始，OpenClaw 默认锁定私聊功能

这意味着陌生人无法直接私聊你的机器人。你需要手动批准配对请求：

# 查看待批准的配对请求
openclaw pairing list --provider telegram

# 批准某个请求
openclaw pairing approve --provider telegram <配对码>

如果你希望开放给所有人使用（不推荐）：

在配置文件中设置：

{
  "channels": {
    "telegram": {
      "dmPolicy": "open",
      "allowFrom": ["*"]
    }
  }
}

4.4 Gateway 认证配置

⚠️ v2026.1.29 安全更新：Gateway 现在强制要求认证，auth: none 模式已被移除。

运行 openclaw onboard 时会自动生成 Gateway 令牌。如需手动配置：

{
  "gateway": {
    "bind": "lan",
    "port": 18789,
    "auth": {
      "token": "your-secure-token"
    }
  }
}

五、访问本地控制台

5.1 启动 Gateway

如果 Gateway 没有自动启动：

openclaw gateway

或者以后台服务启动：

openclaw gateway start

5.2 打开 Web 控制台

OpenClaw 提供了一个本地 Web 仪表板：

在浏览器中访问：

http://localhost:18789

或者：

http://127.0.0.1:18789

💡 提示：如果需要访问令牌，运行 openclaw dashboard --no-open 获取带 token 的 URL

🖥️ 控制台功能：

• 查看所有对话历史
• 管理通道连接状态
• 配置技能和插件
• 监控系统资源使用
• 查看日志和调试信息

六、技能（Skills）与扩展

6.1 理解 OpenClaw 的能力系统

OpenClaw 通过"技能"来扩展能力。技能本质上是一组指令和工具的组合：

🧠 OpenClaw 架构
├── Agent Loop（推理循环）—— 决定做什么
├── Agent Runtime（执行环境）—— 运行代码和脚本
├── MCP Servers（外部连接）—— 连接外部工具和数据
└── Skills（技能指南）—— 指导如何使用特定工具

6.2 技能的存放位置

技能按如下优先级加载：

6.3 使用 ClawdHub 安装社区技能

ClawdHub 是 OpenClaw 的官方技能市场，拥有 565+ 社区技能：

# 搜索技能
openclaw skills search "web scraping"

# 安装技能
openclaw skills install web-scraper

# 查看已安装技能
openclaw skills list

6.4 常用内置技能示例

七、日常使用指南

7.1 基本对话

配置完成后，你可以在 Telegram/Discord/WhatsApp 中直接与 OpenClaw 对话：

你：今天天气怎么样？
🦞：让我为你查询...北京今天晴，气温 15-23°C，适合外出！

你：帮我总结一下这个网页 https://example.com
🦞：正在读取网页内容...这篇文章主要讲述了...

你：每天早上 8 点给我发一份新闻摘要
🦞：好的，我已设置每日早报提醒，明天早上 8 点开始推送！

7.2 常用命令

在聊天中可以使用特殊命令：

7.3 远程访问（可选）

如果你想从外网访问家里的 OpenClaw：

方式一：SSH 隧道（推荐）

ssh -L 18789:localhost:18789 用户名@你的服务器IP

方式二：Tailscale（推荐）

使用 Tailscale VPN 可以安全地从任何地方访问你的 OpenClaw，无需暴露端口到公网。

方式三：反向代理（Nginx/Caddy）

配置反向代理并添加身份验证，将 Gateway 暴露到公网。但请注意安全风险！

八、常见问题排查

❌ 问题 1：安装后提示"command not found: openclaw"

解决方案：

# 确保 npm 全局目录在 PATH 中
export PATH="$HOME/.npm-global/bin:$PATH"

# 或者重新打开终端
# 或者运行
hash -r  # bash
rehash   # zsh

❌ 问题 2：Gateway 无法启动

解决方案：

# 检查端口是否被占用
lsof -i :18789

# 查看详细日志
openclaw gateway --verbose

# 运行诊断
openclaw doctor

❌ 问题 3：提示"No API key found for provider 'anthropic'"

解决方案：

⚠️ 注意！每个 Agent 的认证是独立的。新 Agent 不会继承主 Agent 的密钥。

# 重新运行 onboarding
openclaw onboard

# 或直接设置
openclaw config set env.ANTHROPIC_API_KEY "你的密钥"

# 验证模型状态
openclaw models status

❌ 问题 4：WhatsApp 二维码扫描后无反应

解决方案：

• 确保手机和电脑在同一网络
• 尝试重启 Gateway：openclaw gateway restart
• 清除 WhatsApp 会话：openclaw channels logout --provider whatsapp

❌ 问题 5：Claude Code OAuth Token 报错

⚠️ 重要更新（2026年1月）：

Anthropic 已更改 Claude Code OAuth tokens 的权限。它们现在仅限于在 Claude Code 内部使用，不能用于外部 API 调用。

解决方案：使用 API Key 或 setup-token 方式认证，而非 OAuth。

# 删除旧的 OAuth 凭据
rm ~/.openclaw/credentials/oauth.json

# 重新配置
openclaw onboard

❌ 问题 6：No auth configured

解决方案：

v2026.1.29 后 Gateway 强制要求认证。重新运行 onboard：

openclaw onboard

九、进阶配置

9.1 使用本地大模型（Ollama）

如果你有高性能显卡，可以使用本地运行的 AI 模型，完全免费且隐私：

# 1. 安装 Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# 2. 下载模型（推荐 64k+ 上下文的模型）
ollama pull glm-4.7

# 3. 启动 Ollama 服务
ollama serve

# 4. 配置 OpenClaw 使用本地模型
openclaw config set models.providers.ollama.apiKey 'ollama-local'
openclaw config set agents.defaults.model.primary 'ollama/glm-4.7'

💡 硬件要求：推荐 48GB VRAM 以获得最佳体验。无 GPU 时可在 CPU 上运行，但速度会慢 5-10 倍。

9.2 多 Agent 配置

OpenClaw 支持创建多个 Agent，用于不同场景：

# 创建工作专用 Agent
openclaw agents add --name "work-assistant"

# 列出所有 Agent
openclaw agents list

# 切换 Agent
openclaw agents switch work-assistant

9.3 编写自定义技能

创建一个简单的技能：

mkdir -p ~/.openclaw/skills/my-skill

创建 ~/.openclaw/skills/my-skill/SKILL.md：

---
name: my-custom-skill
description: "我的自定义技能"
tools:
  - terminal
---

# 我的技能

当用户请求 [某种操作] 时，按以下步骤执行：
1. 首先...
2. 然后...
3. 最后...

十、最佳实践与建议

✅ 安全建议

✅ 性能优化

✅ 使用技巧

• 建立"记忆仪式"：定期告诉 OpenClaw 你的偏好和习惯
• 善用主动提醒：让它成为你的私人秘书
• 组合多技能：例如"搜索+总结+发送邮件"一条龙
• 创建工作流模板：把常用任务流程固化为技能

总结

OpenClaw 代表了个人 AI 助手的新范式：

• ✅ 本地优先：你的数据永远在你的掌控之中
• ✅ 开放生态：社区驱动，持续进化（145,000+ GitHub Stars）
• ✅ 真正智能：不只是问答，更能主动行动
• ✅ 高度可定制：从模型到技能，一切随你心意
• ✅ 持久记忆：跨天任务不失忆

正如其官方 Slogan 所说：

"The AI Assistant Siri Promised But Never Delivered" （Siri 承诺过但从未实现的 AI 助手）

OpenClaw 正在让这个愿景成为现实。

附录

📚 参考资源