快速开始

快速开始

本指南将帮助您快速启动并运行 OpenClaw。

前置条件

在开始之前，请确保您已经：

  • 安装了 Node.js（版本 22 或更高）
  • 完成了 安装指南 中的步骤
  • 拥有至少一个 AI 提供商的 API 密钥（Anthropic、OpenAI 等）

启动网关

网关是 OpenClaw 的核心控制平面。要启动它：

npx claw gateway

这将启动网关服务器，默认监听 ws://localhost:3000。

首次运行

首次启动网关时，系统会提示您：

  1. 选择您的 AI 提供商（Anthropic、OpenAI、Google 等）
  2. 输入您的 API 密钥
  3. 配置基本设置

配置将保存到 ~/.config/openclaw/config.json5。

发送您的第一条消息

网关运行后，您可以使用 CLI 发送消息：

npx claw send "你好！你能做什么？"

代理将处理您的消息并返回响应。

交互式聊天

要进行持续对话，请使用交互式聊天模式：

npx claw chat

这将打开一个交互式会话，您可以：

  • 输入消息并获得响应
  • 使用 /help 查看可用命令
  • 使用 /exit 或按 Ctrl+C 退出

聊天命令

在聊天模式下，您可以使用以下命令：

  • /help - 显示可用命令
  • /clear - 清除对话历史
  • /save <文件名> - 保存对话
  • /load <文件名> - 加载对话
  • /exit - 退出聊天

连接通信渠道

OpenClaw 支持 20 多个通信渠道。要连接一个渠道：

WhatsApp 示例

npx claw channel add whatsapp

按照提示操作：

  1. 扫描二维码
  2. 等待连接确认
  3. 开始通过 WhatsApp 与您的代理聊天

Telegram 示例

npx claw channel add telegram

您需要：

  1. 从 @BotFather 获取机器人令牌
  2. 输入令牌
  3. 开始与您的机器人聊天

查看已连接的渠道

npx claw channel list

使用命令

OpenClaw 提供了几个有用的 CLI 命令：

检查状态

npx claw status

显示：

  • 网关状态（运行中/已停止）
  • 已连接的渠道
  • 活动会话
  • 系统健康状况

查看日志

npx claw logs

实时查看网关日志。使用 --follow 持续跟踪：

npx claw logs --follow

管理会话

列出活动会话：

npx claw session list

查看特定会话：

npx claw session view <会话ID>

安装技能

技能扩展了您的代理的能力。从 ClawHub 安装技能：

npx claw skill install weather

这将从 ClawHub 安装天气技能。

列出已安装的技能

npx claw skill list

创建自定义技能

创建一个新技能：

npx claw skill create my-skill

这将创建一个包含 SKILL.md 文件的技能模板。编辑该文件以定义您的技能：

---
name: my-skill
description: 我的自定义技能
version: 1.0.0
---

# 技能说明

这个技能可以...

## 使用方法

用户可以通过以下方式使用此技能...

配置您的代理

通过编辑配置文件自定义您的代理：

npx claw config edit

这将在您的默认编辑器中打开 ~/.config/openclaw/config.json5。

关键配置选项

{
  // AI 提供商设置
  provider: "anthropic",
  model: "claude-opus-4",

  // 代理行为
  agent: {
    name: "我的助手",
    personality: "友好且乐于助人",
    language: "zh-CN"
  },

  // 渠道设置
  channels: {
    whatsapp: {
      enabled: true,
      autoReply: true
    }
  }
}

配置更改会自动重新加载 - 无需重启网关。

安全配对

对于生产使用，启用安全配对以保护您的网关：

npx claw gateway --secure

这将：

  1. 生成配对码
  2. 要求客户端在连接前进行身份验证
  3. 加密所有通信

要连接到安全网关：

npx claw pair <配对码>

下一步

现在您已经启动并运行了，探索更多功能：

故障排除

网关无法启动

如果网关无法启动：

  1. 检查端口 3000 是否已被占用：

    lsof -i :3000

  2. 使用不同的端口：

    npx claw gateway --port 3001

  3. 检查日志中的错误：

    npx claw logs

连接问题

如果无法连接到网关：

  1. 验证网关正在运行：

    npx claw status

  2. 检查防火墙设置

  3. 确保使用正确的 WebSocket URL

API 密钥错误

如果遇到 API 密钥错误：

  1. 验证您的密钥：

    npx claw config get provider.apiKey

  2. 更新您的密钥：

    npx claw config set provider.apiKey "your-key"

获取帮助

需要帮助？