# 毛仔使用指南 🐱

> 最后更新：2026-02-26

---

## 一、毛仔是谁

- **名字**：毛仔
- **本质**：基于 Claude Opus 的 AI 助手，运行在 OpenClaw 平台上
- **性格**：聪明、幽默、不啰嗦，有自己的想法
- **首次上线**：2026-02-25
- **主人**：Powell（深圳南山区）

---

## 二、运行环境

| 项目 | 信息 |
|------|------|
| **服务器** | 腾讯云广东地区（43.160.243.14） |
| **操作系统** | Linux (OpenCloudOS) |
| **平台** | OpenClaw 2026.2.23 |
| **Node.js** | v22.22.0 |
| **工作目录** | `/root/.openclaw/workspace` |
| **沟通渠道** | 飞书 DM |
| **配置文件** | `~/.openclaw/openclaw.json` |

### 模型配置

| 角色 | 模型 | 来源 |
|------|------|------|
| **主力** | claude-opus-4-6 | anyrouter（免费） |
| **回退1** | google/gemini-2.5-flash | OpenRouter（付费，极便宜） |
| **回退2** | anthropic/claude-sonnet-4-5 | OpenRouter（付费） |

> anyrouter 限流时自动切换到回退模型，无需手动干预。

---

## 三、配置方法

### 基础配置文件

所有配置在 `~/.openclaw/openclaw.json`，关键部分：

```json
{
  "env": {
    "OPENROUTER_API_KEY": "sk-or-v1-xxx"
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "anyrouter/claude-opus-4-6",
        "fallbacks": [
          "openrouter/google/gemini-2.5-flash",
          "openrouter/anthropic/claude-sonnet-4-5"
        ]
      }
    }
  }
}
```

### 常用配置命令

```bash
# 查看当前状态
openclaw gateway status

# 重启（改配置后需要）
openclaw gateway restart

# 查看模型状态
openclaw models status

# 切换模型（在飞书聊天中）
/model                              # 列出可用模型
/model openrouter/google/gemini-2.5-pro  # 切换到指定模型
/model anyrouter/claude-opus-4-6    # 切回免费 Opus

# 清除对话历史
/clear
```

### 添加新的模型提供商

OpenRouter 是内置提供商，只需设置环境变量 `OPENROUTER_API_KEY`，不需要手动配 baseUrl。自定义提供商（如 anyrouter）需要在 `models.providers` 里写明 `baseUrl`、`apiKey`、`api` 和 `models`。

---

## 四、使用方法

### 日常对话
直接在飞书发消息即可，毛仔会自动回复。

### 让毛仔执行命令
```
帮我跑一下 df -h
查看系统内存使用情况
```

### 搜索和操作笔记（Obsidian）
```
搜一下我笔记里关于"战略"的内容
看看 DRAFT.md 里写了什么
帮我在 daily 文件夹创建今天的日记
```
> 笔记仓库路径：`/root/vault/obsidian_vault/obsidian/obsidian/`

### 总结文章/网页
```
总结一下这篇文章：https://xxx
```
> 注意：知乎、微信公众号等需要登录的平台，直接复制正文粘贴给毛仔更靠谱。

### 查天气
```
今天天气怎么样
```
> 默认查深圳南山区。

### 安装技能（Skill）
```
安装 skill xxx
```
> 通过 ClawHub 安装，网络有时不稳定可能需要重试。

---

## 五、已安装的 Skills

| Skill | 用途 |
|-------|------|
| `agent-browser` | 浏览器自动化 |
| `find-skills` | 查找新技能 |
| `github` | GitHub CLI 操作 |
| `notion` | Notion API |
| `obsidian` | Obsidian 笔记管理 |
| `proactive-agent` | 主动型智能体架构 |
| `self-improving-agent` | 自我改进学习 |
| `summarize` | 总结 URL/文件 |
| `sysadmin` | Linux 系统管理最佳实践 |
| `tavily-search` | Tavily AI 搜索 |
| `weather` | 天气查询 |

---

## 六、使用建议

### 沟通习惯
- **简短指令即可**：毛仔会自己判断怎么做，不需要写很详细的步骤
- **可以同时提多个问题**：毛仔会逐个处理并标注完成状态
- **复杂任务毛仔会先确认**：收到后先回一条"在处理"，完成后标注"✅ 回答完毕"

### 能做的事
- ✅ 执行服务器命令、查看日志、管理进程
- ✅ 读写文件、管理笔记
- ✅ 搜索网页、总结文章
- ✅ 查天气、做翻译
- ✅ 写代码、分析数据
- ✅ 安装和管理 skills

### 需要注意的
- ⚠️ 知乎/公众号等封闭平台的文章，建议复制正文发给毛仔
- ⚠️ 服务器上没有浏览器环境，无法直接登录网站
- ⚠️ anyrouter 偶尔限流，会自动切换到 OpenRouter 的回退模型
- ⚠️ 修改 `openclaw.json` 后需要 `openclaw gateway restart` 生效
- ⚠️ 敏感操作（删文件、发邮件等）毛仔会先确认再执行

### 省钱技巧
- 免费 Opus 够用就不切模型
- 需要处理图片或超长文本时，切到 Gemini：`/model openrouter/google/gemini-2.5-flash`
- 用完记得切回：`/model anyrouter/claude-opus-4-6`
- 或者直接让毛仔自动回退（默认行为）

---

## 七、架构图

```
Powell (飞书)
    ↕ 飞书 API
OpenClaw Gateway (服务器 127.0.0.1:18789)
    ↕
AI 模型
├── anyrouter/claude-opus-4-6  (主力，免费)
├── openrouter/gemini-2.5-flash (回退1)
└── openrouter/claude-sonnet-4-5 (回退2)
    ↕
工具层
├── exec (Shell 命令)
├── read/write/edit (文件操作)
├── web_search / web_fetch (网络)
├── memory (记忆系统)
├── message (消息发送)
└── skills (可扩展技能)
```

---

*由毛仔自动生成 🐱*