Loading...
蜜蜂导航 蜜蜂导航
热门
立即入驻

OpenClaw 本地 AI 助手完整部署指南（小白零踩坑）

教程7个月前更新 admin
921 0 0
RackNerd Leaderboard Banner广告也精彩

什么是 OpenClaw

OpenClaw 是一个开源自托管的个人 AI 助手，它运行在你自己的设备上，通过你日常使用的聊天软件（WhatsApp、Telegram、Discord、iMessage 等）与你交互。

OpenClaw 本地 AI 助手完整部署指南（小白零踩坑）

OpenClaw

核心特性

  • 本地优先：所有对话记录、操作日志存储在你的硬盘上，数据完全自主可控
  • 多渠道支持：支持 WhatsApp、Telegram、Discord、Slack、Signal、iMessage 等 12+ 聊天平台
  • 持久记忆：能够记住你的历史对话和偏好，形成私人知识库
  • 主动服务：可设置定时任务，让 AI 主动推送提醒和信息
  • 系统级操作：能执行浏览器自动化、Shell 命令、文件操作等

适用场景

  • 个人知识管理：自动整理笔记、总结文档
  • Web 自动化：自动填表、抓取数据、监控价格
  • 智能生活控制：连接智能家居设备
  • 开发运维辅助：运行测试脚本、监控系统状态

系统要求

硬件要求

  • 处理器：任意现代处理器
  • 内存：至少 2GB RAM
  • 存储空间：至少 1GB 可用空间

软件要求

  • 操作系统：

◦ ✅ macOS 12.0 或更高版本（推荐）

◦ ✅ Linux（Ubuntu 20.04+ / Debian 11+）

◦ ✅ Windows 10/11（需要 WSL2，强烈推荐）

  • Node.js：v22.17.0 或更高版本（必须）
  • 包管理器：npm（自带）或 pnpm（推荐）

网络要求

  • 稳定的互联网连接
  • 能够访问 GitHub 和 openclaw.ai 官网

安装方式选择

OpenClaw提供多种安装方式，根据你的需求选择：

安装方式 推荐人群 难度 优点
npm/pnpm 安装 普通用户 ⭐⭐ 官方推荐，更新方便
安装脚本 想快速上手的用户 ⭐ 一键安装，最简单
从源码安装 开发者 ⭐⭐⭐⭐ 可自定义，适合贡献代码
Docker 安装 容器化部署用户 ⭐⭐⭐ 隔离性好，易迁移

可通过第三方云，秒级安装与快速配置

现在各大云平台都已经支持这个智能体，适合希望快速部署免去本地环境调试麻烦的团队和个人；如果不想安装在本机，可以一键部署云上OpenClaw：

🔥🔥🔥云产品福利专区，OpenClaw建议使用 2C4G：https://curl.qcloud.com/74iJUr08

🔥🔥🔥云上OpenClaw最全教程合辑：https://cloud.tencent.com/developer/article/2624973

🔥🔥🔥使用阿里云的轻量级服务器安装教程合辑：https://help.aliyun.com

🔥🔥🔥使用天翼云服务器安装教程合辑https://www.ctyun.cn/t/ubVwgHtq4fwu2sjfeEJYgZ1CmN0kwnS7

🔥🔥🔥玩转OpenClaw：OpenClaw(Clawdbot)上云一键秒级部署保姆级教程

🔥🔥🔥DNSBEE-简单、快速、免费的二级域名分发

方法一：官方推荐安装（npm/pnpm）

这是官方推荐的安装方式，适合大多数用户。

步骤 1：安装 Node.js v22+

检查 Node.js 版本

node --version

如果版本低于 v22，需要升级：

使用 nvm（推荐）

# 安装 nvm（如果尚未安装）

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 重新加载 shell 配置

source ~/.bashrc # 或 source ~/.zshrc

# 安装 Node.js v22

nvm install 22

nvm use 22

直接下载（macOS/Linux）

访问 nodejs.org 下载 v22+ 版本安装。

步骤 2：全局安装 OpenClaw

使用 npm

npm install -g openclaw@latest

使用 pnpm（推荐，更快）

# 先安装 pnpm（如果尚未安装）

npm install -g pnpm

# 使用 pnpm 安装 OpenClaw

pnpm add -g openclaw@latest

步骤 3：验证安装

openclaw --version

如果显示版本号，说明安装成功！

方法二：安装脚本（一键安装）

这是最简单的安装方式，适合不想手动配置的用户。

macOS / Linux 安装

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

这个脚本会自动：

  • ✅ 检测系统环境（Linux/Node.js/Git）
  • ✅ 下载 OpenClaw 最新版本
  • ✅ 安装所有必要依赖
  • ✅ 完成初始化配置

Windows 安装（PowerShell）

iwr -useb https:///openclaw.ai/install.ps1 | iex

注意：Windows 用户强烈建议使用 WSL2 环境安装。

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

适合想要修改代码或贡献项目的开发者。

步骤 1：克隆仓库

git clone https://github.com/openclaw/openclaw.git

cd openclaw

步骤 2：安装依赖

使用 pnpm（官方推荐）

# 安装 pnpm（如果尚未安装）

npm install -g pnpm

# 安装项目依赖

pnpm install

步骤 3：构建项目

# 构建 UI（首次运行会自动安装 UI 依赖）

pnpm ui:build

# 构建项目

pnpm build

步骤 4：运行向导

pnpm openclaw onboard --install-daemon

方法四：Docker 安装

适合容器化部署环境。

使用官方镜像

docker run -d \

 --name openclaw \ -p 18789:18789 \ -v $(pwd)/config:/app/config \ -v $(pwd)/data:/app/data \ openclaw/openclaw:latest

使用 docker-compose

创建 docker-compose.yml 文件：

version: '3.8'
services:
 openclaw:
 image: openclaw/openclaw:latest
 container_name: openclaw
 ports:
 - "18789:18789"
 - "18793:18793"
 environment:
 - NODE_ENV=production
 - CLAWD_CONFIG_PATH=/app/config
 volumes:
 - ./config:/app/config
 - ./data:/app/data
 restart: unless-stopped
 healthcheck:
 test: ["CMD", "curl", "-f", "http://localhost:18789/health"]
 interval: 30s
 timeout: 10s
 retries: 3

启动容器：

docker-compose up -d

进入容器运行向导：

docker exec -it clawdbot bash

openclaw onboard

初始化配置

安装完成后，运行交互式配置向导：

openclaw onboard --install-daemon

--install-daemon 参数会将 Clawdbot 安装为系统服务（macOS 的 launchd 或 Linux 的 systemd），确保它在后台常驻运行。

向导会引导你完成以下配置：

1. 网关模式选择

选择网关运行位置：

- [1] 本地（local）- 推荐，在当前机器上运行

- [2] 远程（remote）- 在远程服务器上运行

新手建议：选择 local 本地模式。

2. AI 模型配置

OpenClaw 需要连接到大语言模型才能工作。

支持的模型提供商：

  • Anthropic (Claude) - 官方推荐
  • OpenAI (GPT)
  • 其他兼容 API

配置方式：

方式 A：OAuth 认证（推荐）

# 向导会引导你通过浏览器完成 OAuth 授权

# 支持的订阅：

# - Anthropic Claude Pro/Max

# - OpenAI ChatGPT Plus

方式 B：API Key

# 输入你的 API Key

# 例如：sk-ant-xxxxx（Anthropic）

# 或：sk-xxxxx（OpenAI）

获取 API Key：

提供商 获取地址
Anthropic https://console.anthropic.com/
OpenAI https://platform.openai.com/api-keys

 

3. 安全提示

⚠️ 安全提示

Openclaw agents 可以运行命令、读写文件，

并通过你配置的工具访问任何渠道。

请阅读安全文档：https://docs.openclaw.ai/security

是否同意并继续？ [Y/n]

输入 Y 确认继续。

4. 启动模式

选择启动模式：

- [1] Quick Start（快速启动）- 推荐新手

- [2] Custom（自定义）- 高级用户

Quick Start 会自动配置：

  • Gateway 端口：18789
  • 绑定地址：loopback (127.0.0.1)
  • 认证方式：token
  • Tailscale 暴露：关闭
  • 直接连接聊天渠道

新手建议选择 Quick Start。

5. 聊天渠道配置

向导会询问你要连接哪些聊天平台：

选择要配置的聊天渠道：

- [1] Telegram

- [2] WhatsApp

- [3] Discord

- [4] iMessage（仅 macOS）

- [5] 跳过

建议先配置一个渠道进行测试，推荐 Telegram（最简单）。

连接聊天平台

配置 Telegram Bot

步骤 1：创建 Telegram Bot

  1. 打开 Telegram，搜索并联系 @BotFather
  2. 发送命令 /newbot
  3. 按照提示：

◦ 输入 Bot 的显示名称（如：MyClawdBot）

◦ 输入 Bot 的用户名（必须以 bot 结尾，如：myclawdbot）

  1. BotFather 会返回一个 Token（格式类似：123456789:ABCdefGHIjklMNOpqrsTUVwxyz）
  2. 复制这个 Token

步骤 2：配置 OpenClaw

在向导中或手动配置：

openclaw channels add telegram --token=你的_BOT_TOKEN

步骤 3：首次配对

  1. 在 Telegram 中搜索并私聊你的 Bot
  2. 发送任意消息（如 hello）
  3. Bot 会返回一个配对码（如：Pairing code: 1234）
  4. 在终端中批准配对：

openclaw pairing approve telegram 1234

  1. 配对成功后，Bot 就能正常响应你的消息了

配置 WhatsApp

步骤 1：登录 WhatsApp

openclaw channels login

终端会显示一个 二维码。

步骤 2：扫码连接

  1. 打开手机上的 WhatsApp
  2. 进入 设置 → 已连接设备
  3. 点击 连接设备
  4. 扫描终端上的二维码

步骤 3：配对设备

连接成功后，Clawdbot 会显示你的手机号。首次私聊时需要批准：

# 查看待批准的配对请求

openclaw pairing list whatsapp

# 批准配对（替换为实际号码）

openclaw pairing approve whatsapp +86123456789

配置 Discord

步骤 1：创建 Discord Application

  1. 访问 Discord Developer Portal
  2. 点击 New Application，创建应用
  3. 在 Bot 页面，点击 Add Bot
  4. 复制 Bot Token

步骤 2：启用必要的权限

在 Bot 设置中启用：

  • ✅ Message Content Intent
  • ✅ Server Members Intent（如果需要群组功能）

步骤 3：邀请 Bot 到服务器

  1. 在 OAuth2 → URL Generator 页面
  2. 选择 Scopes：bot
  3. 选择 Bot Permissions：Send Messages、Read Messages/View Channels 等
  4. 复制生成的 URL，在浏览器中打开
  5. 选择你的服务器并授权

步骤 4：配置 Clawdbot

openclaw channels add discord --token=你的_BOT_TOKEN

配置 iMessage（仅 macOS）

iMessage 集成需要额外的配置：

# 安装依赖（如果尚未安装）

brew install imessage

# 配置 iMessage 渠道

openclaw channels add imessage

注意：iMessage 集成需要 macOS 系统权限，首次使用时需要在系统设置中授权。

安全配对

默认情况下，未知的私聊消息不会被处理（安全机制）。

查看待批准的配对请求

# 列出所有渠道的待批准请求

openclaw pairing list

# 列出特定渠道的待批准请求

openclaw pairing list telegram

openclaw pairing list whatsapp

openclaw pairing list discord

批准配对

# 批准 Telegram 用户的配对（替换配对码）

openclaw pairing approve telegram 1234

# 批准 WhatsApp 号码的配对（替换手机号）

openclaw pairing approve whatsapp +86123456789

查看已批准的用户列表

openclaw pairing list --approved

启动网关

OpenClaw 的核心是 Gateway 进程，它管理所有聊天平台的连接。

如果在向导中安装了服务

Gateway 会自动作为系统服务运行：

检查服务状态

# macOS

brew services list | grep openclaw

# Linux

systemctl --user status openclaw

手动启动 Gateway

如果需要手动启动：

# 启动 Gateway（默认端口 18789）

openclaw gateway

# 启动并显示详细日志

openclaw gateway --verbose

# 指定端口

openclaw gateway --port 18789

# 绑定到 tailnet（用于远程访问）

openclaw gateway --bind tailnet --token 你的令牌

检查 Gateway 健康状态

openclaw health

如果一切正常，会显示：

✅ Gateway: Running

✅ Model: Connected

✅ Channels: Connected

访问控制面板

OpenClaw 提供了一个基于浏览器的 Control UI，用于监控和管理你的助手。

访问地址

本地访问：

http://127.0.0.1:18789/
# 或
http://localhost:18789/

控制面板功能

  • 📊 Dashboard：查看系统状态、会话统计
  • 💬 Chat：直接在浏览器中与 AI 对话
  • ⚙️ Config：查看和编辑配置
  • 📝 Sessions：管理历史会话
  • 🔧 Tools：查看可用工具和技能
  • 📱 Nodes：管理连接的设备节点

远程访问（可选）

如果需要在远程设备访问，可以使用：

方法 A：SSH 隧道

# 在远程机器上建立 SSH 隧道

ssh -L 18789:127.0.0.1:18789 your-server

# 然后在浏览器访问 http://localhost:18789

方法 B：Tailscale Serve

# 配置 Tailscale Serve（tailnet 访问）
openclaw gateway --bind tailnet --token 你的令牌

详见官方文档：Web Surfaces

常见问题排查

问题 1：Node.js 版本过低

错误信息：

Error: Node.js version must be v22 or higher

解决方法：

# 使用 nvm 升级 Node.js
nvm install 22
nvm use 22

问题 2：端口 18789 被占用

错误信息：

Error: Port 18789 is already in use

解决方法：

查找占用进程：

# macOS/Linux

lsof -i :18789

# 或

netstat -tuln | grep 18789

终止进程：

# 替换 PID 为实际进程 ID

kill -9 PID

或使用其他端口：

openclaw gateway --port 19001

问题 3：API Key 无效

错误信息：

Error: Invalid API key or authentication failed

解决方法：

  1. 检查 API Key 是否正确复制
  2. 确认 API Key 是否有效且未过期
  3. 检查 API Key 的权限是否足够

重新配置模型：

openclaw onboard

# 或手动编辑配置文件

问题 4：Bot 不响应消息

可能原因：

  1. Gateway 未运行
  2. 未完成配对（pairing）
  3. Bot Token 配置错误

解决方法：

检查 Gateway 状态：

openclaw health

检查配对状态：

openclaw pairing list

查看 Gateway 日志：

# 如果 Gateway 是手动启动的，查看终端输出

# 或查看系统日志

journalctl --user -u clawdbot -f # Linux

log stream --predicate 'process == "openclaw"' # macOS

问题 5：WhatsApp 连接失败

错误信息：

Error: WhatsApp connection failed

解决方法：

  1. 确保手机已连接互联网
  2. 尝试重新登录：
openclaw channels logout whatsapp

openclaw channels login
  1. 扫描新的二维码

问题 6：Telegram Bot 配对失败

解决方法：

  1. 确保 Bot Token 正确
  2. 在 Telegram 中向 Bot 发送消息后，查看配对码
  3. 在终端中批准配对：
openclaw pairing approve telegram 配对码

问题 7：Windows WSL2 问题

症状：

安装失败或运行异常

解决方法：

  1. 确保使用最新的 WSL2 版本：
wsl --update
  1. 确保 WSL2 网络连接正常
  2. 如果仍有问题，考虑使用 Docker Desktop 的 WSL2 集成

诊断工具

使用官方诊断工具检查配置：

openclaw doctor

这会检查：

  • ✅ Gateway 状态
  • ✅ 模型连接
  • ✅ 渠道配置
  • ✅ 安全设置
  • ⚠️ 潜在的风险配置

安全注意事项

1. 提示词注入风险

OpenClaw 拥有执行系统命令的权限，恶意文件可能触发提示词注入攻击。

防护措施：

  • ✅ 不要让 OpenClaw 处理来历不明的文件
  • ✅ 使用沙箱模式（sandbox）限制权限
  • ✅ 定期检查执行日志

2. 数据隐私

优点：

  • ✅ 所有数据存储在本地
  • ✅ 不上传对话到第三方服务器

注意：

  • ⚠️ API 调用仍会发送到模型提供商（如 Anthropic、OpenAI）
  • ⚠️ 建议使用本地模型（如 Ollama）处理敏感数据

3. 权限控制

默认安全策略：

  • 私聊消息需要配对（pairing）才能响应
  • 群组消息默认需要 @提及才会响应

配置白名单：

编辑配置文件 ~/.openclaw/openclaw.json：

// json

{

 "channels": {

 "whatsapp": {

 "allowFrom": ["+86123456789", "+86987654321"],

 "groups": {

 "*": { "requireMention": true }

 }

 },

 "telegram": {

 "allowFrom": [123456789, 987654321]

 }

 }

}

4. API 成本注意

OpenClaw 使用付费的 API（如 Claude、GPT），消耗的 Token 会计费。

成本预估：

  • 轻度使用：$10-30/月
  • 中度使用：$30-70/月
  • 重度使用：$70-150/月或更高

建议：

  • 监控 API 使用量
  • 设置预算告警
  • 考虑使用本地模型（如 Ollama）降低成本

进阶配置

配置本地模型（Ollama）

OpenClaw 支持使用本地运行的模型：

  1. 安装 Ollama：https://ollama.ai/
  2. 拉取模型：
`bash

ollama pull llama2

`
  1. 在 Clawdbot 中配置：
openclaw model add ollama

详见：Ollama Provider

配置多个 AI 模型

OpenClaw 支持配置多个模型作为备份（failover）：

编辑 ~/.openclaw/openclaw.json：

// json

{

 "agents": {

 "defaults": {

 "model": {

 "primary": "anthropic/claude-opus-4-5",

 "fallbacks": [

 "anthropic/claude-sonnet-4-5",

 "openai/gpt-4-turbo"

 ]

 }

 }

 }

}

安装技能（Skills）

OpenClaw 支持安装社区技能扩展功能：

浏览技能仓库：

  • 官方技能中心：https://clawdhub.com/

安装技能：

# 安装技能

openclaw skills install skill-name

# 列出已安装技能

openclaw skills list

# 更新技能

openclaw skills update skill-name

配置定时任务（Cron）

OpenClaw 支持定时任务：

编辑配置文件添加 cron 任务：

// json

{

 "cron": {

 "daily_summary": {

 "schedule": "0 8 * * *",

 "message": "Give me a daily summary of my schedule"

 }

 }

}

升级和更新

检查更新

openclaw update --check

执行更新

openclaw update

切换开发通道

# 切换到 beta 通道

openclaw update --channel beta

# 切换回 stable 通道

openclaw update --channel stable

详见：Updating Guide

卸载

停止服务

# macOS

brew services stop openclaw

# Linux

systemctl --user stop openclaw

systemctl --user disable openclaw

卸载 CLI

# 如果使用 npm

npm uninstall -g openclaw

# 如果使用 pnpm

pnpm remove -g openclaw

删除配置和数据（可选）

# 删除配置目录

rm -rf ~/.openclaw

# 删除数据目录

rm -rf ~/clawd

警告：删除数据目录会丢失所有对话记录和记忆！

获取帮助

官方资源

  • 📖 官方文档：https://docs.openclaw.ai/
  • 💻 GitHub 仓库：https://github.com/openclaw/openclaw
  • 💬 Discord 社区：https://discord.gg/clawd
  • 🐦 Twitter：@clawdbot

常用命令速查

# 安装

npm install -g openclaw@latest

# 初始化配置

openclaw onboard --install-daemon

# 启动 Gateway

openclaw gateway --port 18789 --verbose

# 健康检查

openclaw health

# 诊断

openclaw doctor

# 连接聊天渠道

openclaw channels login # WhatsApp

openclaw channels add telegram --token=TOKEN

# 配对管理

openclaw pairing list

openclaw pairing approve telegram 1234

# 发送测试消息

openclaw message send --target +1234567890 --message "Hello"

# 更新

openclaw update

总结

恭喜！你已经完成了 OpenClaw 的安装和配置。现在你可以：

  1. ✅ 通过 Telegram/WhatsApp/Discord 与你的 AI 助手对话
  2. ✅ 让它记住你的偏好和历史
  3. ✅ 设置定时任务，让它主动提醒你
  4. ✅ 执行系统命令和自动化任务
  5. ✅ 安装技能扩展功能

下一步建议：

  • 尝试发送几条测试消息
  • 配置定时任务（如每日提醒）
  • 安装一些基础技能
  • 阅读官方文档了解更多高级功能

祝你在 AI 助手的陪伴下，工作更高效，生活更轻松！🦞

最后更新：2026年1月30日

© 版权声明
文章版权归作者所有，未经允许请勿转载。
广告也精彩

相关文章

超详细！OpenClaw 本地部署保姆级实战教学
admin
1.8K
OpenClaw 浏览器配置完全指南
admin
389
OpenClaw | 开源自托管主动 AI 助手，为你重构专属工作流
admin
350
Clawdbot 部署教程：10 分钟白嫖 Qwen，为自己搭建 7x24 小时AI 助理
admin
508
2026 Claw 生态 AI Agent 全解析：5 款工具选型对比 + 部署避坑指南
admin
429
2026 开发者高效利器：10 个核心 OpenClaw Skills
admin
564

暂无评论

暂无评论...

相关文章

2026年最新Nvidia AI大模型完整指南：零成本用H100跑主流大模型
0
2026 开发者高效利器：10 个核心 OpenClaw Skills
0
OpenClaw | 开源自托管主动 AI 助手，为你重构专属工作流
0
2026 Claw 生态 AI Agent 全解析：5 款工具选型对比 + 部署避坑指南
0
OpenClaw 浏览器配置完全指南
0
本站大部分下载资源收集于网络，只做学习和交流使用，版权归原作者所有。若您需要使用非免费的软件或服务，请购买正版授权并合法使用。本站发布的内容若侵犯到您的权益，请联系站长删除，我们将及时处理。

友链申请免责声明广告合作关于我们

扫码加QQ群蜜蜂导航

扫码加QQ群

扫码加微信蜜蜂导航

扫码加微信
Copyright © 2026 蜜蜂导航