OpenClaw 个人AI助手使用教程：从配置到实战

openclaw v2.0使用篇上线

轩辕尧帝贾天下

138人浏览 · 2026-04-20 21:49:36

轩辕尧帝贾天下 · 2026-04-20 21:49:36 发布

一、前言

通过上一篇文章《OpenClaw 个人AI助手完整安装教程》，你已经成功在本地部署了OpenClaw。现在，是时候让它真正为你工作了！

本文将详细介绍OpenClaw的配置和使用方法，包括：

连接各种聊天渠道（WhatsApp、Telegram等）
配置AI模型（Ollama本地模型/OpenAI等）
使用命令行与AI交互
设置语音功能
编写自定义技能

二、基础配置

2.1 配置文件结构

OpenClaw的配置文件位于 ~/.openclaw/openclaw.json，采用JSON5格式（支持注释）。主要结构如下：

{
  // 代理（AI）配置
  agent: {
    model: "ollama/deepseek-r1:14b",  // 默认模型
    thinkingLevel: "medium",           // 思考深度
    verboseLevel: "normal"             // 详细程度
  },
  
  // 聊天渠道配置
  channels: {
    // 各个渠道的配置
  },
  
  // 网关配置
  gateway: {
    port: 18789,
    bind: "127.0.0.1"
  }
}

2.2 配置AI模型

OpenClaw支持多种模型提供商，这里介绍两种常用方式：

方式一：使用本地Ollama（免费，推荐）

确保Ollama已安装并运行

ollama list  # 查看已安装模型
ollama pull deepseek-r1:14b  # 拉取模型（首次使用）

在OpenClaw配置中添加Ollama

nano ~/.openclaw/openclaw.json

添加以下内容：

{
  agent: {
    model: "ollama/deepseek-r1:14b"
  },
  providers: {
    ollama: {
      baseUrl: "http://localhost:11434"  // Ollama默认地址
    }
  }
}

方式二：使用OpenAI（需要API密钥）

获取API密钥：在 OpenAI平台注册并创建密钥

配置OpenAI

{
  agent: {
    model: "gpt-4"
  },
  providers: {
    openai: {
      apiKey: "sk-你的密钥"  // 或使用环境变量 OPENAI_API_KEY
    }
  }
}

2.3 添加聊天渠道

OpenClaw支持数十种聊天渠道，下面以最常用的几个为例：

Telegram配置

在Telegram中创建Bot：搜索 @BotFather，发送 /newbot，按照提示创建，获得Token

在OpenClaw中配置

{
  channels: {
    telegram: {
      botToken: "1234567890:ABCdefGHIjklMNOpqrsTUVwxyz",  // 你的Bot Token
      allowFrom: ["*"],  // 允许所有人使用（谨慎！）
      dmPolicy: "pairing"  // 私信需要配对码验证
    }
  }
}

WhatsApp配置

OpenClaw通过Baileys库实现WhatsApp连接（无需官方API）：

{
  channels: {
    whatsapp: {
      // 无需额外配置，首次运行时会引导扫码登录
      allowFrom: ["*"],
      dmPolicy: "pairing"
    }
  }
}

首次启动WhatsApp渠道时，终端会显示二维码，用WhatsApp扫码即可登录。

Discord配置

在Discord开发者平台创建应用：https://discord.com/developers/applications
获取Bot Token并邀请Bot到服务器

配置OpenClaw

{
  channels: {
    discord: {
      token: "你的Bot Token",
      allowFrom: ["*"],
      dmPolicy: "pairing"
    }
  }
}

三、启动与基本使用

3.1 启动网关

# 进入OpenClaw目录
cd ~/openclaw

# 启动网关（前台运行）
pnpm openclaw gateway --port 18789 --verbose

# 或者使用向导模式（包含安装服务）
pnpm openclaw onboard --install-daemon

网关启动后，访问 http://localhost:18789 可以看到Web控制界面。

3.2 使用命令行与AI对话

打开另一个终端（网关保持运行）：

发送单条消息

pnpm openclaw agent --message "你好，请介绍一下自己"

进入交互式对话

pnpm openclaw agent --interactive

然后就可以连续对话了，输入 exit 退出。

指定思考深度

pnpm openclaw agent --message "帮我写一个Python爬虫" --thinking high

思考深度可选：off、low、medium、high、xhigh

3.3 通过聊天渠道使用

一旦配置好渠道（如Telegram），你就可以直接在对应的聊天软件中与AI对话了：

私聊：直接给Bot发送消息
群聊：需要@Bot或设置群组规则

常用聊天命令：

/status - 查看当前会话状态
/reset - 重置对话历史
/think medium - 设置思考深度
/verbose on - 显示详细输出

四、高级功能

4.1 语音功能（macOS/iOS/Android）

如果你有macOS、iOS或Android设备，可以安装配套应用实现语音交互。

macOS端配置

下载OpenClaw macOS应用（在Releases页面）
打开应用，它会自动发现本地网关
在设置中开启"语音唤醒"，设置唤醒词（如"Hey Claw"）
开启"对话模式"，即可通过语音与AI对话

Android端配置

下载OpenClaw Android APK
打开应用，输入网关地址（如 http://192.168.1.100:18789）
配对后即可使用语音、摄像头、屏幕录制等功能

4.2 实时画布（Canvas）

画布是OpenClaw的特色功能，允许AI生成可视化内容。

在命令行中创建画布：

pnpm openclaw canvas create --title "我的画布"

AI可以通过工具操作画布：

绘制图表
生成思维导图
展示实时数据

4.3 浏览器控制

OpenClaw可以控制浏览器，实现自动化操作：

在配置中启用浏览器工具

{
  browser: {
    enabled: true,
    headless: false,  // 是否显示浏览器窗口
    userDataDir: "~/.openclaw/browser-profile"
  }
}

AI可以执行的操作
- 打开网页
- 截图
- 填写表单
- 点击元素
- 提取数据

4.4 定时任务（Cron）

让AI定期执行任务：

{
  cron: {
    jobs: [
      {
        name: "每日新闻",
        schedule: "0 8 * * *",  // 每天早上8点
        command: "agent --message '给我今天的科技新闻摘要' --send-to telegram:@me"
      },
      {
        name: "天气提醒",
        schedule: "*/30 * * * *",  // 每30分钟
        command: "agent --message '检查天气，如果有雨提醒我' --send-to whatsapp:+1234567890"
      }
    ]
  }
}

五、自定义技能（Skills）

技能是OpenClaw最强大的扩展机制。你可以编写自己的技能，让AI学会新本领。

5.1 技能目录结构

所有技能存放在 ~/.openclaw/workspace/skills/ 目录下，每个技能一个文件夹：

~/.openclaw/workspace/skills/
├── weather/           # 天气技能
│   ├── SKILL.md       # 技能描述（AI会读取）
│   └── index.js       # 技能实现代码
├── calculator/        # 计算器技能
│   ├── SKILL.md
│   └── index.js
└── ...

5.2 编写第一个技能：计算器

创建技能目录

mkdir -p ~/.openclaw/workspace/skills/calculator
cd ~/.openclaw/workspace/skills/calculator

编写技能描述文件 SKILL.md

# 计算器技能

这个技能可以执行基本的数学运算。

## 功能
- 加法：`add(a, b)` 返回两数之和
- 减法：`subtract(a, b)` 返回 a - b
- 乘法：`multiply(a, b)` 返回两数之积
- 除法：`divide(a, b)` 返回 a / b

## 示例
- 用户问："3加5等于多少？" → 应该调用 `add(3, 5)`
- 用户问："10除以2" → 应该调用 `divide(10, 2)`

编写技能实现 index.js

module.exports = {
  // 技能名称
  name: 'calculator',
  
  // 技能描述（简短）
  description: '执行基本数学运算',
  
  // 工具函数（AI可以调用的方法）
  tools: {
    add: (a, b) => a + b,
    subtract: (a, b) => a - b,
    multiply: (a, b) => a * b,
    divide: (a, b) => {
      if (b === 0) throw new Error('除数不能为0');
      return a / b;
    }
  }
};

测试技能
在聊天中问AI："计算 15 乘以 3"，AI应该会调用你的计算器技能并返回45。

5.3 技能调试

查看技能加载日志：

pnpm openclaw logs --follow | grep skill

如果技能有错误，会在日志中显示。

六、常见使用场景

场景1：个人知识库助手

将文档放入工作区，让AI帮你检索：

# 创建工作区目录
mkdir -p ~/.openclaw/workspace/documents
cp ~/我的笔记/*.md ~/.openclaw/workspace/documents/

# 然后问AI："在我的笔记中，关于机器学习的部分有哪些？"

场景2：自动化工作流

结合定时任务和渠道，打造自动化流程：

每天早上8点发送新闻摘要到Telegram
检测到Gmail新邮件时，让AI总结并转发到Slack
每小时检查一次服务器状态，异常时发送告警

场景3：家庭助手

结合Android节点，实现家庭自动化：

"打开客厅的灯"（需要智能家居集成）
"提醒我下午3点开会"（创建系统提醒）
"我在哪里？"（获取手机位置）

七、故障排除

Q1: AI不响应某个渠道的消息

可能原因：渠道未正确配置或未在配置中启用
解决：检查 ~/.openclaw/openclaw.json 中对应渠道的配置，确保 enabled 为 true（或不存在，默认启用）。

Q2: 私信被要求配对码

这是OpenClaw的安全机制，默认陌生人需要配对。
批准用户：

pnpm openclaw pairing approve whatsapp 123456  # 123456是用户收到的配对码

Q3: AI总是调用错误的工具

解决：优化 SKILL.md 的描述，添加更多示例，让AI更清楚何时使用该技能。

Q4: 语音功能不工作

检查麦克风权限
确认语音模型已下载（首次使用会自动下载）
在macOS应用中检查"语音唤醒"是否开启

Q5: 如何查看详细日志

pnpm openclaw logs --follow --level debug

八、总结与进阶

至此，你已经掌握了OpenClaw的基本使用和高级功能。OpenClaw的强大之处在于它的可扩展性——你可以：

编写更多技能，让AI学会新工具
集成更多聊天渠道
通过节点设备扩展物理世界交互
贡献代码到开源项目

学习资源

官方文档：https://docs.openclaw.ai
技能市场：https://clawhub.com
Discord社区：https://discord.gg/clawd

后记：AI助手的真正价值在于与你工作流的深度融合。不要局限于本文的例子，多尝试、多探索，让OpenClaw成为你专属的数字助手。如果在使用过程中有新的发现或问题，欢迎在评论区分享交流！

2048 AI社区

有“AI”的1024 = 2048，欢迎大家加入2048 AI社区

更多推荐

开源 AI 组件的隐性风险

2048 AI社区

AI Agent的竞品分析：从功能对比到战略定位

为了进行有效的竞品分析，我们首先需要明确定义AI Agent解决的问题空间。自主性维度：从完全手动控制到完全自主决策任务复杂度维度：从简单单一任务到复杂多步骤任务环境交互维度：从纯数字环境到物理世界交互时间尺度维度：从即时响应到长期规划与执行协作维度：从单智能体操作到多智能体协作在这一问题空间中，不同的AI Agent产品定位在不同的区域，解决不同类型的问题。理解这些定位差异是竞品分析的关键。