OpenClaw使用教程：打造你的个人AI助手

OpenClaw 使用教程：打造你的个人AI助手

什么是OpenClaw？

OpenClaw是一个你可以在自己的设备上运行的个人AI助手。它能够通过你已经在使用的各种通信渠道回复消息，包括WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage等。它还可以在macOS/iOS/Android上进行语音交互，并渲染一个你可以控制的实时画布界面。

OpenClaw的主要特点：

  • 支持多种通信平台
  • 在你的设备上本地运行
  • 响应速度快
  • 总是在线
  • 支持语音唤醒和对话模式

安装前准备

在开始安装OpenClaw之前，你需要确保满足以下要求：

1. 操作系统: 支持macOS、Linux、Windows (通过WSL2)
2. Node.js: 版本必须≥22
3. 包管理器: npm、pnpm 或 bun
4. 网络连接: 用于下载依赖和配置通信渠道

安装步骤

1. 安装Node.js (如果尚未安装)

首先，检查你的Node.js版本：

bash
node --version

如果你没有安装Node.js或版本低于22，请从nodejs.org下载并安装最新版本。

2. 全局安装OpenClaw

推荐使用npm或pnpm进行全局安装：

bash

使用npm

npm install -g openclaw@latest

或者使用pnpm

pnpm add -g openclaw@latest

3. 运行设置向导

OpenClaw提供了引导设置工具，强烈推荐使用：

bash
openclaw onboard --install-daemon

这个命令会：

  • 创建必要的配置文件
  • 设置工作区
  • 安装为守护进程（在后台自动运行）

4. 启动网关

安装完成后，启动OpenClaw网关：

bash
openclaw gateway --port 18789 --verbose

基本配置

配置模型

OpenClaw支持多种AI模型，推荐使用Anthropic Claude Pro/Max或OpenAI GPT系列。在 ~/.openclaw/openclaw.json 中配置：

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

配置通信渠道

根据你想要使用的通信平台进行相应配置：

#### WhatsApp配置

1. 使用Baileys协议连接WhatsApp Web：

bash
openclaw channels login

这将显示二维码，用手机扫描即可完成连接。

2. 配置允许列表（可选但推荐）：

json
{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+1234567890", "+0987654321"]
    }
  }
}

#### Telegram配置

1. 创建机器人并获取令牌
2. 在配置文件中添加：

json
{
  "channels": {
    "telegram": {
      "botToken": "YOUR_TELEGRAM_BOT_TOKEN"
    }
  }
}

#### Discord配置

1. 创建Discord应用并获取机器人令牌
2. 在配置文件中添加：

json
{
  "channels": {
    "discord": {
      "token": "YOUR_DISCORD_BOT_TOKEN"
    }
  }
}

日常使用

发送测试消息

安装完成后，可以发送一条测试消息验证设置：

bash
openclaw message send --target +1234567890 --message "Hello from OpenClaw"

与助手对话

直接与助手交互：

bash
openclaw agent --message "帮我写一份购物清单" --thinking high

控制面板

访问浏览器控制面板查看和管理你的助手：

高级功能

语音功能

在支持的平台上启用语音唤醒和对话模式：

  • macOS: 通过菜单栏应用
  • iOS/Android: 作为节点配对

画布功能

OpenClaw提供实时画布功能，允许助手创建和控制视觉界面。

自动化任务

使用cron功能设置定时任务：

bash

添加定时任务

openclaw cron add --schedule "every 30m" --payload '{"kind":"systemEvent","text":"Check for updates"}'

技能系统

OpenClaw支持技能扩展，可以通过安装预定义技能来增强功能：

bash

列出可用技能

openclaw skills list

安全配置

DM安全策略

默认情况下，未知发送者需要配对码才能与助手交互。你可以通过以下方式配置：

json
{
  "channels": {
    "telegram": {
      "dm": {
        "policy": "pairing"  // 或 "open"
      }
    }
  }
}

允许列表

为保护隐私，建议设置允许列表：

json
{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+1234567890"]
    }
  }
}

故障排除

检查状态

bash
openclaw doctor

查看日志

bash
openclaw gateway --verbose

重启服务

bash
openclaw gateway restart

命令行快捷方式

常用命令：

  • /status – 显示会话状态
  • /new 或 /reset – 重置会话
  • /think – 设置思考级别
  • /verbose on|off – 切换详细输出
  • /usage – 显示使用情况

结语

OpenClaw是一个强大的个人AI助手平台，允许你在自己的设备上运行私有、安全的AI服务。通过本教程，你应该已经成功安装并配置了基本功能。

记住始终保护好你的API密钥和配置文件，只允许信任的联系人访问你的助手。随着你对系统的熟悉，可以探索更多高级功能，如技能开发、自动化任务和多代理路由。

Happy Clawning! 🦞