OpenClaw 安装与使用完全指南：打造你的个人 AI 助手

什么是 OpenClaw？

OpenClaw 是一个开源的个人 AI 助手，可以在你自己的设备上运行。它支持多种通信渠道，包括 WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、Microsoft Teams、WebChat 等，让你能在熟悉的聊天平台上与 AI 助手互动。

核心特点

• 本地优先：Gateway 完全运行在你的设备上，保护隐私
• 多渠道支持：支持 12+ 种消息平台
• 多模型兼容：支持 Claude、GPT、Ollama 本地模型等
• 语音交互：macOS/iOS/Android 支持语音唤醒和对话
• 浏览器控制：内置 Chrome/Chromium 浏览器自动化
• 配套应用：macOS 菜单栏应用 + iOS/Android 节点

系统要求

• Node.js: 版本 22 或更高
• 包管理器: npm / pnpm / bun
• 操作系统: macOS / Linux / Windows (推荐 WSL2)

安装方法

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

# 使用 npm
npm install -g openclaw@latest

# 或使用 pnpm
pnpm add -g openclaw@latest

方法二：一键脚本安装

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

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

方法三：Docker 安装

docker run -d --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  -p 18789:18789 \
  openclaw/openclaw:latest

方法四：从源码构建（开发者）

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

pnpm install
pnpm ui:build
pnpm build
pnpm link --global openclaw

初始化配置

安装完成后，运行引导向导进行初始化：

openclaw onboard --install-daemon

引导向导会帮助你：

1. 选择 Agent 身份
2. 选择主要模型（Claude、GPT、Ollama 等）
3. 设置工作目录
4. 安装 Daemon 服务（自动启动）
5. 配置初始技能

启动 Gateway

openclaw gateway --port 18789 --verbose

Gateway 是 OpenClaw 的控制中心，所有通信都通过它来协调。

基本使用

发送消息

openclaw message send --to +1234567890 --message "Hello from OpenClaw"

与 AI 助手对话

openclaw agent --message "帮我写一个 Python 脚本" --thinking high

配置文件示例

创建 ~/.openclaw/openclaw.json：

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

Telegram 配置

{
  "channels": {
    "telegram": {
      "botToken": "123456:ABCDEF"
    }
  }
}

Discord 配置

{
  "channels": {
    "discord": {
      "token": "1234abcd"
    }
  }
}

聊天命令

在支持的聊天平台中，可以使用以下命令：

安全机制

OpenClaw 默认开启 DM 配对机制：

• 陌生发送者会收到配对码
• 管理员使用 openclaw pairing approve <channel> <code> 批准
• 防止未授权访问

运行 openclaw doctor 检查安全配置。

架构图

WhatsApp / Telegram / Slack / Discord / Signal / iMessage ...
               │
               ▼
┌───────────────────────────────┐
│            Gateway            │
│       (控制中心)               │
│     ws://127.0.0.1:18789      │
└──────────────┬────────────────┘
               │
               ├─ CLI (openclaw …)
               ├─ WebChat UI
               ├─ macOS app
               └─ iOS / Android nodes

常见问题

Q: 推荐什么模型？

推荐 Anthropic Pro/Max + Opus 4.6，长上下文能力强，抗提示注入能力更好。

Q: Windows 用户怎么办？

推荐使用 WSL2 运行 OpenClaw。

Q: 如何远程访问 Gateway？

可以通过 Tailscale Serve/Funnel 或 SSH 隧道实现远程访问。

相关链接

• GitHub 仓库: https://github.com/openclaw/openclaw
• 官方网站: https://openclaw.ai
• Discord 社区: 加入讨论

总结

OpenClaw 是一个功能强大的个人 AI 助手平台，通过本地运行保护你的隐私，同时支持多种通信渠道让你随时随地与 AI 互动。无论你是想提升工作效率，还是探索 AI 助手的可能性，OpenClaw 都是一个值得尝试的开源项目。