openclaw
约 1327 字大约 4 分钟
openclawollamamoltbotclawdbot
2026-01-28
openclaw 是一款开源、自托管的个人 AI 助手,可以运行在你自己的电脑(例如 Mac mini)上,并连接到你常用的聊天平台如 WhatsApp、Telegram、Discord 等。它不仅能对话,还能执行任务、主动提醒、管理文件和自动化工作流程——可以理解为“你自己的私人 AI 员工”。
openclaw 是什么?理解核心
openclaw 是:
🛠️ 自托管的 AI 助手:运行在自己的机器上,不依赖云端服务。
📱 跨通讯平台:可以让 AI 出现在 Whatsapp、Telegram、Discord、Slack、Signal、iMessage 等聊天程序里。
🤖 具备实际操作能力:不仅回答问题,还可以执行系统命令、浏览器操控、自动化任务等。
🧠 保持上下文记忆:可持续记住对话和用户偏好,从而更加智能。
openclaw 不只是聊天机器人,它是新一代的“个人 AI 助手/智能体”。
准备你的 Mac mini
在开始部署之前,确保你的 Mac mini 满足以下基本要求:
✔ macOS 系统(最新版更稳定)
✔ 已安装 Node.js(>=22) 和 pnpm 或 npm(openclaw 依赖)
也可以使用 Homebrew 安装:
brew install node
brew install pnpm在 Mac mini 上安装 openclaw
1) 快速安装
在终端执行:
curl -fsSL https://openclaw.ai/install.sh | bash这个脚本会安装 openclaw 所需的依赖并设置环境。
2) 启动 openclaw
安装完成后,你可以运行 openclaw 的命令行界面:
openclaw建议首先运行引导式设置
openclaw onboard --install-daemon这个引导会帮你自动配置:
选择模型、授权方式
设置消息渠道(如 Telegram/WhatsApp)
初始化工作空间和技能
如果你不想使用 CLI 引导,可以手动运行:
openclaw setup
openclaw gateway启动本地 Gateway 后,openclaw 的本地控制面板通常会在浏览器打开:
http://127.0.0.1:18789如果暂时不接渠道,可以直接用终端对话:
openclaw tui启动和关闭服务:
openclaw gateway start
openclaw gateway stopollama
ollama v0.15.2 版本,支持对 openclaw 的集成。
ollama launch openclaw可直接通过 ollama 模型启动 openclaw
接入telegram
- 打开 Telegram,搜索 @BotFather
- 发送 /newbot,按提示起名(用户名必须以 bot 结尾)
- 复制生成的 token(类似 123456789:ABCdef…)
把 token 告诉 AI,它会自动写入配置:
{
"channels": {
"telegram": {
"enabled": true,
"botToken": "你的token",
"dmPolicy": "pairing"
}
}
}然后在 Telegram 里获取配对码,发给 AI:
openclaw pairing approve telegram <配对码>完成!现在可以在 Telegram 里正常聊天了.
整体架构
OpenClaw本质是跑在你电脑上的后台程序。工作流程大概这样:
用户消息(飞书/微信/Telegram)
↓
Channel Adapter(统一不同平台的消息格式)
↓
Gateway(核心调度,路由到正确的会话)
↓
Agent(选模型、组提示词、调工具)
↓
结果返回关键点:不管你用什么聊天工具发消息,经过Channel Adapter统一格式后,AI看到的都是标准输入。所以OpenClaw能轻松接各种平台,不用每个平台写一套逻辑。
常用命令大全
1)基础命令
# 查看版本
openclaw --version
# 查看帮助
openclaw --help
# 查看状态概览
openclaw status
# 完整诊断
openclaw status --all
# 健康检查
openclaw health
openclaw status --deep # 深度健康检查
2)Gateway 管理
# 启动 Gateway
openclaw gateway start
# 停止 Gateway
openclaw gateway stop
# 重启 Gateway
openclaw gateway restart
# 查看状态
openclaw gateway status
# 手动前台运行(调试)
openclaw gateway --port 18789 --verbose
# 绑定模式
openclaw gateway --bind loopback # 本地回环(默认)
openclaw gateway --bind lan # 局域网
openclaw gateway --bind tailnet # Tailscale 网络
3)配置管理
# 交互式配置
openclaw configure
# 查看完整配置
openclaw config get
# 查看特定配置
openclaw config get agents.defaults
openclaw config get models
openclaw config get channels.telegram
# 设置单个值
openclaw config set gateway.port 18789
openclaw config set agents.defaults.workspace ~/.openclaw/workspace
# 删除配置项
openclaw config unset gateway.port
# 配置文件位置
# ~/.openclaw/openclaw.json
4)模型管理
# 查看可用模型
openclaw models list
# 查看模型状态
openclaw models status
# 设置默认模型
openclaw models set anthropic/claude-sonnet-4-0
# 测试模型连接
openclaw models probe <model-name>
5)频道管理
# 添加频道
openclaw channels add
# 查看频道状态
openclaw channels status
6)配对管理
# 查看待处理配对
openclaw pairing list whatsapp
openclaw pairing list telegram
# 批准配对
openclaw pairing approve whatsapp <CODE>
# 拒绝配对
openclaw pairing deny whatsapp <CODE>
7)消息发送
# 发送文本消息
openclaw message send --target +15555550123 --message "Hello from OpenClaw"
# 发送文件
openclaw message send --target +15555550123 --file /path/to/file.txt
8)代理 (Agents)
# 查看代理列表
openclaw agents list
# 添加新代理
openclaw agents add work --workspace ~/.openclaw/work
9)会话管理
# 查看活跃会话
openclaw sessions list
# 查看会话历史
openclaw sessions history <session-key>
# 重置会话
openclaw sessions reset <session-key>
10)技能管理
# 列出已安装技能
openclaw skills list
# 安装技能
openclaw skills install skill-name
# 查看技能配置
openclaw skills config skill-name
# 更新技能
openclaw skills update skill-name
11)日志和诊断
# 实时查看日志
openclaw logs --follow
# 查看最近 N 行
openclaw logs --limit 100
# 健康检查
openclaw health
# 诊断和修复
openclaw doctor
openclaw doctor --fix # 自动修复
12)目录和工作区
# 查看工作区目录
openclaw directory
# 查看文件
ls -la ~/.openclaw/workspace/
13)更新和升级
# 检查更新
openclaw --version
# 更新 CLI(安装脚本)
curl -fsSL https://openclaw.ai/install.sh | bash
# 从源码更新
git pull origin main
pnpm install
pnpm build
openclaw doctor
openclaw gateway restart
14)安全相关
# 安全审计
openclaw security audit
# 深度审计
openclaw security audit --deep
