2026年📖 OpenClaw 完整使用指南

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

📖 OpenClaw 完整使用指南
版本：OpenClaw 2026.2.x | 作者：jason |
OpenClaw 是一个自托管的 AI 助手网关，把 AI 模型（Claude、GPT、DeepSeek 等）接入到飞书、微信、Telegram、Discord 等聊天工具，让你随时随地和 AI 对话并执行复杂任务。

一、核心概念
OpenClaw 是什么？
一句话：在你的服务器上跑一个 Gateway（网关）进程，它负责接收消息 → 调用 AI 模型 → 返回结果，同时管理 AI 的记忆、工具、定时任务。
核心组件： Gateway：主进程，负责消息路由和 AI 调度 Agent：AI 实体，有独立的工作区、记忆、人格设置 Channel：聊天频道（飞书/Telegram/Discord 等） Skills：AI 能调用的专项技能（天气、交易、文档写入等） Cron：定时任务调度器
工作流程
用户发消息 → Channel 插件接收 → Gateway 路由 → Agent 处理（调用工具/写文件/执行代码）→ 返回结果到聊天
文件结构
/.openclaw/openclaw.json 核心配置文件（API Key、Channel 配置、模型设置）

/.openclaw/workspace/ Agent 工作区（AI 的“家”）

AGENTS.md Agent 行为规则

SOUL.md Agent 人格定义

USER.md 用户信息

MEMORY.md 长期记忆

memory/YYYY-MM-DD.md 每日日记

skills/ 自定义技能

~/.openclaw/agents/main/ Agent 状态目录（会话、认证）

二、安装与启动
系统要求
操作系统：Linux（推荐 Ubuntu 22.04）、macOS、Windows Node.js：v22+（必须）内存：最低 512MB，推荐 1GB+ 网络：需要能访问 AI API（Anthropic/OpenAI 等）
安装步骤
第一步：安装 Node.js 22 curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash - sudo apt-get install -y nodejs
第二步：安装 pnpm npm install -g pnpm
第三步：安装 OpenClaw pnpm install -g openclaw
第四步：初始化配置 openclaw setup
第五步：运行配置向导（推荐新手） openclaw onboard
启动与停止
启动 Gateway（后台运行） openclaw gateway start
停止 Gateway openclaw gateway stop
重启 openclaw gateway restart
查看状态 openclaw gateway status openclaw status
查看日志 openclaw gateway logs openclaw gateway logs –follow （实时跟踪）
配置 API 密钥
编辑 ~/.openclaw/openclaw.json，在 providers 中配置：
支持的 AI 提供商：Anthropic（Claude）、OpenAI（GPT）、DeepSeek、OpenRouter、Google Gemini 等
示例配置结构： providers.anthropic.apiKey = “sk-ant-…” providers.openai.apiKey = “sk-…”
默认模型： openclaw models set anthropic/claude-opus-4-6 openclaw models list （查看所有可用模型） openclaw models status （查看当前配置）

三、接入聊天频道
飞书（Feishu/Lark）配置

在飞书开放平台（http://open.feishu.cn）创建企业自建应用
开启机器人能力，获取 App ID 和 App Secret
配置 Webhook 地址（openclaw gateway 会提供）
在 openclaw.json 中配置： channels.feishu.appId = “cli_xxx” channels.feishu.appSecret = “xxx” channels.feishu.verificationToken = “xxx”

Telegram 配置

找 @BotFather 创建 Bot，获取 Token
在 openclaw.json 配置： channels.telegram.botToken = “xxx”

Discord 配置

在 Discord Developer Portal 创建应用
创建 Bot，获取 Token
配置必要的 Bot 权限（Message Content Intent 必须开启）
在 openclaw.json 配置： channels.discord.botToken = “xxx”

其他支持的频道
WhatsApp、Signal、iMessage（需 macOS）、Slack、Google Chat、Matrix、IRC 等 20+ 种平台

四、Agent 人格与记忆配置

核心配置文件
AGENTS.md：定义 Agent 的行为规则、工作流程、工具使用规范 SOUL.md：定义 Agent 的性格、语气、价值观（决定“感觉像谁”） USER.md：记录用户信息（姓名、时区、偏好），让 AI 更了解你 MEMORY.md：长期记忆，重要信息在这里沉淀（仅在私聊主会话中加载） memory/YYYY-MM-DD.md：每日日记，自动记录当天发生的事

记忆工作原理
短期：会话上下文（聊天历史），超长时自动压缩中期：每日日志文件（memory/2026-03-07.md）长期：MEMORY.md（手动或自动整理）
让 AI 记住某事：直接说“帮我记住xxx”，AI 会写入对应文件

多 Agent 配置
可以在同一个 Gateway 上运行多个独立 Agent，每个有自己的工作区、记忆和人格：
openclaw agent add （添加新 Agent） openclaw agents list （查看所有 Agent）

五、定时任务（Cron）
基本用法
添加定时任务（每天早上9点执行）： openclaw cron add –schedule “0 1 * * *” –isolated “执行某个任务的提示词”
添加一次性提醒（30分钟后）： openclaw cron add –at “+30m” “提醒我喝水”
查看所有定时任务： openclaw cron list
删除定时任务： openclaw cron remove
编辑定时任务： openclaw cron edit –schedule “0 9 * * 1-5”
关键参数
–isolated：在隔离会话中运行（不共享主会话上下文，适合定期任务） –announce：任务完成后通知主会话 –channel feishu：指定通知发到哪个频道 –to “user:open_id”：指定通知接收人
Cron 表达式格式
分时日月周 0 9 * * * 每天9点 0 9 * * 1 每周一9点 */30 * * * * 每30分钟 0 9,18 * * * 每天9点和18点
心跳机制（Heartbeat）
在 HEARTBEAT.md 中写入需要定期检查的任务，Gateway 会周期性触发 Agent 执行这些检查。适合轻量级的定期巡检，比定时任务更节省资源。

六、Skills 技能系统
Skill 是 AI 的专项能力模块，每个 Skill 有一个 SKILL.md，告诉 AI 何时调用及使用方法。
常用 Skill： weather：查天气 summarize：总结 URL/文档/视频 github：操作 GitHub Issue/PR feishu-doc/feishu-wiki：读写飞书文档
安装命令： openclaw clawhub search weather openclaw clawhub install weather openclaw skills list
自定义 Skill：在 workspace/skills/my-skill/SKILL.md 中写触发条件和使用说明，AI 自动发现并调用。

七、CLI 命令速查
Gateway 管理： openclaw gateway start/stop/restart/status/logs
会话与状态： openclaw sessions list openclaw status
模型管理： openclaw models list openclaw models status openclaw models set <模型名> openclaw models scan（扫描可用模型）
定时任务： openclaw cron list/add/remove/edit openclaw cron logs
诊断： openclaw doctor（检查配置） openclaw health（健康检查） openclaw models status –probe（测试 API 连通性）

八、常见问题
AI 不回复：运行 openclaw gateway logs 查错，再跑 openclaw doctor 诊断。
API 报错：openclaw models status –probe 测试密钥是否有效。
定时任务不触发：确认 Gateway 在运行（任务依赖 Gateway），查 openclaw cron logs 。
迁移服务器：打包 tar czf backup.tar.gz ~/.openclaw/，新机器安装 OpenClaw 后解压恢复。

九、进阶功能
Subagent（子 Agent）：AI 可自动派出子 Agent 并行处理复杂任务，完成后汇报结果。
Browser 自动化：Ubuntu 22.04 上安装 playwright + chromium 即可实现服务端浏览器控制。
Browser Relay：在本地 Chrome 装插件，让服务器控制本地浏览器，适合需要登录验证的网站（小红书、知乎）。
多频道：同一 Gateway 可同时对接飞书、Telegram、Discord 等，AI 自动识别来源频道并回复。
安全建议：API Key 只写 openclaw.json，服务器配防火墙，定期 openclaw doctor 检查。

2026年📖 OpenClaw 完整使用指南

相关推荐