zhaoweiguo 的知识库

OpenClaw

5分钟阅读

Self-hosted gateway，将 Discord、Feishu、iMessage、Matrix、Slack、Telegram、WhatsApp 等 20+ IM 平台连接到 AI coding agents。在自己的机器上运行一个 Gateway 进程，即可从任何地方与 AI 助手对话。

前身为 Clawd（2025-11-25）→ Moltbot（2026-01-27）→ OpenClaw（2026-01-30），因 Anthropic 商标问题两次改名。

为什么值得关注

  • 自托管：数据不经过第三方，完全掌控
  • 多渠道统一：一个 Gateway 同时接入所有 IM，Agent 无需感知渠道差异
  • 多 Agent 编排：内置 sub-agent 机制，支持并行任务、嵌套编排、线程绑定
  • Skill 生态：ClawHub 公共注册表，5000+ skill，openclaw skills install <slug> 一键安装

核心架构

IM 渠道 (Telegram/Slack/Discord/...)
        ↓
   OpenClaw Gateway  (port 18789)
        ↓
   Agent 路由层  (bindings 规则)
        ↓
   Agent 实例  (workspace + SOUL.md + skills)
        ↓
   AI Provider  (Anthropic/OpenAI/Google/Ollama/...)

关键目录结构：

~/.openclaw/
├── agents/
│   ├── main/          # 默认 Agent（虾管家）
│   │   ├── workspace/
│   │   ├── sessions/
│   │   └── agent/auth-profiles.json
│   └── <agentId>/     # 其他 Agent
├── skills/            # 共享 skill 目录
└── openclaw.json      # 主配置

核心特性

  • 渠道支持：Discord、Feishu、Google Chat、iMessage、Matrix、Mattermost、Signal、Slack、Telegram、WeChat、WhatsApp、Zalo 等
  • Provider 支持：Anthropic、OpenAI、Google、Azure、Ollama、DeepSeek、Qwen 等 40+ 模型提供商
  • 工具体系：exec、browser、web search、skills、plugins、image/video/music generation
  • 自动化：cron jobs、hooks、standing orders、taskflow
  • 安全：per-agent sandbox（Docker 隔离）、exec approvals、access groups、pairing

快速安装

# macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash
 
# 初始化（选择模型、配置 API key）
openclaw onboard --install-daemon
 
# 验证
openclaw gateway status   # 应监听 18788 端口
openclaw dashboard        # 打开 Control UI

更新机制（2026-08-22 调研）

调研过的 CLI 工具里最成熟的更新体系，详见 ai-devtool-update-strategies。

  • 一站式：openclaw update 自动识别安装类型（npm/git）→ 更新 → openclaw doctor（配置迁移+体检）→ 重启 Gateway；--dry-run 预览、--json 结构化、openclaw update status --json 查通道状态
  • 三通道：stable / beta / dev（npm dist-tag: latest/beta/dev，git 装 = dev 通道）；当前版本是 beta 时通道粘在 beta；--channel 还能在 npm 装 ↔ git 源码装之间切换，~/.openclaw 状态不受影响
  • 自动更新默认关，开启后分策略：stable = 延迟 6h + 12h 确定性 jitter（错峰灰度）；beta = 每小时检查即装；dev = 手动。OPENCLAW_NO_AUTO_UPDATE=1 可硬禁
  • 原子替换：先装临时 npm prefix → 校验 dist 清单 → 整体切换，避免新旧文件叠加；失败 --omit=optional 重试
  • 回滚：npm i -g openclaw@<版本> 钉版本 / git 钉 commit，doctor + gateway restart 收尾
  • 版本号 CalVer（2026.x.y，beta 带 -beta.n）；macOS 桌面端走 Sparkle appcast；升级有完整 e2e（通道切换/迁移/upgrade-survivor/坏插件恢复）

多 Agent 配置示例

{
  "agents": {
    "defaults": {
      "subagents": { "maxSpawnDepth": 2, "maxConcurrent": 8 }
    },
    "list": [
      {
        "id": "main",
        "default": true,
        "workspace": "~/.openclaw/workspace",
        "sandbox": { "mode": "off" }
      },
      {
        "id": "worker",
        "workspace": "~/.openclaw/workspace-worker",
        "tools": { "profile": "coding" },
        "sandbox": { "mode": "all", "scope": "session" }
      }
    ]
  }
}

适用场景

  • 个人 AI 助手：手机 Telegram/WhatsApp 随时与本机 AI 对话
  • 团队协作：群聊中 @ 不同专业 Agent 分工处理任务
  • 自动化工作流：cron 定时任务 + hooks 事件驱动
  • 多 Agent 编排：主 Agent 调度多个专业子 Agent 并行工作

局限性

  • Node.js 24 依赖，Windows 建议用 WSL2
  • 多 Agent 超时/挂起问题需要手动配置心跳和超时（见 openclaw-multi-agent-timeout）
  • sub-agent 各自独立 context，token 消耗翻倍（可配置更便宜的子 Agent 模型）

生态系统

关系图谱

反向链接