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

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

通过上一篇文章《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: ":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:+" } ]

} }

技能是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 = } };
```
测试技能
在聊天中问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: 私信被要求配对码

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

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成为你专属的数字助手。如果在使用过程中有新的发现或问题，欢迎在评论区分享交流！