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配置中添加Ollamanano ~/.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、xhigh3.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.jsmodule.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 乘以 3AI应该会调用你的计算器技能并返回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.comDiscord社区https://discord.gg/clawd后记AI助手的真正价值在于与你工作流的深度融合。不要局限于本文的例子多尝试、多探索让OpenClaw成为你专属的数字助手。如果在使用过程中有新的发现或问题欢迎在评论区分享交流