🔥 BRAVE 質押池已上線 — 在錢包搜尋 BRAVE 即可委託
简体

Brave基地

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

    • 2026 年 1 月 26 日 上午 2:23 #32877
      Brave

      一、什么是 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+ 内存
      🖥️ MacmacOS 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 2GB2 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.2OpenAI 最新旗舰需要 GPT 特性时

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

      技能按如下优先级加载：

      优先级位置说明
      🥇 最高<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

  • 抱歉，回覆主題必需先登入。