OpenClaw

OpenClaw 是个自托管 AI agent 平台，集成多模型 + 多通讯渠道（Telegram / WhatsApp / 飞书等）+ Gateway 中枢。适合搭团队/朋友圈共享 AI 助手。

别跟 OpenCode 混淆

• OpenCode — 单机 agent CLI（个人用）
• OpenClaw — Agent 平台 + Gateway + 多端接入（团队用）

适合谁

• ✅ 自建团队/朋友圈共享 AI 助手
• ✅ 想用 Telegram / 飞书 / WhatsApp 当 AI 入口
• ✅ Linux 云服务器 + macOS 用户
• ❌ 个人单机用（Claude Code 更直接）

安装

macOS / Linux / WSL2

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell

iwr -useb https://openclaw.ai/install.ps1 | iex

Onboard 初始化（必做）

安装后第一次跑：

openclaw onboard --install-daemon

向导会引导你配置 4 个部分：

1. 鉴权设置 — Gateway Token / 密码保护
2. LLM 提供商 — 接入 Shuro 或其他
3. 通道集成（可选） — Telegram / Discord / 飞书 / WhatsApp 等
4. 系统服务 — --install-daemon 开机自启

配置 Shuro

在 onboard 流程中或之后，选「自定义/兼容 Anthropic」 provider，填：

字段	值
API Base URL	https://shuro.vip
API Key	<您的 API Key>
模型	claude-opus-4-7

用 openclaw-configurator 一键配

curl -fsSL https://openclaw.ai/configurator.sh | bash

按提示填 base_url 和 key，自动写入 ~/.openclaw/openclaw.json。

手动编辑配置

~/.openclaw/openclaw.json：

{
  "gateway": { "port": 18789 },
  "providers": {
    "anthropic": {
      "base_url": "https://shuro.vip",
      "api_key": "${SHURO_API_KEY}",
      "models": [
        "claude-opus-4-7",
        "claude-sonnet-4-6",
        "claude-haiku-4-5-20251001"
      ]
    },
    "openai": {
      "base_url": "https://shuro.vip/v1",
      "api_key": "${SHURO_API_KEY}",
      "models": ["gpt-5.5", "gpt-5.4"]
    }
  },
  "default_model": "claude-opus-4-7"
}

环境变量：

echo 'export SHURO_API_KEY="<您的 API Key>"' >> ~/.zshrc

配置目录结构

~/.openclaw/
├── openclaw.json              # 主配置
├── workspace/                 # ⭐ Agent 的"灵魂"目录
│   ├── SOUL.md                # AI 人格/语气设定
│   ├── USER.md                # 用户个人信息
│   ├── MEMORY.md              # 长期记忆
│   ├── IDENTITY.md            # Agent 名字和形象
│   ├── BOOT.md                # 启动配置
│   └── HEARTBEAT.md           # 定期自检清单
├── agents/<cid>/              # 多 Agent 各自状态
├── memory/<cid>.sqlite        # 向量索引数据库
├── skills/                    # 技能包（clawhub install 下来）
└── credentials/               # 老版鉴权（迁移走 env）

workspace/ 下都是 Markdown 文件，可以直接用 VS Code 编辑，修改实时生效。

SOUL.md 示例（人格设定）

# Agent 人格

我是 mufan 的代码助手 "JiJi"。

## 语气
- 直接、简洁，不啰嗦
- 用专业术语但解释清楚
- 中英混用按 mufan 平时习惯

## 偏好
- 用 TypeScript strict mode
- 喜欢函数式编程
- 测试驱动开发

USER.md 示例

# 用户信息

- 姓名: mufan
- 时区: Asia/Shanghai
- 工作: 后端工程师，主要 Go + Python
- 项目: AI 中转网关相关开发

MEMORY.md（长期记忆）

OpenClaw 会自动写入重要事实，你也可以手动编辑：

# 长期记忆

## 项目知识
- Shuro 是基于 new-api 的中转平台

## 用户偏好
- 不喜欢生成式标点
- 提交 commit 不要加 Co-Authored-By

Gateway 中枢

OpenClaw 所有功能依赖 Gateway 进程：

openclaw gateway start         # 启动
openclaw gateway status        # 状态
openclaw gateway restart       # 重启（改配置后）
openclaw gateway stop          # 停止
openclaw gateway --port 18789  # 指定端口

配置热重载

默认 hybrid 模式，安全修改自动应用，必要时才重启 —— 改 SOUL.md / USER.md 不用重启。

TUI（终端对话）

openclaw tui

# 连远程 Gateway
openclaw tui --url ws://<host>:<port> --token <token>

TUI 快捷键

快捷键	作用
Enter	发送消息
Ctrl+C	清空输入（连按两次退出）
Ctrl+L	模型选择器
Ctrl+G	Agent 选择器
!<cmd>	执行本地 shell

TUI 斜杠命令

/help                              # 帮助
/status                            # 连接状态
/model anthropic/claude-sonnet-4-6 # 切换模型
/agent <id>                        # 切换 Agent
/session <key>                     # 切换会话
/think <level>                     # 思考深度（low/medium/high）

Dashboard（Web UI）

openclaw dashboard
# 或浏览器访问 http://127.0.0.1:18789/

功能：

• 网页聊天
• Gateway 状态监控
• 会话管理
• 多 Agent 切换

适合在另一台设备访问 OpenClaw 网关。

多端集成（Gateway 真正强大的地方）

OpenClaw Gateway 让你用 Telegram / 飞书 / WhatsApp / Email 当 AI 入口：

openclaw onboard
# 选「通道集成」
# 加 Telegram bot token

之后：

Telegram 上发消息 → OpenClaw Gateway 收到 → 调 Shuro → Claude 回答
              ←←←←← 推回 Telegram

你不用打开电脑/终端，手机随时找 Claude 聊天。

支持的通道

类别	平台
国际 IM	Telegram / Discord / Slack / WhatsApp / Signal / Matrix
企业	飞书 / 钉钉 / 企业微信 / Mattermost
其他	iMessage（BlueBubbles）/ Email / SMS / Home Assistant

完整命令清单

# 安装与初始化
openclaw onboard                # 配置向导
openclaw doctor                 # 全面健康检查
openclaw health                 # 快速健康检查
openclaw status                 # 整体状态
openclaw version                # 版本

# Gateway 管理
openclaw gateway start/stop/restart/status

# 交互
openclaw tui                    # 终端 UI
openclaw dashboard              # Web UI

# 配置
openclaw configure              # 交互式
openclaw config get <path>      # 查看
openclaw config set <path> <v>  # 修改

# 技能
clawhub install <skill>         # 装技能
openclaw skills list            # 列出已装

# 多用户授权
openclaw pairing list           # 待审用户
openclaw pairing approve <id>   # 批准
openclaw pairing reject <id>    # 拒绝

# 日志
openclaw logs --follow          # 实时日志

模型推荐

用途	模型
日常对话	claude-opus-4-7
快速回复 / 便宜替代（IM bot 场景）	claude-haiku-4-5-20251001
深度思考	claude-opus-4-6（开启 thinking 请求参数）
GPT 系列	gpt-5.4 / gpt-5.5

Shuro 都支持，用 /model 命令在 TUI 里切。

跟其他工具对比

	OpenClaw	OpenCode	Claude Code	Hermes
单机/服务端	服务端	单机	单机	服务端
多用户共享	✅	❌	❌	✅
多端 IM 接入	✅	❌	❌	✅（更多）
编程深度	中	强	极强	中
学习闭环	❌	❌	❌	✅
部署复杂度	中	易	易	中

OpenClaw 替代品：Hermes Agent 是同类工具且支持从 OpenClaw 迁移。

进阶教程

• xianyu110/awesome-openclaw-tutorial - 最全中文教程
• yeasy/openclaw_guide - 入门 + 原理
• 菜鸟教程 OpenClaw
• 飞书对接保姆级

资源

• openclaw.ai 官网
• openclawcn.com 中文站
• ClawHub 技能市场：clawhub.ai
• 5400+ 技能集合：VoltAgent/awesome-openclaw-skills