主权个人必看的 Clawdbot/OpenClaw 本地部署完全指南（2026版）

人工智能研究

主权个人必看的 Clawdbot/OpenClaw 本地部署完全指南（2026版）

發布人 Brave 2026-01-26 02:23

一、什么是 OpenClaw
1.1 认识 OpenClaw
1.2 OpenClaw 与传统 AI 助手的本质区别
1.3 OpenClaw 能做什么？
二、准备工作
2.1 硬件要求
2.2 软件环境要求
2.3 获取 AI 模型的 API Key
三、安装 OpenClaw（分系统详解）
3.1 🍎 macOS 安装
3.2 🪟 Windows 安装
3.3 🐧 Linux 安装（Ubuntu/Debian）
3.4 🐳 Docker 安装（高级用户/服务器部署）
3.5 🔧 从源码安装（开发者）
四、配置详解
4.1 配置 AI 模型（以 Anthropic Claude 为例）
4.2 配置消息通道
4.3 安全设置：DM 权限控制
4.4 Gateway 认证配置
五、访问本地控制台
5.1 启动 Gateway
5.2 打开 Web 控制台
六、技能（Skills）与扩展
6.1 理解 OpenClaw 的能力系统
6.2 技能的存放位置
6.3 使用 ClawdHub 安装社区技能
6.4 常用内置技能示例
七、日常使用指南
7.1 基本对话
7.2 常用命令
7.3 远程访问（可选）
八、常见问题排查
❌ 问题 1：安装后提示"command not found: openclaw"
❌ 问题 2：Gateway 无法启动
❌ 问题 3：提示"No API key found for provider 'anthropic'"
❌ 问题 4：WhatsApp 二维码扫描后无反应
❌ 问题 5：Claude Code OAuth Token 报错
❌ 问题 6：No auth configured
九、进阶配置
9.1 使用本地大模型（Ollama）
9.2 多 Agent 配置
9.3 编写自定义技能
十、最佳实践与建议
✅ 安全建议
✅ 性能优化
✅ 使用技巧
总结
附录
📚 参考资源

一、什么是 OpenClaw

1.1 认识 OpenClaw

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

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

名称变更历史：

时间	名称	说明
2025年11月	Clawdbot	原始名称
2026年1月28日	Moltbot	因 Anthropic 商标异议更名
2026年1月29日	OpenClaw	最终定名

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

对比维度	传统 AI 助手（Siri/小爱）	OpenClaw
🏠 运行位置	云端服务器	你自己的设备
🔐 数据归属	存储在公司服务器	完全存储在本地
💬 交互方式	专用 App 或语音	微信、Telegram、Discord 等你已有的聊天软件
🧠 AI 模型	厂商指定	自由选择（Claude、GPT、本地模型等）
🔧 可扩展性	几乎不可定制	开源，完全可定制
⏰ 主动性	被动响应	可主动提醒、汇报、预警
💰 费用	订阅制	复用现有 AI 订阅或 API
🧠 记忆	每次对话重新开始	持久记忆，跨天任务不失忆

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 对硬件要求非常友好：

设备类型	最低配置	推荐配置
💻 个人电脑	4GB 内存	8GB+ 内存
🖥️ Mac	macOS 11+ (Intel/Apple Silicon)	M1/M2/M3/M4 芯片
🐧 Linux 服务器	Ubuntu 20.04+	Ubuntu 22.04/24.04（推荐）
🥧 树莓派	Raspberry Pi 4 (4GB)	Raspberry Pi 5 (8GB)
🐳 Docker 环境	2 核心 2GB 内存	4 核心 4GB 内存
☁️ 云服务器	1 vCPU 2GB	2 vCPU 4GB（推荐）

💡 技术小白提示：如果你只是想体验，用你日常使用的 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 订阅	已有订阅用户	$100-200/月	⭐⭐⭐⭐⭐
Anthropic API	按量付费用户	按使用量计费	⭐⭐⭐⭐
本地模型（Ollama）	高级用户/隐私敏感	免费（需显卡）	⭐⭐⭐

💡 官方强烈推荐：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 检查配置是否正确

🎯 推荐模型选择：

模型	特点	适用场景
`anthropic/claude-opus-4-5`	最强大，长上下文	复杂任务、深度分析（推荐）
`anthropic/claude-sonnet-4-5`	平衡性能与成本	日常使用
`openai/gpt-5.2`	OpenAI 最新旗舰	需要 GPT 特性时

4.2 配置消息通道

🔍 查看当前通道状态：

openclaw channels status

📱 配置 Telegram

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

openclaw channels login --provider telegram

按提示输入你的 Bot Token。

💬 配置 Discord

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

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 技能的存放位置

技能按如下优先级加载：

优先级	位置	说明
🥇 最高	`<workspace>/skills/`	当前工作区技能
🥈 中等	`~/.openclaw/skills/`	用户全局技能
🥉 最低	内置技能	系统自带技能

6.3 使用 ClawdHub 安装社区技能

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

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

# 安装技能
openclaw skills install web-scraper

# 查看已安装技能
openclaw skills list

6.4 常用内置技能示例

技能名称	功能	示例用法
`web-search`	网络搜索	"帮我搜索最新的 AI 新闻"
`browser`	浏览器自动化	"打开 GitHub 并截图"
`terminal`	执行终端命令	"查看当前目录文件"
`calendar`	日历管理	"明天下午3点提醒我开会"
`file-manager`	文件操作	"整理下载文件夹"

七、日常使用指南

7.1 基本对话

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

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

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

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

7.2 常用命令

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

命令	功能
`/status`	查看系统状态
`/memory`	查看当前记忆
`/forget`	清除某条记忆
`/skills`	列出可用技能
`/model`	切换 AI 模型
`/help`	获取帮助

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. 最后...

十、最佳实践与建议

✅ 安全建议

建议	原因
🔒 保持 Gateway 仅绑定 localhost	避免未授权访问
🔑 定期轮换 API Key	降低密钥泄露风险
👥 使用 DM 配对机制	防止陌生人滥用
💾 定期备份 `~/.openclaw` 目录	保护记忆和配置
🖥️ 考虑在独立设备/VPS 上运行	避免给 AI 访问个人电脑的完全权限

✅ 性能优化

建议	效果
使用 SSD 存储	提升响应速度
分配足够内存	避免 OOM 崩溃
合理选择模型	平衡成本与性能
定期清理旧日志	释放磁盘空间

✅ 使用技巧

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

总结

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

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

正如其官方 Slogan 所说：

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

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

附录

📚 参考资源

资源	链接
🏠 官方网站	openclaw.ai
📖 官方文档	docs.openclaw.ai
💻 GitHub 仓库	github.com/openclaw/openclaw
🔌 技能市场	clawdhub.com
📦 npm 包	npmjs.com/package/openclaw

Brave 回复 1 month, 3 weeks ago 1 成員 · 0 回复

0 回复

歡迎留言回复交流。

登入後即可回复

人工智能研究

組織者: