整理笔记目录 完善gogcli文档
This commit is contained in:
billyshen
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@@ -1,212 +0,0 @@
|
||||
#gog #gog-cli #macos
|
||||
|
||||
本文档记录在 macOS 系统上安装和配置 gog CLI 的完整步骤，以便通过命令行管理 Google Workspace（Gmail、Google Calendar、Google Drive、Google Contacts、Google Docs、Google Sheets）。
|
||||
|
||||
## 目录
|
||||
|
||||
- [前置条件](#前置条件)
|
||||
- [安装步骤](#安装步骤)
|
||||
- [配置 OAuth 凭证](#配置-oauth-凭证)
|
||||
- [解除 Google 安全限制](#解除-google-安全限制)
|
||||
- [验证配置](#验证配置)
|
||||
- [常用命令](#常用命令)
|
||||
- [故障排除](#故障排除)
|
||||
|
||||
---
|
||||
|
||||
## 前置条件
|
||||
|
||||
- macOS 系统
|
||||
- Homebrew 已安装
|
||||
- Google 账号
|
||||
|
||||
---
|
||||
|
||||
## 安装步骤
|
||||
|
||||
### 1. 安装 gog CLI
|
||||
|
||||
使用 Homebrew 安装 gog CLI：
|
||||
|
||||
```bash
|
||||
brew install steipete/tap/gogcli
|
||||
```
|
||||
|
||||
验证安装：
|
||||
|
||||
```bash
|
||||
which gog
|
||||
# 输出: /opt/homebrew/bin/gog
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 配置 OAuth 凭证
|
||||
|
||||
### 1. 在 Google Cloud Console 创建 OAuth 凭证
|
||||
|
||||
1. 打开 [Google Cloud Console - Credentials](https://console.cloud.google.com/apis/credentials)
|
||||
2. 点击 **「创建凭证」** → 选择 **「OAuth 客户端 ID」**
|
||||
3. 应用类型选择 **「桌面应用」**
|
||||
4. 命名（例如：`gogcli`）
|
||||
5. 点击 **「创建」**
|
||||
6. 点击 **「下载 JSON」**，得到 `credentials.json` 文件
|
||||
|
||||
### 2. 移动凭证文件到 gogcli 配置目录
|
||||
|
||||
创建 gogcli 配置目录（如果不存在）：
|
||||
|
||||
```bash
|
||||
mkdir -p "/Users/weishen/Library/Application Support/gogcli"
|
||||
```
|
||||
|
||||
移动下载的凭证文件：
|
||||
|
||||
```bash
|
||||
mv ~/Downloads/credentials.json "/Users/weishen/Library/Application Support/gogcli/credentials.json"
|
||||
```
|
||||
|
||||
或者使用命令指定凭证路径：
|
||||
|
||||
```bash
|
||||
gog auth credentials /path/to/credentials.json
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 解除 Google 安全限制
|
||||
|
||||
### 问题描述
|
||||
|
||||
首次授权时，Google 会显示以下错误：
|
||||
|
||||
> 此应用未经 Google 验证
|
||||
> 此应用请求访问您 Google 账号中的敏感信息。在开发者让该应用通过 Google 验证之前，请勿使用该应用。
|
||||
|
||||
### 解决方法：添加测试用户
|
||||
|
||||
1. 打开 [Google Cloud Console - Credentials](https://console.cloud.google.com/apis/credentials)
|
||||
2. 找到你创建的 OAuth 客户端ID，点击进入详情
|
||||
3. 找到 **「测试用户」** 部分
|
||||
4. 点击 **「添加用户」**
|
||||
5. 输入你的 Google 邮箱：`ishenwei@gmail.com`
|
||||
6. 保存
|
||||
|
||||
添加测试用户后，重新运行授权命令即可：
|
||||
|
||||
```bash
|
||||
gog auth add ishenwei@gmail.com --services gmail,calendar,drive,contacts,docs,sheets
|
||||
```
|
||||
|
||||
这会打开浏览器让你登录 Google 账号并授权。
|
||||
|
||||
---
|
||||
|
||||
## 验证配置
|
||||
|
||||
### 1. 查看已授权的账号
|
||||
|
||||
```bash
|
||||
gog auth list
|
||||
```
|
||||
|
||||
### 2. 测试 Gmail
|
||||
|
||||
```bash
|
||||
gog gmail search "newer_than:1d" --max 5
|
||||
```
|
||||
|
||||
### 3. 测试 Calendar
|
||||
|
||||
```bash
|
||||
gog calendar events primary --from 2026-01-01 --to 2026-12-31
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 常用命令
|
||||
|
||||
### Gmail
|
||||
|
||||
| 功能 | 命令 |
|
||||
|------|------|
|
||||
| 搜索邮件 | `gog gmail search 'newer_than:7d' --max 10` |
|
||||
| 发送邮件 | `gog gmail send --to a@b.com --subject "Hi" --body "Hello"` |
|
||||
| 发送邮件（多行） | `gog gmail send --to a@b.com --subject "Hi" --body-file ./message.txt` |
|
||||
| 创建草稿 | `gog gmail drafts create --to a@b.com --subject "Hi" --body-file ./message.txt` |
|
||||
| 发送草稿 | `gog gmail drafts send <draftId>` |
|
||||
|
||||
### Calendar
|
||||
|
||||
| 功能 | 命令 |
|
||||
|------|------|
|
||||
| 查看事件 | `gog calendar events <calendarId> --from <iso> --to <iso>` |
|
||||
| 创建事件 | `gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso>` |
|
||||
| 查看颜色 | `gog calendar colors` |
|
||||
|
||||
### Drive
|
||||
|
||||
| 功能 | 命令 |
|
||||
|------|------|
|
||||
| 搜索文件 | `gog drive search "query" --max 10` |
|
||||
|
||||
### Contacts
|
||||
|
||||
| 功能 | 命令 |
|
||||
|------|------|
|
||||
| 列出联系人 | `gog contacts list --max 20` |
|
||||
|
||||
### Sheets
|
||||
|
||||
| 功能 | 命令 |
|
||||
|------|------|
|
||||
| 获取数据 | `gog sheets get <sheetId> "Tab!A1:D10" --json` |
|
||||
| 更新数据 | `gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED` |
|
||||
|
||||
### Docs
|
||||
|
||||
| 功能 | 命令 |
|
||||
|------|------|
|
||||
| 导出文档 | `gog docs export <docId> --format txt --out /tmp/doc.txt` |
|
||||
| 查看内容 | `gog docs cat <docId>` |
|
||||
|
||||
---
|
||||
|
||||
## 故障排除
|
||||
|
||||
### 凭证文件路径错误
|
||||
|
||||
确保凭证文件在以下位置：
|
||||
```
|
||||
/Users/weishen/Library/Application Support/gogcli/credentials.json
|
||||
```
|
||||
|
||||
### 需要重新授权
|
||||
|
||||
删除现有授权并重新授权：
|
||||
|
||||
```bash
|
||||
gog auth remove ishenwei@gmail.com
|
||||
gog auth add ishenwei@gmail.com --services gmail,calendar,drive,contacts,docs,sheets
|
||||
```
|
||||
|
||||
### 设置默认账号
|
||||
|
||||
避免每次重复指定账号：
|
||||
|
||||
```bash
|
||||
export GOG_ACCOUNT=ishenwei@gmail.com
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 参考链接
|
||||
|
||||
- gog 官网: https://gogcli.sh
|
||||
- gog GitHub: https://github.com/steipete/gogcli
|
||||
- Google Cloud Console: https://console.cloud.google.com/
|
||||
|
||||
---
|
||||
|
||||
*文档创建日期: 2026-03-15*
|
||||
*最后更新: 2026-03-15*
|
||||
@@ -1,326 +0,0 @@
|
||||
#openclaw #agent
|
||||
|
||||
```table-of-contents
|
||||
```
|
||||
|
||||
# 1. 架构设计目标
|
||||
|
||||
该 Agent 架构基于 **OpenClaw 多节点智能体系统**，通过不同服务器部署不同职责的 Agent，并通过统一命名体系构建一个清晰、可扩展的 AI Agent 生态。
|
||||
|
||||
整体设计目标：
|
||||
|
||||
- 形成 **清晰的职责分层**
|
||||
- 建立 **统一的命名体系**
|
||||
- 支持 **未来扩展更多 Agent**
|
||||
- 便于 **星枢统一调度**
|
||||
|
||||
设计采用 **三层体系结构**：
|
||||
|
||||
| 层级 | 系列 | 含义 | 主要职责 |
|
||||
| --- | --- | ---- | ------------ |
|
||||
| 控制层 | 星系 | 星辰统御 | 调度、管理、智能决策 |
|
||||
| 技术层 | 云系 | 云海算力 | 开发、架构、监控 |
|
||||
| 执行层 | 风系 | 风行万里 | 测试、业务执行、流程处理 |
|
||||
|
||||
这种结构类似于 **AI Agent 操作系统**：
|
||||
```
|
||||
控制层（星）
|
||||
↓
|
||||
技术层（云）
|
||||
↓
|
||||
执行层（风）
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 2. 当前 Agent 架构
|
||||
|
||||
## 2.1 Mac Mini（中央控制节点）
|
||||
|
||||
定位：
|
||||
|
||||
- AI Agent 中枢
|
||||
- 调度中心
|
||||
- 个人与 IT 管理
|
||||
|
||||
|Agent|名字|角色|职责|
|
||||
|---|---|---|---|
|
||||
|星枢|Master Orchestrator|总调度|统一调度所有 Agent|
|
||||
|星曜|IT 管家|IT 管理|服务器、环境、运维|
|
||||
|星辉|个人助理|Assistant|日常任务与个人事务|
|
||||
|
||||
架构示意：
|
||||
|
||||
```
|
||||
Mac Mini
|
||||
├─ 星枢（总调度）
|
||||
├─ 星曜（IT管家）
|
||||
└─ 星辉（个人助理）
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 3. Ubuntu2（开发服务器）
|
||||
|
||||
定位：
|
||||
|
||||
- 技术研发
|
||||
- 架构设计
|
||||
- 自动化构建
|
||||
- 系统监控
|
||||
|
||||
Agent 命名统一以 **“云”开头**。
|
||||
|
||||
## 3.1 已有 Agent
|
||||
|
||||
| Agent | 职责 | |
|
||||
| ----- | ----------------------------------- | ---------------- |
|
||||
| 云瀚 | 监控系统 | 云海浩瀚，象征监控全局系统状态。 |
|
||||
| 云策 | - 架构设计<br>- 技术方案<br>- 系统规划 | 云中筹策，技术谋略。 |
|
||||
| 云匠 | - 代码开发<br>- 构建<br>- 工程实现 | 云端工匠 |
|
||||
| 云织 | - CI/CD<br>- 自动化流程<br>- pipeline 编排 | 织云为网 |
|
||||
|
||||
|
||||
---
|
||||
|
||||
## 3.3 Ubuntu2 最终推荐结构
|
||||
|
||||
```
|
||||
Ubuntu2（开发服务器）
|
||||
|
||||
云瀚 监控
|
||||
云策 架构设计
|
||||
云匠 开发实现
|
||||
云织 CI/CD自动化
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 4. Ubuntu1（准生产服务器）
|
||||
|
||||
定位：
|
||||
|
||||
- QA 测试
|
||||
- 业务执行
|
||||
- 自动任务
|
||||
- 审计规则
|
||||
|
||||
Agent 统一使用 **“风”系列命名**。
|
||||
|
||||
原因：
|
||||
|
||||
> 风代表执行、速度、行动。
|
||||
|
||||
| Agent | 职责 | |
|
||||
| ----- | ---------------------------- | ----- |
|
||||
| 风衡 | - QA 测试<br>- 自动测试<br>- 质量控制 | 风中权衡。 |
|
||||
| 风驰 | - 自动任务<br>- Job 执行<br>- 业务流程 | 风驰电掣。 |
|
||||
| 风纪 | - 规则执行<br>- 审计<br>- 合规 | 风纪法度 |
|
||||
|
||||
---
|
||||
|
||||
## 4.2 Ubuntu1 推荐结构
|
||||
|
||||
```
|
||||
Ubuntu1（准生产服务器）
|
||||
|
||||
风衡 QA测试
|
||||
风驰 自动执行
|
||||
风纪 规则审计
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 5. 完整 Agent 架构
|
||||
|
||||
最终整体结构：
|
||||
|
||||
```
|
||||
星枢
|
||||
（总调度 Agent）
|
||||
│
|
||||
┌────────────┼────────────┐
|
||||
│ │ │
|
||||
星曜 星辉 服务器集群
|
||||
（IT管家） （个人助理） │
|
||||
│
|
||||
┌────────────┴────────────┐
|
||||
│ │
|
||||
Ubuntu2 Ubuntu1
|
||||
（开发服务器） （准生产）
|
||||
│ │
|
||||
┌───────┼───────┐ ┌───────┼───────┐
|
||||
│ │ │ │ │ │
|
||||
云瀚 云策 云匠 风衡 风驰 风纪
|
||||
监控 架构 开发 QA 执行 审计
|
||||
│
|
||||
云织
|
||||
CI/CD
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 6. Agent 体系总结
|
||||
|
||||
|系列|含义|角色类型|
|
||||
|---|---|---|
|
||||
|星|星辰|调度 / 管理|
|
||||
|云|云海|技术 / 开发|
|
||||
|风|风行|执行 / 流程|
|
||||
|
||||
---
|
||||
|
||||
## 星系 Agent
|
||||
|
||||
|Agent|职责|
|
||||
|---|---|
|
||||
|星枢|总调度|
|
||||
|星曜|IT 管理|
|
||||
|星辉|助手|
|
||||
|
||||
未来可扩展：
|
||||
|
||||
|Agent|角色|
|
||||
|---|---|
|
||||
|星策|战略规划|
|
||||
|星典|知识管理|
|
||||
|
||||
---
|
||||
|
||||
## 云系 Agent
|
||||
|
||||
|Agent|职责|
|
||||
|---|---|
|
||||
|云瀚|监控|
|
||||
|云策|架构|
|
||||
|云匠|开发|
|
||||
|云织|CI/CD|
|
||||
|
||||
---
|
||||
|
||||
## 风系 Agent
|
||||
|
||||
|Agent|职责|
|
||||
|---|---|
|
||||
|风衡|QA|
|
||||
|风驰|自动执行|
|
||||
|风纪|审计|
|
||||
|
||||
---
|
||||
|
||||
# 7. 设计优势
|
||||
|
||||
该 Agent 命名体系具有以下优点：
|
||||
|
||||
### 1. 语义清晰
|
||||
|
||||
看到名字即可理解职责。
|
||||
|
||||
例如：
|
||||
|
||||
- 云匠 → 开发
|
||||
|
||||
- 风衡 → QA
|
||||
|
||||
- 星枢 → 调度
|
||||
|
||||
|
||||
---
|
||||
|
||||
### 2. 层级清晰
|
||||
|
||||
```
|
||||
星（控制）
|
||||
↓
|
||||
云（技术）
|
||||
↓
|
||||
风（执行）
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3. 易于扩展
|
||||
|
||||
未来可以继续增加：
|
||||
|
||||
云系：
|
||||
|
||||
- 云图（数据）
|
||||
|
||||
- 云阵（基础设施）
|
||||
|
||||
- 云算（AI计算）
|
||||
|
||||
|
||||
风系：
|
||||
|
||||
- 风策（业务策略）
|
||||
|
||||
- 风行（业务执行）
|
||||
|
||||
- 风巡（巡检）
|
||||
|
||||
|
||||
---
|
||||
|
||||
### 4. 非常适合 Agent 调度
|
||||
|
||||
星枢可以统一调度：
|
||||
|
||||
```
|
||||
星枢 → 云系 → 风系
|
||||
```
|
||||
|
||||
示例：
|
||||
|
||||
```
|
||||
星枢
|
||||
↓
|
||||
云策（制定方案）
|
||||
↓
|
||||
云匠（开发）
|
||||
↓
|
||||
云织（部署）
|
||||
↓
|
||||
风衡（测试）
|
||||
↓
|
||||
风驰（执行）
|
||||
```
|
||||
|
||||
形成完整 **AI 自动化流水线**。
|
||||
|
||||
---
|
||||
|
||||
# 8. 最终推荐部署
|
||||
|
||||
### Mac Mini
|
||||
|
||||
```
|
||||
星枢
|
||||
星曜
|
||||
星辉
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Ubuntu2（开发）
|
||||
|
||||
```
|
||||
云瀚
|
||||
云策
|
||||
云匠
|
||||
云织
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Ubuntu1（准生产）
|
||||
|
||||
```
|
||||
风衡
|
||||
风驰
|
||||
风纪
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
@@ -1,574 +0,0 @@
|
||||
|
||||
#openclaw #agent #telegram
|
||||
```table-of-contents
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# OpenClaw 多 Agent 自动化系统架构笔记 (Advanced)
|
||||
|
||||
Author: Billy
|
||||
Purpose: 构建基于 OpenClaw + Telegram + n8n 的 AI 自动化控制系统
|
||||
|
||||
---
|
||||
|
||||
# 1 系统总体架构
|
||||
|
||||
**目标：**
|
||||
|
||||
构建一个 **AI Automation Control Center**
|
||||
|
||||
**核心组件：**
|
||||
|
||||
- OpenClaw Gateway
|
||||
- 多 Agent
|
||||
- Telegram Interface
|
||||
- n8n Workflow Engine
|
||||
|
||||
**系统架构：**
|
||||
|
||||
```
|
||||
Telegram
|
||||
│
|
||||
▼
|
||||
Telegram Bot
|
||||
│
|
||||
▼
|
||||
n8n
|
||||
(Command Router)
|
||||
│
|
||||
▼
|
||||
OpenClaw Gateway
|
||||
│
|
||||
▼
|
||||
┌────────┬────────┬────────┐
|
||||
▼ ▼ ▼ ▼
|
||||
Router Dev Research Ops
|
||||
Agent Agent Agent Agent
|
||||
```
|
||||
|
||||
**系统功能：**
|
||||
|
||||
| 组件 | 作用 |
|
||||
|------|------|
|
||||
| Telegram | 用户交互 |
|
||||
| n8n | 任务路由 |
|
||||
| OpenClaw | AI Agent Runtime |
|
||||
| Agents | 任务执行 |
|
||||
|
||||
---
|
||||
|
||||
# 2 OpenClaw 基础目录结构
|
||||
|
||||
**默认路径：** `~/.openclaw/`
|
||||
|
||||
**结构：**
|
||||
|
||||
```
|
||||
.openclaw/
|
||||
│
|
||||
├── agents/
|
||||
│ │
|
||||
│ ├── main/
|
||||
│ │ └── agent/
|
||||
│ │ ├── authprofile.json
|
||||
│ │ └── models.json
|
||||
│ │
|
||||
│ └── research/
|
||||
│ └── agent/
|
||||
│ ├── authprofile.json
|
||||
│ └── models.json
|
||||
│
|
||||
└── workspace/
|
||||
│
|
||||
├── skills/
|
||||
├── memory/
|
||||
├── identity/
|
||||
│ └── Identity.md
|
||||
├── logs/
|
||||
├── devices/
|
||||
├── completions/
|
||||
└── canvas/
|
||||
```
|
||||
|
||||
**说明：**
|
||||
|
||||
| 目录 | 作用 |
|
||||
|------|------|
|
||||
| agents | Agent Profile |
|
||||
| workspace | 运行数据 |
|
||||
| skills | 技能插件 |
|
||||
| memory | AI记忆 |
|
||||
| identity | System Prompt |
|
||||
| logs | 日志 |
|
||||
|
||||
---
|
||||
|
||||
# 3 多 Agent 设计
|
||||
|
||||
**创建 Agent：**
|
||||
|
||||
```bash
|
||||
openclaw agent create dev
|
||||
openclaw agent create research
|
||||
openclaw agent create ops
|
||||
openclaw agent create orchestrator
|
||||
```
|
||||
|
||||
**推荐 Agent 列表：**
|
||||
|
||||
| Agent | 职责 |
|
||||
|-------|------|
|
||||
| orchestrator | 任务调度 |
|
||||
| dev | 编程 |
|
||||
| research | 搜索分析 |
|
||||
| ops | 服务器运维 |
|
||||
| data | 数据处理 |
|
||||
|
||||
**推荐结构：**
|
||||
|
||||
```
|
||||
agents/
|
||||
│
|
||||
├── orchestrator/
|
||||
├── dev/
|
||||
├── research/
|
||||
├── ops/
|
||||
└── data/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 4 Agent Identity 设计
|
||||
|
||||
Identity 代表：System Prompt
|
||||
|
||||
**建议放在：** `agents/dev/agent/identity.md`
|
||||
|
||||
**示例：**
|
||||
|
||||
```
|
||||
You are DevAgent.
|
||||
|
||||
Responsibilities:
|
||||
- write code
|
||||
- debug programs
|
||||
- generate scripts
|
||||
- create docker configurations
|
||||
```
|
||||
|
||||
**Research Agent：**
|
||||
|
||||
```
|
||||
You are ResearchAgent.
|
||||
|
||||
Responsibilities:
|
||||
- research information
|
||||
- summarize technical topics
|
||||
- analyze documents
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 5 Skills 机制
|
||||
|
||||
**Skills 目录：** `workspace/skills`
|
||||
|
||||
**示例：**
|
||||
|
||||
```
|
||||
skills/
|
||||
├── browser
|
||||
├── filesystem
|
||||
├── python
|
||||
├── telegram
|
||||
└── self-improving-agent
|
||||
```
|
||||
|
||||
**特点：**
|
||||
|
||||
- 所有 Agent 共享
|
||||
- 类似插件
|
||||
|
||||
---
|
||||
|
||||
# 6 Memory 设计
|
||||
|
||||
**默认 memory：** `workspace/memory`
|
||||
|
||||
默认共享。
|
||||
|
||||
**memory 类型：**
|
||||
|
||||
```
|
||||
memory/
|
||||
├── episodic
|
||||
├── semantic
|
||||
└── vector
|
||||
```
|
||||
|
||||
**推荐 Memory 分层：**
|
||||
|
||||
```
|
||||
memory/
|
||||
├── system
|
||||
├── dev
|
||||
├── research
|
||||
└── ops
|
||||
```
|
||||
|
||||
这样避免：memory pollution
|
||||
|
||||
**Agent 指定 namespace：**
|
||||
|
||||
```json
|
||||
{
|
||||
"memoryNamespace": "dev"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 7 模型配置
|
||||
|
||||
每个 Agent 独立：`agents/<agent>/agent/models.json`
|
||||
|
||||
**示例：**
|
||||
|
||||
```json
|
||||
{
|
||||
"default": "gpt-4o-mini",
|
||||
"models": {
|
||||
"gpt-4o-mini": {
|
||||
"provider": "openai",
|
||||
"model": "gpt-4o-mini"
|
||||
},
|
||||
"deepseek-coder": {
|
||||
"provider": "openai-compatible",
|
||||
"base_url": "https://api.deepseek.com/v1",
|
||||
"model": "deepseek-coder"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**推荐模型分配：**
|
||||
|
||||
| Agent | Model |
|
||||
|-------|-------|
|
||||
| orchestrator | gpt-4o-mini |
|
||||
| dev | deepseek-coder |
|
||||
| research | gpt-4o |
|
||||
| ops | claude-sonnet |
|
||||
|
||||
**优点：**
|
||||
|
||||
- 降低成本
|
||||
- 提升能力
|
||||
|
||||
---
|
||||
|
||||
# 8 Agent 切换
|
||||
|
||||
**切换 active agent：**
|
||||
|
||||
```bash
|
||||
openclaw agent use research
|
||||
```
|
||||
|
||||
**行为：**
|
||||
|
||||
```
|
||||
current_agent = research
|
||||
```
|
||||
|
||||
下一条消息：
|
||||
|
||||
```
|
||||
Telegram → research agent
|
||||
```
|
||||
|
||||
不需要重启 Gateway。
|
||||
|
||||
---
|
||||
|
||||
# 9 Telegram 集成
|
||||
|
||||
OpenClaw 支持：Telegram Bot
|
||||
|
||||
**结构：**
|
||||
|
||||
```
|
||||
Telegram
|
||||
│
|
||||
▼
|
||||
OpenClaw Gateway
|
||||
```
|
||||
|
||||
**默认：** 所有消息 → active agent
|
||||
|
||||
---
|
||||
|
||||
# 10 Telegram 指令体系
|
||||
|
||||
**推荐命令：**
|
||||
|
||||
```
|
||||
/dev
|
||||
/research
|
||||
/ops
|
||||
/data
|
||||
/help
|
||||
```
|
||||
|
||||
**示例：**
|
||||
|
||||
```
|
||||
/dev 写一个python脚本
|
||||
/research 查一下OpenClaw架构
|
||||
/ops restart docker
|
||||
```
|
||||
|
||||
在 BotFather 设置：`/setcommands`
|
||||
|
||||
**示例：**
|
||||
|
||||
```
|
||||
dev - coding tasks
|
||||
research - research tasks
|
||||
ops - server tasks
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 11 n8n Command Router
|
||||
|
||||
推荐使用：n8n 进行任务路由。
|
||||
|
||||
**架构：**
|
||||
|
||||
```
|
||||
Telegram
|
||||
│
|
||||
▼
|
||||
n8n
|
||||
│
|
||||
▼
|
||||
OpenClaw
|
||||
```
|
||||
|
||||
**Workflow：**
|
||||
|
||||
```
|
||||
Telegram Trigger
|
||||
│
|
||||
▼
|
||||
Parse Command
|
||||
│
|
||||
▼
|
||||
Agent Router
|
||||
│
|
||||
▼
|
||||
HTTP → OpenClaw
|
||||
```
|
||||
|
||||
**解析示例：**
|
||||
|
||||
```javascript
|
||||
const msg = $json.message.text
|
||||
|
||||
if(msg.startsWith("/dev")){
|
||||
return {agent:"dev"}
|
||||
}
|
||||
|
||||
if(msg.startsWith("/research")){
|
||||
return {agent:"research"}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 12 Router Agent
|
||||
|
||||
Router Agent 负责：Task Distribution
|
||||
|
||||
**Prompt 示例：**
|
||||
|
||||
```
|
||||
You are a routing agent.
|
||||
|
||||
Rules:
|
||||
/dev → DevAgent
|
||||
/research → ResearchAgent
|
||||
/ops → OpsAgent
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 13 推荐系统架构
|
||||
|
||||
Mac Mini AI Control Center：
|
||||
|
||||
```
|
||||
Mac Mini
|
||||
│
|
||||
├─ OpenClaw Gateway
|
||||
├─ n8n
|
||||
└─ Telegram Bot
|
||||
|
||||
Agents
|
||||
│
|
||||
├─ orchestrator
|
||||
├─ dev
|
||||
├─ research
|
||||
├─ ops
|
||||
└─ data
|
||||
```
|
||||
|
||||
**数据流：**
|
||||
|
||||
```
|
||||
Telegram
|
||||
↓
|
||||
n8n Router
|
||||
↓
|
||||
OpenClaw
|
||||
↓
|
||||
Agents
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 14 高级玩法
|
||||
|
||||
**支持：**
|
||||
|
||||
### 多服务器 Agent
|
||||
|
||||
```
|
||||
Mac Mini
|
||||
orchestrator
|
||||
|
||||
Ubuntu Server
|
||||
dev agent
|
||||
|
||||
NAS
|
||||
data agent
|
||||
```
|
||||
|
||||
**通信：**
|
||||
|
||||
```
|
||||
HTTP
|
||||
Redis
|
||||
MQ
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 15 最佳实践
|
||||
|
||||
### 1 Agent 专业化
|
||||
|
||||
**正确：**
|
||||
|
||||
```
|
||||
dev-agent
|
||||
ops-agent
|
||||
research-agent
|
||||
```
|
||||
|
||||
**错误：**
|
||||
|
||||
```
|
||||
python-agent
|
||||
browser-agent
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2 模型分工
|
||||
|
||||
不要所有 agent 使用同一个模型。
|
||||
|
||||
**否则：**
|
||||
|
||||
```
|
||||
multi-agent ≈ single-agent
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3 Memory 分层
|
||||
|
||||
**推荐：**
|
||||
|
||||
```
|
||||
memory/
|
||||
├── system
|
||||
├── dev
|
||||
├── research
|
||||
└── ops
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 4 Router 统一入口
|
||||
|
||||
**不要：**
|
||||
|
||||
```
|
||||
Telegram → 各 agent
|
||||
```
|
||||
|
||||
**应该：**
|
||||
|
||||
```
|
||||
Telegram → Router → Agents
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 16 最终架构总结
|
||||
|
||||
**最终系统：**
|
||||
|
||||
```
|
||||
Telegram
|
||||
│
|
||||
▼
|
||||
n8n Router
|
||||
│
|
||||
▼
|
||||
OpenClaw Gateway
|
||||
│
|
||||
▼
|
||||
┌──────────────┬──────────────┬──────────────┐
|
||||
DevAgent ResearchAgent OpsAgent
|
||||
```
|
||||
|
||||
**系统特点：**
|
||||
|
||||
- 多 Agent
|
||||
- 多模型
|
||||
- 自动任务分发
|
||||
- Telegram 控制
|
||||
- 自动化工作流
|
||||
|
||||
---
|
||||
|
||||
# 17 未来扩展
|
||||
|
||||
**未来可扩展：**
|
||||
|
||||
- AI 自动任务
|
||||
- 自动服务器运维
|
||||
- 自动代码生成
|
||||
- 自动数据分析
|
||||
- 自动监控告警
|
||||
|
||||
**目标：** 构建 Personal AI Operations Center
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -1,194 +0,0 @@
|
||||
# OpenClaw Agent 管理指南
|
||||
|
||||
> 创建日期: 2026-03-15
|
||||
> 作者: 星曜
|
||||
|
||||
---
|
||||
|
||||
## 1. 创建新 Agent
|
||||
|
||||
### 基本命令
|
||||
|
||||
```bash
|
||||
openclaw agents add <agent-name> --non-interactive --workspace <workspace-path>
|
||||
```
|
||||
|
||||
### 参数说明
|
||||
|
||||
| 参数 | 说明 |
|
||||
| ------------------- | ----------------- |
|
||||
| `<agent-name>` | Agent 名称（唯一标识） |
|
||||
| `--non-interactive` | 跳过交互式提示，自动创建 |
|
||||
| `--workspace` | 指定 workspace 目录路径 |
|
||||
|
||||
### 示例
|
||||
|
||||
```bash
|
||||
# 创建名为 xinghui 的 agent
|
||||
openclaw agents add xinghui --non-interactive --workspace ~/.openclaw/workspace-agent-xinghui
|
||||
|
||||
# 创建名为 xingyao 的 agent（复制现有workspace）
|
||||
openclaw agents add xingyao --non-interactive --workspace ~/.openclaw/workspace-agent-xingyao
|
||||
```
|
||||
|
||||
### Workspace 路径规范
|
||||
|
||||
- 格式: `~/.openclaw/workspace-agent-<agent-name>`
|
||||
- 示例: `~/.openclaw/workspace-agent-xinghui`
|
||||
|
||||
---
|
||||
|
||||
## 2. 复制 Workspace 到新 Agent
|
||||
|
||||
### 场景
|
||||
创建一个与现有 agent（通常是 main）拥有相同内容的 workspace
|
||||
|
||||
### 方法一：rsync 复制（推荐）
|
||||
|
||||
```bash
|
||||
rsync -av --exclude='.git' /Users/weishen/.openclaw/workspace/ /Users/weishen/.openclaw/workspace-agent-xingyao/
|
||||
```
|
||||
|
||||
### 方法二：软链接共享记忆
|
||||
|
||||
如果想让多个 agent 共享记忆（MEMORY.md 和 memory/ 目录）：
|
||||
|
||||
```bash
|
||||
# 为新 agent 创建软链接
|
||||
ln -sf /Users/weishen/.openclaw/workspace/memory /Users/weishen/.openclaw/workspace-agent-<agent-name>/memory
|
||||
ln -sf /Users/weishen/.openclaw/workspace/MEMORY.md /Users/weishen/.openclaw/workspace-agent-<agent-name>/MEMORY.md
|
||||
```
|
||||
|
||||
**注意**: 共用 workspace 可能导致配置冲突，建议独立 workspace + 软链接共享 memory 目录
|
||||
|
||||
---
|
||||
|
||||
## 3. 绑定 Agent 到 Channel
|
||||
|
||||
### 查看当前绑定
|
||||
|
||||
```bash
|
||||
openclaw agents bindings
|
||||
```
|
||||
|
||||
### 绑定命令
|
||||
|
||||
```bash
|
||||
openclaw agents bind --agent <agent-name> --bind <channel>:<accountId>
|
||||
```
|
||||
|
||||
### 参数说明
|
||||
|
||||
| 参数 | 说明 |
|
||||
| -------------- | ----------------------------------- |
|
||||
| `<agent-name>` | 要绑定的 agent 名称 |
|
||||
| `<channel>` | 频道类型（telegram, discord, whatsapp 等） |
|
||||
| `<accountId>` | 账号 ID（数字形式） |
|
||||
|
||||
### 示例[[How to get Youtube Channel ID]]
|
||||
|
||||
```bash
|
||||
# 绑定 xinghui 到 Telegram
|
||||
openclaw agents bind --agent xinghui --bind telegram:5038825565
|
||||
|
||||
# 绑定 xingyao 到 Telegram
|
||||
openclaw agents bind --agent xingyao --bind telegram:5038825565
|
||||
```
|
||||
|
||||
### 解绑
|
||||
|
||||
```bash
|
||||
# 解绑指定 channel
|
||||
openclaw agents unbind --bind telegram:5038825565
|
||||
|
||||
# 解绑指定 agent 的 channel
|
||||
openclaw agents unbind --agent xinghui --bind telegram:5038825565
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. 删除 Agent
|
||||
|
||||
### 命令
|
||||
|
||||
```bash
|
||||
openclaw agents delete <agent-name>
|
||||
```
|
||||
|
||||
### 示例
|
||||
|
||||
```bash
|
||||
# 需要确认
|
||||
openclaw agents delete agent-macmini-001
|
||||
|
||||
# 强制删除（非交互模式）
|
||||
openclaw agents delete agent-macmini-001 --force
|
||||
```
|
||||
|
||||
### 删除效果
|
||||
- Workspace 目录移至废纸篓
|
||||
- Sessions 目录删除
|
||||
- 从配置文件移除
|
||||
|
||||
---
|
||||
|
||||
## 5. 查看 Agent 列表
|
||||
|
||||
```bash
|
||||
openclaw agents list
|
||||
```
|
||||
|
||||
### 输出示例
|
||||
|
||||
```
|
||||
Agents:
|
||||
- main (default)
|
||||
Workspace: ~/.openclaw/workspace
|
||||
Agent dir: ~/.openclaw/agents/main/agent
|
||||
Model: minimax-portal/MiniMax-M2.5
|
||||
Routing rules: 0
|
||||
Routing: default (no explicit rules)
|
||||
- xinghui
|
||||
Workspace: ~/.openclaw/workspace-agent-xinghui
|
||||
Agent dir: ~/.openclaw/agents/xinghui/agent
|
||||
Model: minimax-portal/MiniMax-M2.5
|
||||
Routing rules: 0
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Agent 配置说明
|
||||
|
||||
### 默认模型
|
||||
所有新创建的 agent 默认使用: `minimax-portal/MiniMax-M2.5`
|
||||
|
||||
### 配置文件位置
|
||||
- 主配置: `~/.openclaw/openclaw.json`
|
||||
- Agent 状态: `~/.openclaw/agents/<agent-name>/agent/`
|
||||
|
||||
---
|
||||
|
||||
## 7. 常用命令速查
|
||||
|
||||
| 操作 | 命令 |
|
||||
|------|------|
|
||||
| 创建 agent | `openclaw agents add <name> --non-interactive --workspace ~/.openclaw/workspace-agent-<name>` |
|
||||
| 查看列表 | `openclaw agents list` |
|
||||
| 查看绑定 | `openclaw agents bindings` |
|
||||
| 绑定 channel | `openclaw agents bind --agent <name> --bind telegram:<id>` |
|
||||
| 解绑 channel | `openclaw agents unbind --bind telegram:<id>` |
|
||||
| 删除 agent | `openclaw agents delete <name> --force` |
|
||||
|
||||
---
|
||||
|
||||
## 8. 当前已创建的 Agent
|
||||
|
||||
| Agent 名称 | Workspace | 状态 |
|
||||
|------------|-----------|------|
|
||||
| main | ~/.openclaw/workspace | 默认 |
|
||||
| xinghui | ~/.openclaw/workspace-agent-xinghui | 独立（无共享记忆） |
|
||||
| xingyao | ~/.openclaw/workspace-agent-xingyao | 完整复制 main workspace |
|
||||
|
||||
---
|
||||
|
||||
*最后更新: 2026-03-15 14:33*
|
||||
@@ -1,368 +0,0 @@
|
||||
|
||||
#ubuntu #openclaw #install #uninstall
|
||||
|
||||
```table-of-contents
|
||||
```
|
||||
|
||||
## 环境概述
|
||||
|
||||
- 系统：Ubuntu 20.04 / 22.04
|
||||
- OpenClaw 安装方式：npm 用户本地全局安装openclaw & clawhub (注意不要用root user安装)
|
||||
```
|
||||
npm install -g openclaw clawhub
|
||||
```
|
||||
- 用户路径示例：
|
||||
|
||||
```bash
|
||||
/home/shenwei/.npm-global/bin/openclaw
|
||||
```
|
||||
|
||||
- 默认配置目录：
|
||||
```bash
|
||||
/home/shenwei/.openclaw
|
||||
```
|
||||
|
||||
- 用户级 systemd 服务目录：
|
||||
```bash
|
||||
/home/shenwei/.config/systemd/user/openclaw-gateway.service
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 卸载旧版本 OpenClaw
|
||||
|
||||
1. **停止正在运行的进程 / 服务**
|
||||
```bash
|
||||
# 查找进程
|
||||
ps aux | grep openclaw
|
||||
|
||||
# 如果有 systemd 用户服务
|
||||
systemctl --user stop openclaw
|
||||
systemctl --user disable openclaw
|
||||
```
|
||||
|
||||
2. **卸载 npm 安装的 OpenClaw**
|
||||
```bash
|
||||
# 全局卸载
|
||||
sudo npm uninstall -g openclaw clawhub
|
||||
|
||||
# 或者局部卸载
|
||||
npm uninstall openclaw clawhub
|
||||
```
|
||||
|
||||
3. **删除用户配置目录**
|
||||
```bash
|
||||
rm -rf /home/shenwei/.openclaw # 普通用户
|
||||
sudo rm -rf /root/.openclaw # root 用户（如果曾用 sudo 运行）
|
||||
sudo rm -rf /opt/openclaw # 如果之前手动统一过目录
|
||||
```
|
||||
|
||||
4. **清理残留 npm 包**
|
||||
```bash
|
||||
npm list -g --depth=0 | grep openclaw
|
||||
npm list -g --depth=0 | grep clawhub
|
||||
```
|
||||
如有残留再执行 `npm uninstall -g <package>`。
|
||||
|
||||
---
|
||||
|
||||
## 安装 OpenClaw
|
||||
|
||||
### 方法 A：通过 npm 安装（推荐）
|
||||
|
||||
```bash
|
||||
# 确保 npm 更新
|
||||
npm install -g npm
|
||||
|
||||
# 全局安装 OpenClaw
|
||||
npm install -g openclaw clawhub
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 配置 PATH，让 OpenClaw 在任意位置可执行
|
||||
|
||||
1. 临时生效（仅当前终端）：
|
||||
```bash
|
||||
export PATH=$HOME/.npm-global/bin:$PATH
|
||||
```
|
||||
|
||||
2. 永久生效（推荐）：
|
||||
- 编辑 shell 配置文件 `~/.bashrc` 或 `~/.zshrc`，添加：
|
||||
```bash
|
||||
export PATH=$HOME/.npm-global/bin:$PATH
|
||||
```
|
||||
|
||||
- 刷新配置：
|
||||
```bash
|
||||
source ~/.bashrc # bash
|
||||
source ~/.zshrc # zsh
|
||||
```
|
||||
|
||||
- 验证：
|
||||
```bash
|
||||
which openclaw
|
||||
openclaw --version
|
||||
```
|
||||
---
|
||||
|
||||
## 用户级 systemd 服务管理（OpenClaw Gateway）
|
||||
|
||||
安装 Gateway 后会生成服务文件：
|
||||
```bash
|
||||
/home/shenwei/.config/systemd/user/openclaw-gateway.service
|
||||
```
|
||||
|
||||
``` bash
|
||||
[Unit]
|
||||
Description=OpenClaw Gateway (v2026.3.13)
|
||||
After=network-online.target
|
||||
Wants=network-online.target
|
||||
|
||||
[Service]
|
||||
ExecStart=/usr/bin/node /home/shenwei/.npm-global/lib/node_modules/openclaw/dist/index.js gateway --port 18789
|
||||
Restart=always
|
||||
RestartSec=5
|
||||
TimeoutStopSec=30
|
||||
TimeoutStartSec=30
|
||||
SuccessExitStatus=0 143
|
||||
KillMode=control-group
|
||||
Environment=HOME=/home/shenwei
|
||||
Environment=TMPDIR=/tmp
|
||||
Environment=HTTP_PROXY=http://127.0.0.1:10808
|
||||
Environment=HTTPS_PROXY=http://127.0.0.1:10808
|
||||
Environment=PATH=/home/shenwei/.local/bin:/home/shenwei/.npm-global/bin:/home/shenwei/bin:/home/shenwei/.volta/bin:/home/shenwei/.asdf/shims:/home/shenwei/.bun/bin:/>
|
||||
Environment=OPENCLAW_GATEWAY_PORT=18789
|
||||
Environment=OPENCLAW_SYSTEMD_UNIT=openclaw-gateway.service
|
||||
Environment="OPENCLAW_WINDOWS_TASK_NAME=OpenClaw Gateway"
|
||||
Environment=OPENCLAW_SERVICE_MARKER=openclaw
|
||||
Environment=OPENCLAW_SERVICE_KIND=gateway
|
||||
Environment=OPENCLAW_SERVICE_VERSION=2026.3.13
|
||||
|
||||
[Install]
|
||||
WantedBy=default.target
|
||||
|
||||
```
|
||||
|
||||
查看日志
|
||||
```
|
||||
|
||||
# 查看最近 50 行
|
||||
journalctl --user -u openclaw-gateway -n 50 --no-pager
|
||||
|
||||
# 实时跟踪日志
|
||||
journalctl --user -u openclaw-gateway -f
|
||||
|
||||
# 查看今天的所有日志
|
||||
journalctl --user -u openclaw-gateway --since today
|
||||
```
|
||||
|
||||
|
||||
### 常用管理命令
|
||||
|
||||
| 操作 | 命令 |
|
||||
| --------------------------- | ------------------------------------------- |
|
||||
| 启动 Gateway | `systemctl --user start openclaw-gateway` |
|
||||
| 停止 Gateway | `systemctl --user stop openclaw-gateway` |
|
||||
| 重启 Gateway | `systemctl --user restart openclaw-gateway` |
|
||||
| 查看状态 | `systemctl --user status openclaw-gateway` |
|
||||
| 开机自启 | `systemctl --user enable openclaw-gateway` |
|
||||
| 取消开机自启 | `systemctl --user disable openclaw-gateway` |
|
||||
| 刷新 systemd 配置（修改 service 后） | `systemctl --user daemon-reload` |
|
||||
|
||||
|
||||
> ⚠️ 用户级服务不需要 sudo，安全且方便。
|
||||
|
||||
---
|
||||
|
||||
## 多用户环境与避免重复环境
|
||||
|
||||
- OpenClaw 配置目录默认跟随 `$HOME`：
|
||||
|
||||
|用户|配置目录|
|
||||
|---|---|
|
||||
|shenwei|`/home/shenwei/.openclaw`|
|
||||
|root|`/root/.openclaw`|
|
||||
|
||||
- **原因**：Linux 用户隔离机制，不同用户运行 OpenClaw 会生成独立目录。
|
||||
- **注意**：
|
||||
|
||||
- 不要用 root 启动 OpenClaw，避免权限混乱
|
||||
- 统一使用普通用户安装和运行
|
||||
- 可通过 `--workdir /opt/openclaw` 指定统一目录
|
||||
|
||||
|
||||
---
|
||||
|
||||
## 常用命令总结
|
||||
|
||||
| 命令 | 功能 |
|
||||
| --------------------------------------------------------------------- | ------------- |
|
||||
| `openclaw onboard` | 初始化新环境、设置工作目录 |
|
||||
| `openclaw --version` | 查看版本 |
|
||||
| `openclaw agent list` | 列出所有 agent |
|
||||
| `openclaw agent create --name <agent_name> --message "<description>"` | 创建新的 agent |
|
||||
| `openclaw agent delete <agent_name>` | 删除 agent |
|
||||
| `openclaw skill install <skill_name>` | 安装技能 |
|
||||
| `openclaw skill update <skill_name>` | 更新技能 |
|
||||
| `openclaw skill list` | 查看已安装技能 |
|
||||
| `openclaw memory list` | 查看记忆数据 |
|
||||
| `openclaw workspace list` | 查看工作空间 |
|
||||
| | |
|
||||
| | |
|
||||
|
||||
---
|
||||
|
||||
## 创建 Agent 与绑定 Telegram Bot
|
||||
|
||||
1. **创建 agent**
|
||||
```
|
||||
openclaw agents add <agentname> --non-interactive --workspace /home/shenwei/.openclaw/workspace-agent-<agentname> --model MiniMax-M2.5
|
||||
|
||||
```
|
||||
举例：
|
||||
```bash
|
||||
openclaw agents add yunce --non-interactive --workspace /home/shenwei/.openclaw/workspace-agent-yunce --model MiniMax-M2.5
|
||||
```
|
||||
|
||||
2. **添加Telegram 账号**
|
||||
```
|
||||
# 添加 Telegram 账号
|
||||
openclaw channels add --channel telegram --account <账号名> --token <BotToken>
|
||||
```
|
||||
举例
|
||||
```
|
||||
openclaw channels add --channel telegram --account yunhan --token 8588117769:AAFxswhHgCdBor2EOa-2oChDpI-DADRt0tQ
|
||||
```
|
||||
3. **查看 agent 列表**
|
||||
```bash
|
||||
openclaw agents list
|
||||
```
|
||||
|
||||
3. **绑定 Bot**
|
||||
```
|
||||
# 绑定 agent 到 Telegram 账号
|
||||
openclaw agents bind --agent <agent_id> --bind telegram:<account_name>
|
||||
|
||||
```
|
||||
举例
|
||||
```
|
||||
openclaw agents bind --agent yunhan --bind telegram:yunhan
|
||||
```
|
||||
|
||||
- 配置完成后重启 Gateway：
|
||||
```bash
|
||||
systemctl --user restart openclaw-gateway
|
||||
```
|
||||
|
||||
- Telegram 多 Agent 建议：
|
||||
|
||||
- 一个 bot → n8n 路由 → 多 agent
|
||||
- 避免每个 agent 都创建独立 bot（每个账号最多 20 个 bot）
|
||||
- 用命令或路径路由区分不同 agent 功能
|
||||
|
||||
---
|
||||
|
||||
## 删除Agent
|
||||
1. **删除 agent**
|
||||
```
|
||||
openclaw agents delete <agent_name> --force
|
||||
```
|
||||
2. **删除bot**
|
||||
```
|
||||
# 删除 Telegram 账号
|
||||
openclaw channels remove --channel telegram --account <account_name> --delete
|
||||
```
|
||||
|
||||
## 注意事项与避免的坑
|
||||
|
||||
1. **避免使用 root 运行**
|
||||
- root 会生成 `/root/.openclaw`，和普通用户环境冲突
|
||||
- 权限问题可能导致 agent 无法访问工作空间
|
||||
2. **避免重复 PATH 或多版本冲突**
|
||||
- 如果 npm 本地 bin 不在 PATH，会导致命令找不到
|
||||
- 如果 PATH 里还有旧版本系统全局安装路径，可能会调用错误版本
|
||||
3. **用户级 systemd 服务管理**
|
||||
- 修改 service 后必须执行 `systemctl --user daemon-reload`
|
||||
- 避免 sudo 启动服务，保证文件权限正确
|
||||
4. **Telegram Bot 限制**
|
||||
- 每个账号最多创建 20 个 bot（Premium 账号可能 40 个）
|
||||
- 多 agent 架构建议一个 bot → n8n → 多 agent 路由
|
||||
5. **统一工作目录**
|
||||
- 推荐 `/home/shenwei/.openclaw` 或 `/opt/openclaw`
|
||||
- 方便多服务器或多 agent 管理
|
||||
6. **升级和维护**
|
||||
- 升级前先备份 `.openclaw` 下的 workspace、skills、memory
|
||||
- 使用 npm 全局安装可直接 `npm install -g openclaw@latest`
|
||||
|
||||
---
|
||||
|
||||
### 参考架构示意
|
||||
|
||||
```
|
||||
Telegram Bot
|
||||
↓
|
||||
n8n Router
|
||||
↓
|
||||
OpenClaw Agents
|
||||
├─ 星枢（调度）
|
||||
├─ 星曜（IT管家）
|
||||
├─ 星辉（个人助理）
|
||||
└─ 云瀚（监控）
|
||||
```
|
||||
|
||||
|
||||
### Bot & Agent 命名
|
||||
|
||||
#### 星
|
||||
|
||||
```
|
||||
openclaw channels add --channel telegram --account xingshu --token 8787024183:AAG1M5tfSHj6Z0gMv3vvCZel2FOIX-0x8ZI
|
||||
|
||||
openclaw channels add --channel telegram --account xingyao --token 8414432613:AAG9hvKfILGSsbc1EMEZW1QVym9Quc5aHWk
|
||||
|
||||
openclaw channels add --channel telegram --account xinghui --token 8709222939:AAEfvZrvvU5vZFsmacsR5nmpkJ2Jb5JgfRg
|
||||
|
||||
```
|
||||
|
||||
| 服务器 | 角色 | Bot Name | Bot Key | Agent Id | Telegram User ID |
|
||||
| ------- | --- | ---------------------------- | ---------------------------------------------- | -------- | ---------------- |
|
||||
| macmini | 星枢 | @shenwei_macmini_xingshu_bot | 8787024183:AAG1M5tfSHj6Z0gMv3vvCZel2FOIX-0x8ZI | main | 5038825565 |
|
||||
| macmini | 星曜 | @shenwei_macmini_xingyao_bot | 8414432613:AAG9hvKfILGSsbc1EMEZW1QVym9Quc5aHWk | xingyao | 5038825565 |
|
||||
| macmini | 星辉 | @shenwei_macmini_xinghui_bot | 8709222939:AAEfvZrvvU5vZFsmacsR5nmpkJ2Jb5JgfRg | xinghui | 5038825565 |
|
||||
| | | | | | |
|
||||
#### 云
|
||||
|
||||
```
|
||||
openclaw channels add --channel telegram --account yunhan --token 8588117769:AAFxswhHgCdBor2EOa-2oChDpI-DADRt0tQ
|
||||
|
||||
openclaw channels add --channel telegram --account yunce --token 8791231082:AAFKPfTPy3LshybWUJ0joBkz3Th3mwYQOnc
|
||||
|
||||
openclaw channels add --channel telegram --account yunjiang --token 8727937702:AAGw3WGPI1j5rSD97wap6h9EGqVpDEMdjLU
|
||||
|
||||
openclaw channels add --channel telegram --account yunzhi --token 8639619464:AAEI35Dnt-9PQ8y4Du_ToxVhwUBUa5kpLjU
|
||||
```
|
||||
|
||||
| 服务器 | 角色 | Bot Name | Bot Key | Agent 名称 | Telegram User ID |
|
||||
| ------- | --- | ----------------------------- | ---------------------------------------------- | -------- | ---------------- |
|
||||
| ubuntu2 | 云瀚 | @shenwei_ubuntu2_yunhan_bot | 8588117769:AAFxswhHgCdBor2EOa-2oChDpI-DADRt0tQ | yunhan | 5038825565 |
|
||||
| ubuntu2 | 云策 | @shenwei_ubuntu2_yunce_bot | 8791231082:AAFKPfTPy3LshybWUJ0joBkz3Th3mwYQOnc | yunce | 5038825565 |
|
||||
| ubuntu2 | 云匠 | @shenwei_ubuntu2_yunjiang_bot | 8727937702:AAGw3WGPI1j5rSD97wap6h9EGqVpDEMdjLU | yunjiang | 5038825565 |
|
||||
| ubuntu2 | 云织 | @shenwei_ubuntu2_yunzhi_bot | 8639619464:AAEI35Dnt-9PQ8y4Du_ToxVhwUBUa5kpLjU | yunzhi | 5038825565 |
|
||||
|
||||
|
||||
#### 风
|
||||
|
||||
```
|
||||
openclaw channels add --channel telegram --account fengheng --token
|
||||
|
||||
openclaw channels add --channel telegram --account fengchi --token
|
||||
|
||||
openclaw channels add --channel telegram --account fengji --token
|
||||
```
|
||||
|
||||
| 服务器 | 角色 | Bot Name | Bot Key | Agent 名称 | Telegram User ID |
|
||||
| ------- | --- | ----------------------------- | ------- | -------- | ---------------- |
|
||||
| ubuntu1 | 风衡 | @shenwei_ubuntu1_fengheng_bot | | fengheng | 5038825565 |
|
||||
| ubuntu1 | 风驰 | @shenwei_ubuntu1_fengchi_bot | | fengchi | 5038825565 |
|
||||
| ubuntu1 | 风纪 | @shenwei_ubuntu1_fengji_bot | | fengji | 5038825565 |
|
||||
Reference in New Issue
Block a user