乐于分享
好东西不私藏

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

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

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


📋 什么是 OpenClaw?

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

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

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

聊天命令

在聊天中发送:

命令
功能
/status
查看会话状态
/new
 或 /reset
重置会话
/compact
压缩上下文
/think <level>
设置思考级别
`/verbose on
off`
`/usage off
tokens

🔧 进阶配置

开发频道选择

# 切换到 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[1]
文档中心
docs.openclaw.ai[3]
GitHub 仓库
github.com/openclaw/openclaw[4]
Discord 社区
discord.gg/clawd[5]
技能市场
clawhub.com[6]
入门向导
Wizard[7]

💬 学习交流

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

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

欢迎添加微信交流!

加微信二维码

扫一扫,获取:

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

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

引用链接

[1] ![OpenClaw](https://raw.githubusercontent.com/openclaw/openclaw/main/docs/assets/openclaw-logo-text.png): 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