乐于分享
好东西不私藏

OpenClaw 完全新手指南:个人 AI 助手本地部署与配置

OpenClaw 完全新手指南:个人 AI 助手本地部署与配置

前言

你是否想过拥有一个完全属于你自己的 AI 助手?

它可以:

  • • 通过微信、Telegram、Slack、Discord 与你对话
  • • 帮你管理日程、发送提醒
  • • 控制浏览器自动化执行任务
  • • 甚至通过语音与你交流

这就是 OpenClaw——一个运行在你个人设备上的 AI 助手网关。


什么是 OpenClaw?

OpenClaw 是一款本地优先的个人 AI 助手,它的核心理念是:

"OpenClaw 是一款可以本地运行、连接各大通讯平台(如 Telegram、Slack 等)执行现实任务(文件管理、自动化工作流等)的开源个人 AI 智能体。"

  • • 个人化:只为你个人服务,而非企业级多用户系统
  • • 本地运行:Gateway 运行在你的设备上(macOS、Linux、Windows WSL2)
  • • 多渠道接入:支持几乎所有主流通讯平台
  • • 功能丰富:浏览器控制、Canvas 可视化、语音交互、定时任务等

架构概览

WhatsApp / Telegram / Slack / Discord / Google Chat / Signal / iMessage / WebChat                                       │                                       ▼                    ┌─────────────────────────────────────┐                    │                Gateway                              │                    │              (控制平面 - 核心)                         │                    │             ws://127.0.0.1:18789                       │                    └──────────────────┬──────────────────┘                                              │                    ┌──────────────────┼──────────────────┐                    │                         │                        │                    ▼                         ▼                        ▼                 AI 智能体                    CLI 命令行                    WebChat                  (Agent)                      工具                      网页界面

为什么你需要 OpenClaw?

在 AI 爆发的年代,我们已经有了 ChatGPT、Claude、Kimi 等强大的 AI 工具。但它们都有一个共同点:它们是云端服务,你的数据要上传到别人的服务器。

OpenClaw 的出现改变了这一点:

1. 隐私安全

你的数据完全存储在本地,不上传到任何云端服务。

2. 高度定制

你可以完全控制你的 AI 助手,包括:

  • • 选择使用什么大模型
  • • 安装什么技能 (Skills)
  • • 配置多个专属智能体

3. 无限扩展

通过 Skills 系统,你可以为 OpenClaw 无限扩展能力:

  • • 搜索、写作、翻译
  • • 浏览器自动化
  • • 连接各种 API(微信、Notion、飞书等)

安装指南

系统要求

  • • Node.js ≥ 22(必须)
  • • 操作系统:macOS、Linux、Windows (WSL2)
  • • 包管理器:npm、pnpm 或 bun

快速安装

# 推荐安装方式(可能会失败)curl -fsSL https://openclaw.ai/install.sh | bash

或者通过 npm 直接全局安装:

npm install -g openclaw@latest

初始化配置

# 快速设置向导(根据引导完成初始化操作,可提前准备好大模型的api_key)openclaw onboard --install-daemon# 初始化跳过可手动配置openclaw config

配置代理(可选,直接拉取代码可能出错)

如果需要访问海外 API,建议配置代理:

# 写入配置文件nano ~/.bashrc# 添加以下内容(根据你的代理地址修改)export http_proxy="http://127.0.0.1:17890"export https_proxy="http://127.0.0.1:17890"export all_proxy="socks5://127.0.0.1:17890"# 生效source ~/.bashrc

快速开始

1. 运行 Gateway

# 后台运行nohup openclaw gateway run > openclaw.log 2>&1 &
# 杀后台pkill -9 -f openclaw

2. 配置大模型

通过 openclaw config 命令可以配置使用的大模型,OpenClaw 支持:

  • • OpenAI
  • • Anthropic Claude
  • • Google Gemini
  • • Moonshot (Kimi)
  • • MiniMax
  • • 阿里 Qwen
  • • ..等等

3. 连接通讯渠道

OpenClaw 支持多种通讯渠道:

  • • Telegram
  • • 飞书
  • • Discord
  • • Slack
  • • WhatsApp
  • • WebChat(网页版)
  • • ..等等

进阶:多智能体架构

当单一智能体处理的任务过于复杂或成本过高时,OpenClaw 支持多智能体架构

角色分工

放弃单一的"全能"智能体,为不同任务创建隔离的专属智能体,例如:

  • • ResearchAgent:负责信息搜集
  • • CoderAgent:负责代码编写
  • • ReviewerAgent:负责审核检查

每个智能体拥有独立的 IDENTITY.md 和 TOOLS.md

协作模式

模式
说明
串行协作
后置智能体依赖前置智能体的输出结果
并行协作
同时处理相互独立的子任务
层级协作
设置"指挥官"智能体,负责分发任务并汇总结果

添加新智能体

# 添加新的智能体openclaw agents add work# 查看所有智能体openclaw agents list --bindings

进阶技巧与最佳实践

1. 工作区隔离

给每个智能体分配独立的目录,避免"上下文污染"(比如写代码时意外读取了私人邮件的上下文)。

2. 模型分层 (Model Tiering)

节省 API 成本的有效策略:

  • • 使用轻量级模型(如 GPT-4o-mini)进行任务路由和分类
  • • 将复杂推理留给重型模型(如 Claude 3.5 Sonnet)

3. 安全防范

在 openclaw.json 中设置 "exec.ask": "on"。这将强制智能体在执行任何 Shell 命令或写入文件前,通过聊天窗口向你请求权限。

4. 技能审查

像对待浏览器插件一样对待下载的 Skills。在使用前,先检查其 SKILL.md 的指令,只从信任的来源安装。


推荐 Skills

OpenClaw 的强大之处在于其丰富的 Skills 生态。以下是 ClawHub 上最受欢迎的 Skills [5]:

必备效率类

  • • obsidian - 深度连接 Obsidian 笔记库,实现自动化笔记管理
  • • notion - 集成Notion自有API 
  • • API Gateway - 聚合 100+ 常用 API(Google Workspace, Notion 等)
  • • imap-smtp-email-像真人一样读写邮件,智能处理未读消息

自动化类

  • browser-use - - 专为 AI 智能体优化的无头浏览器自动化工具
  • • slack - Slack 集成
  • • discord - Discord 机器人

AI 能力类

  • • Self-Improving Agent - 具备自我反思与纠错能力的进阶 AI
  • • Nano Banana Pro - 基于 Gemini 3 Pro 的高画质图像生成与编辑
  • •Web Search (Baidu/Exa)- 接入百度或 Exa 神经搜索,获取实时精准信息

安装方式

# 从 ClawHub 安装clawhub install <skill-name># 或在 workspace 中使用openclaw skills install <skill-name>

常用 CLI 命令速查

命令
说明
openclaw gateway run
启动 Gateway
openclaw config
配置菜单
openclaw agents add <name>
添加智能体
openclaw agents list
列出智能体
openclaw skills install <skill>
安装技能
openclaw dashboard
打开控制面板
openclaw gateway restart
重启网关

常见问题

Q: 安装失败怎么办?

A: 确保 Node.js 版本 >= 22。如果在 WSL 中安装遇到问题,可以尝试手动安装依赖。

Q: 如何选择大模型?

A: 根据你的需求:

  • • 追求性价比:选择 MiniMax 或 Qwen
  • • 追求效果:选择 Claude 或 GPT-4
  • • 中文优化:选择 Kimi 或 MiniMax

Q: 技能安全吗?

A: 安装技能前务必查看其源代码和 SKILL.md,只安装来自可信来源的技能。


总结

OpenClaw 为个人用户提供了一个强大、灵活、可扩展的 AI 助手解决方案。无论是日常办公、自动化任务还是 AI 探索,它都能成为你的得力助手。


参考资料

官网:openclaw.ai

GitHub:github.com/openclaw/openclaw

文档:docs.openclaw.ai

ClawHub:clawhub.com