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