🦞 开源 AI 代理框架
OpenClaw 是什么？
一个运行在你自己服务器/电脑上的 AI 自动化助手，可以通过 微信、Telegram、WhatsApp、Discord 等聊天 App 控制它帮你干活。
🧠 核心能力一览
OpenClaw = 你的 AI 员工，24小时在线，配置好就自动运转
接入多种聊天应用
Telegram、WhatsApp、Discord、Signal、iMessage 都可以作为控制入口
支持多种 AI 模型
Claude、GPT、Gemini、DeepSeek、本地 Ollama 均可接入
定时自动执行
你睡觉时它也能按计划执行任务，不需要你手动触发
可扩展技能（Skill）
社区提供大量 SKILL.md 模板，一键赋予 AI 新能力
本地存储记忆
所有对话记忆存在你自己机器的 Markdown 文件里，完全私有
网页控制面板
就是你现在看到的这个界面，可以管理所有配置和状态
🗺️ 整体结构速览
左侧导航对应的模块关系
| 模块 | 比喻 | 核心用途 |
|---|---|---|
| 控制 → 概览 | 仪表盘 | 看系统状态，确认网关是否在线 |
| 控制 → 频道 | 插线板 | 把聊天 App（Telegram等）连进来 |
| 代理 | 员工档案 | 配置 AI 的人设、权限、使用什么模型 |
| 技能 | 工具箱 | 给 AI 扩展新能力 |
| 设置 → 配置 | 系统设置 | 改 API Key、模型等底层配置 |
| 定时任务 | 闹钟 | 让 AI 定时自动做事 |
🔑 必读
配置 API Key
OpenClaw 本身不提供 AI 能力，它是一个框架。你必须配置至少一个大模型提供商的 API Key，它才能正常工作。
📋 支持的模型提供商
选一个你有账号的即可，新手推荐 Anthropic（Claude）或 OpenAI
🟠 Anthropic (Claude)
🟢 OpenAI (GPT)
🔵 Google (Gemini)
🟣 OpenRouter（多合一）
🟡 DeepSeek
⚪ Ollama（本地免费）
💡
推荐新手用 OpenRouter：一个 Key 可以访问几乎所有模型，不用每家都注册。注册地址：openrouter.ai
🛠️ 方法一：编辑 .env 文件（最简单）
适合新手，直接编辑配置文件
1
找到配置文件位置
文件在你运行 OpenClaw 的机器上，路径为
~/.openclaw/.env（Linux/Mac）或 C:\Users\你的名字\.openclaw\.env（Windows）2
用文本编辑器打开，填入你的 Key
# Anthropic (Claude)
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxx
# OpenAI (GPT)
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxx
# Google (Gemini)
GOOGLE_API_KEY=AIxxxxxxxxxxxxxxxxxx
# OpenRouter（推荐，一个key访问所有模型）
OPENROUTER_API_KEY=sk-or-xxxxxxxxxxxxxxxxxx3
保存文件，重启 OpenClaw
重启后 Key 生效。在概览页看到状态为"正常"即成功。
⚠️
安全提示：不要把 .env 文件上传到 GitHub！里面是你的私钥，泄露会被盗刷费用。
🖥️ 方法二：通过控制面板（Dashboard）配置
在网页界面里直接编辑配置文件
1
打开左侧导航 → 设置 → 配置
进入配置页面，里面有一个 JSON 编辑器
2
在 models.providers 字段填入 Key
{
"models": {
"providers": {
"anthropic": {
"apiKey": "sk-ant-你的key"
},
"openai": {
"apiKey": "sk-你的key"
}
}
}
}3
点击右上角 Save → Apply
保存后配置立即生效
💻 方法三：命令行一键配置
最快的方式，适合熟悉终端操作的用户
# 运行引导向导（会一步一步问你填什么）
openclaw onboard
# 或者直接指定 provider 和 key
openclaw onboard --auth-choice apiKey --token-provider anthropic --token "sk-ant-你的key"📊 控制 → 概览
概览页面详解
系统的总健康仪表盘，可以快速判断 OpenClaw 是否在正常运行。
🌐 网关访问区域
仪表板连接的位置及其身份验证方式
| 字段 | 含义 | 示例值 |
|---|---|---|
| WebSocket URL | 控制面板连接 OpenClaw 后端的地址。本地部署显示 127.0.0.1，远程服务器会显示公网IP | ws://127.0.0.1:18789 |
| 网关令牌 | 访问密码（Token），防止他人连接你的网关 | ••••• （隐藏显示） |
| 密码 | 系统级共享密码，一般留空 | system or shared password |
| 默认会话密钥 | 指定默认使用哪个 AI 代理 | agent:main:main |
| 语言 | 界面显示语言 | 简体中文 |
💡
点击 连接 按钮才会让修改后的配置生效。改完记得点。
📸 快照区域
最新的网关握手信息，实时反映系统状态
状态
正常 = 一切运行良好
如果显示红色/异常，说明网关可能崩了，需重启服务
如果显示红色/异常，说明网关可能崩了，需重启服务
运行时间
服务已连续运行多久。越长说明越稳定，重启后会清零
刻度间隔
系统心跳检测的频率，默认 30s 检查一次存活状态
最后频道刷新
上次与 Telegram/WhatsApp 等频道同步的时间。"just now" = 正常
⚠️
如果"最后频道刷新"显示很久以前，说明消息可能推送有延迟，检查频道连接是否正常。
📡 控制 → 频道
频道（Channels）
把各种聊天 App 接入 OpenClaw，频道就是你和 AI 之间的"传话筒"。
🔌 支持的频道类型
每种频道对应一种接入方式
Telegram
最稳定的接入方式，注册 Bot 获得 Token 后粘贴进来即可
WhatsApp
扫描二维码绑定手机号，之后直接发消息给 AI
Discord
创建 Bot 并邀请到服务器，可以在服务器频道里和 AI 交互
Signal
强加密通信，注重隐私保护时使用
iMessage
仅限 Mac 设备，可通过 Apple 短信生态接入
➕ 如何添加 Telegram 频道（举例）
最推荐新手的接入方式
1
在 Telegram 搜索 @BotFather
发送 /newbot 创建机器人，BotFather 会给你一串 Token（格式如 123456:ABCdef...）
2
在频道页面点"添加频道"选 Telegram
把 Token 粘贴进去，填写频道名称
3
点击连接/保存
成功后在 Telegram 找到你的 Bot 发消息，AI 就会回复了
⚡ 控制 → 实例
实例（Instances）
显示当前所有"活跃连接"的来源，帮助你了解有哪些设备或客户端正在连接你的 OpenClaw。
📡 已连接实例
来自网关和客户端的存在信标（Presence Beacon）
ℹ️
存在信标是技术术语，简单说就是"心跳包"——每个连接的客户端会定期发信号证明自己还在线，这里列出所有发过信号的连接。
网关实例
OpenClaw 服务本身的连接，每次启动会生成一个
客户端实例
打开了控制面板网页的浏览器窗口，每个标签页算一个
这个页面主要用于诊断：如果你的命令没被响应，来这里看看服务是否还在线。
💬 控制 → 会话
会话（Sessions）
统计和管理所有历史对话记录，类似聊天记录的管理中心。
📂 会话页面功能
每一次与 AI 的对话都会生成一条会话记录
查看历史对话
可以翻看过去和 AI 聊过什么内容
清理会话
删除不需要的历史记录，释放存储空间
按频道过滤
可以筛选某个频道（如 Telegram）的对话记录
💡
OpenClaw 的记忆默认存在本地 Markdown 文件，这里是它的可视化界面。
📈 控制 → 使用情况
使用情况（Usage）
实时监控 Token 消耗，帮你控制 API 花费。
💰 什么是 Token？
理解 Token 才能读懂这个页面
ℹ️
Token 是 AI 模型计费的基本单位，大约 1 个 Token = 0.75 个英文单词，或 0.5 个汉字。你调用 AI 的每次对话，都会消耗输入 Token（你说的）和输出 Token（AI 回的），API 按 Token 数量收费。
输入 Token
你发给 AI 的内容（问题+历史消息）消耗的 Token
输出 Token
AI 回复你的内容消耗的 Token，通常比输入贵
用量图表
按时间展示消耗趋势，方便发现异常消耗
⏰ 控制 → 定时任务
定时任务（Scheduled Tasks）
让 AI 定时自动执行任务，无需你手动触发。比如：每天早上 8 点汇报天气、每周一发摘要报告。
➕ 新建定时任务
操作步骤
1
点击"新建任务"按钮
在定时任务页面右上角找到添加按钮
2
填写任务名称和触发时间
时间使用 Cron 格式，例如
0 8 * * * 表示每天早上 8:003
填写要 AI 执行的任务指令
比如"发送今日天气预报到 Telegram"
4
保存任务
任务会在设定时间自动触发，可以随时编辑或删除
💡
不懂 Cron 格式？可以在 crontab.guru 网站上用图形界面生成时间表达式。
🤖 代理模块
代理（Agents）
代理是 OpenClaw 的"AI员工"，每个代理有自己的人设（SOUL.md）、权限和使用的模型。你可以有多个代理，分别做不同的事。
📁 代理子菜单说明
代理模块包含多个子页面
| 子菜单 | 功能 |
|---|---|
| 概述 | 显示代理的工作区路径（文件存在哪里）和身份元数据（名字、描述等） |
| 文件 | 代理的记忆文件、配置文件浏览器，可以直接查看/编辑代理的 Markdown 记忆 |
| 工具 | 该代理可以使用的工具列表（如搜索、读写文件、发邮件等） |
| 技能 | 该代理已加载的技能（Skill）列表 |
| 频道 | 该代理绑定的聊天频道，决定在哪个 App 里和它对话 |
| 定时任务 | 属于该代理的定时任务 |
🧬 SOUL.md 是什么？
代理的灵魂配置文件
ℹ️
每个代理都有一个 SOUL.md 文件，这是它的"系统提示词"，决定了 AI 的名字、性格、职责范围、使用规则等。修改 SOUL.md 就是在给 AI 换"人设"。
# SOUL.md 示例
name: 小助手
description: 一个帮助处理日常工作的 AI 助手
你是一个专业的工作助理，负责：
- 每天早上汇报待办事项
- 回答用户的技术问题
- 管理日程安排
请用简洁、专业的语气回复。⚙️ 代理 → 技能
技能（Skills）
技能是给 AI 扩展能力的插件，每个 SKILL.md 文件定义一种特定能力。就像给员工报了一门培训课。
📦 技能列表
系统当前已安装的所有技能
ℹ️
这里显示的是 OpenClaw 目前拥有的所有 SKILL.md 文件。每个技能有名称、描述和触发条件。AI 在接到任务时，会自动判断要不要调用某个技能。
Web 搜索技能
让 AI 可以实时搜索互联网信息
文档处理技能
读写 Word、PDF、Excel 等文件
日历技能
接入 Google Calendar 管理日程
代码执行技能
让 AI 可以在服务器上运行代码
💡
想安装新技能？去 GitHub 搜索 awesome-openclaw-agents，里面有 180+ 社区贡献的技能模板。
🔐 代理 → 节点
节点（Nodes）
安全性和权限配置中心，控制哪些连接可以被信任，防止未授权访问。
🛡️ 节点功能说明
主要配置项
网关配置
配置 OpenClaw 对外暴露的端口和访问地址，决定谁能连进来
安全模式
开启后只有持有令牌的客户端才能连接，防止未授权访问
节点白名单
指定允许连接的 IP 地址或设备，精细化权限管理
⚠️
如果你把 OpenClaw 部署在公网服务器上，务必开启安全模式并设置强密码，否则任何人都可能连接并使用你的 AI（消耗你的 API 费用）。
🛠️ 设置 → 配置
配置（Configuration）
系统层级的底层设置，包括模型配置、环境变量、版本更新等。这是最重要的设置页面。
📝 配置页面的 Tab 说明
配置页面通常有多个选项卡
| 选项卡 | 功能 | 典型操作 |
|---|---|---|
| Settings | 核心配置 JSON 编辑器，包含模型、代理、频道等全局设置 | 修改 API Key、更换模型 |
| Environment | 环境变量管理，类似 .env 文件的可视化界面 | 填入 ANTHROPIC_API_KEY 等 |
| Updates | 检查并更新 OpenClaw 版本 | 点击检查更新、安装新版本 |
⚠️
修改 Settings JSON 时要小心，格式错误会导致服务启动失败。建议改之前先备份当前配置。
🔄 更换模型
切换 AI 使用的模型（不同模型能力和价格不同）
{
"agents": {
"defaults": {
"model": "anthropic/claude-sonnet-4-20250514",
// 或者换成 OpenAI
"model": "openai/gpt-4o",
// 或者 OpenRouter（推荐）
"model": "openrouter/anthropic/claude-sonnet-4"
}
}
}📨 设置 → 通信
通信（Communication）
配置 OpenClaw 如何通过外部渠道发送通知和消息，是频道的底层配置层。
📡 通信 vs 频道的区别
两者的关系容易混淆
| 模块 | 定位 | 类比 |
|---|---|---|
| 频道（控制→频道） | 面向用户的接入入口配置，绑定具体的 Bot Token 等 | 插座 |
| 通信（设置→通信） | 底层通信协议配置，如消息格式、重试策略、通知方式等 | 电线 |
ℹ️
大多数用户不需要修改通信页面，保持默认即可。只有在自定义消息推送策略或接入特殊渠道时才需要配置。
🎨 设置 → 外观与设置
外观与设置（Appearance）
修改控制面板的视觉风格，纯粹的界面美化，不影响 AI 功能。
🎨 可配置的外观选项
如图2所示的配置项
Theme（主题）
Claw（默认红色）、Knot（绳结风）、Dash（简洁风）三种主题可选
Roundness（圆角）
调整整体界面的圆角程度，从方形到完全圆润都可以
深色/浅色模式
右上角太阳/月亮图标可以切换
Connection
连接相关的界面显示设置
💡
修改后点击右上角 Save 保存，Apply 立即应用。不喜欢随时可以点 Reload 恢复。
🔄 设置 → 自动化
自动化（Automation）
比定时任务更高级的自动化规则配置，可以基于事件触发（而不只是时间触发）。
⚡ 自动化 vs 定时任务
两种自动化方式的区别
| 类型 | 触发方式 | 示例 |
|---|---|---|
| 定时任务（Cron） | 按固定时间触发 | 每天早 8 点发报告 |
| 自动化（Automation） | 按事件触发 | 收到邮件时 → 自动摘要并发 Telegram |
ℹ️
自动化功能需要配合相应的工具和频道才能使用，是进阶功能。新手先掌握定时任务即可。
🏗️ 设置 → 基础设施 / AI与代理
基础设施 & AI与代理
系统底层运行参数配置，以及 AI 模型的高级配置项。一般用户很少需要动这里。
🏗️ 基础设施（Infrastructure）
控制 OpenClaw 的运行环境配置
网络配置
监听端口、代理设置、防火墙规则等
存储配置
记忆文件存储路径、日志路径等
性能参数
并发限制、超时时间、重试次数等
🤖 AI与代理（AI & Agents）
高级模型配置，这里也可以修改 API Key
💡
API Key 也可以在这里配置！找到 "providers" 或 "apiKey" 相关字段，填入你的密钥后保存即可。
| 配置项 | 说明 |
|---|---|
| 模型提供商（providers） | 配置各 AI 厂商的 API Key，这里是统一管理的入口 |
| 默认模型（default model） | 所有代理默认使用的 AI 模型 |
| Token 限制 | 单次对话最多使用多少 Token，防止超额消费 |
| 温度（temperature） | 控制 AI 创造力，0=保守固定，1=发散随机 |
| 备用模型（fallback） | 主模型失败时自动切换到备用模型 |