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 的指令，只从信任的来源安装。

常用 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