OpenClaw 安装教程:打造你的个人 AI 助手

🦞 EXFOLIATE! EXFOLIATE! 你的私人 AI 助理，任何系统，任何平台，龙虾风格！

📋 什么是 OpenClaw？

OpenClaw 是一款个人 AI 助手，你可以在自己的设备上运行。它的特点：

• • 多平台支持 - WhatsApp、Telegram、Slack、Discord、微信等
• • 🖥️ 本地优先 - 快速、全天候、隐私可控
• • 🎯 多代理路由 - 隔离会话，独立工作空间
• • 🔊 语音唤醒 - macOS/iOS/Android 语音交互
• • 🎨 实时画布 - 可视化工作空间
• • 🔧 技能系统 - 5400+ 技能可扩展

OpenClaw - 你的个人 AI 助手

🚀 快速安装

前置要求

• • Node.js ≥ 22
• • npm/pnpm/bun 任一包管理器

方法一：一键安装（推荐）

安装 OpenClaw：

npm install -g openclaw@latest# 或pnpm add -g openclaw@latest

运行向导：

openclaw onboard --install-daemon

向导会引导你完成：

1. 1. Gateway 守护进程安装
2. 2. 工作空间配置
3. 3. 频道配对
4. 4. 技能安装

方法二：从源码安装

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm ui:buildpnpm buildpnpm openclaw onboard --install-daemon

方法三：Docker 安装

docker compose up -d

详细配置参考 Docker 安装指南^[2]

方法四：Nix 安装（声明式）

# 使用 Nixnix profile install github:openclaw/nix-openclaw

⚙️ 配置指南

1. 启动 Gateway

openclaw gateway --port 18789 --verbose

Gateway 会运行在 ws://127.0.0.1:18789

2. 配置模型

编辑 ~/.openclaw/openclaw.json：

{  "agent": {    "model": "anthropic/claude-opus-4-6"  }}

支持的模型提供商：

• • OpenAI (GPT-4.5/4o/o3)
• • Anthropic (Claude 4/3.7/3.5)
• • Google (Gemini 2.5/2.0)
• • 以及更多...

3. 配置环境变量

# OpenAIexport OPENAI_API_KEY="your-key"# Anthropicexport ANTHROPIC_API_KEY="your-key"# Googleexport GEMINI_API_KEY="your-key"

📱 连接频道

Telegram

# 设置机器人 Tokenexport TELEGRAM_BOT_TOKEN="123456:ABCDEF"# 或使用配置文件openclaw channels login telegram

Discord

export DISCORD_BOT_TOKEN="your-bot-token"openclaw channels login discord

WhatsApp

openclaw channels login whatsapp# 扫描 QR 码配对

Slack

export SLACK_BOT_TOKEN="xoxb-..."export SLACK_APP_TOKEN="xapp-..."openclaw channels login slack

微信/飞书

通过 WebChat 或 Matrix 桥接实现微信接入

🎯 使用示例

发送消息

# 发送消息openclaw message send \  --to "+1234567890" \  --message "Hello from OpenClaw"

与 AI 对话

# 简单对话openclaw agent --message "今天的待办清单"# 深度思考模式openclaw agent --message "项目规划" --thinking high

聊天命令

在聊天中发送：

🔧 进阶配置

开发频道选择

# 切换到 beta 频道openclaw update --channel beta# 切换到 dev 频道openclaw update --channel dev

频道说明：

• • stable - 稳定版（最新 Tag）
• • beta - 测试版
• • dev - 开发版（main 分支）

安全检查

# 检查配置openclaw doctor

安全配置

{  "agents": {    "defaults": {      "sandbox": {        "mode": "non-main"      }    }  }}

安全说明：

• • 默认工具在主机运行
• • 非主会话可启用 Docker 沙箱
• • 群聊需要 DM 配对策略

📚 架构概览

WhatsApp/Telegram/Slack/Discord/微信               │               ▼┌───────────────────────────────┐│            Gateway            ││       (控制平面)                ││     ws://127.0.0.1:18789      │└──────────────┬────────────────               │               ├─ Pi Agent (RPC)               ├─ CLI 命令               ├─ WebChat UI               ├─ macOS 应用               └─ iOS/Android 节点

🌟 核心特性

Gateway 网关

• • WebSocket 控制平面
• • 会话管理
• • 工具集成
• • Web 界面

多频道支持

• • 即时通讯：WhatsApp, Telegram, Signal
• • 团队协作：Slack, Discord, Teams
• • 社交平台：Matrix, Nostr, IRC
• • 语音通话：macOS/iOS/Android

工具系统

• • 浏览器控制 - 自动化网页操作
• • 画布渲染 - 可视化工作区
• • 技能市场 - 5400+ 技能
• • 定时任务 - Cron 自动化

📱 配套应用

macOS 应用（可选）

• • 菜单栏控制
• • 语音唤醒
• • 画布显示
• • 远程网关

iOS 节点（可选）

• • 语音触发
• • 画布显示
• • 设备配对

Android 节点（可选）

• • 语音对话
• • 屏幕录制
• • 设备控制

❓ 常见问题

Q: 安装后找不到命令？

A: 确保 Node.js ≥ 22，检查 npm global bin 路径

Q: 如何更新？

A: openclaw update 或 npm update -g openclaw

Q: Gateway 无法启动？

A: 运行 openclaw doctor 检查配置

Q: 如何切换模型？

A: 修改 ~/.openclaw/openclaw.json 中的 agent.model

Q: 支持中文吗？

A: 完全支持，包括中文语音识别

🔗 参考资源

💬 学习交流

如果你在安装或使用过程中遇到问题，想要：

• • 📖 系统学习 OpenClaw 配置与开发
• • 💬 深入沟通 AI 助手最佳实践
• • 🚀 协助部署 企业级私人 AI 方案

欢迎添加微信交流！

扫一扫，获取：

• • ✅ 一对一安装指导
• • ✅ 配置问题解答
• • ✅ 技能开发分享
• • ✅ 企业部署方案

觉得本教程有帮助？欢迎分享给更多开发者！ 🦞

引用链接

[1] : https://openclaw.ai[2] Docker 安装指南: https://docs.openclaw.ai/install/docker[3] docs.openclaw.ai: https://docs.openclaw.ai[4] github.com/openclaw/openclaw: https://github.com/openclaw/openclaw[5] discord.gg/clawd: https://discord.gg/clawd[6] clawhub.com: https://clawhub.com[7] Wizard: https://docs.openclaw.ai/start/wizard