vault: add OpenClaw deployment analysis and agent configuration notes
- OpenClaw 部署配置分析: server info, channels, cron, known issues - OpenClaw Agent 配置详情: multi-agent architecture, bindings, roles
This commit is contained in:
Yaojia Wang
97
2 - Projects/OpenClaw/OpenClaw Agent 配置详情.md
Normal file
97
2 - Projects/OpenClaw/OpenClaw Agent 配置详情.md
Normal file
@@ -0,0 +1,97 @@
|
||||
---
|
||||
created: "2026-03-19 17:00"
|
||||
type: project
|
||||
status: active
|
||||
tags: [openclaw, ai-agent, discord, multi-agent]
|
||||
source: "ssh yiukai@192.168.68.108 ~/.openclaw/openclaw.json"
|
||||
---
|
||||
|
||||
# OpenClaw Agent 配置详情
|
||||
|
||||
## 多 Agent 协作架构
|
||||
|
||||
```
|
||||
┌─────────────┐
|
||||
│ 你 (Owner) │
|
||||
│ 964122...286 │
|
||||
└──────┬──────┘
|
||||
│
|
||||
┌────────────┼────────────┐
|
||||
v v v
|
||||
┌────────────┐ ┌────────────┐ ┌──────────────┐
|
||||
│ 主 Guild │ │ Stock Guild │ │ Telegram │
|
||||
│ ds-* agents │ │ invest-* │ │ (pairing) │
|
||||
└────────────┘ └────────────┘ └──────────────┘
|
||||
```
|
||||
|
||||
## 主 Guild Agent 协作
|
||||
|
||||
5 个 ds-* agent 在同一 Discord guild 中协作:
|
||||
|
||||
```
|
||||
ds-commander (大统领) ──────┐
|
||||
│ │
|
||||
├── ds-strategist (智库) │ agent-to-agent
|
||||
├── ds-builder (牛马) │ 通信已启用
|
||||
├── ds-creator (作家) │
|
||||
└── ds-guardian (大法官) ─┘
|
||||
```
|
||||
|
||||
### 交互方式
|
||||
|
||||
- 所有 agent 在主 guild 的同一频道工作
|
||||
- 通过 `@mention` 触发特定 agent (`requireMention: true`)
|
||||
- 支持的 mention 模式:
|
||||
- Discord mention: `<@!botId>` 或 `<@botId>`
|
||||
- 中文名称: 大统领、智库、牛马、作家、大法官
|
||||
- 纯 ID: bot user ID
|
||||
|
||||
### 各 Agent 定位
|
||||
|
||||
| Agent | 角色定位 | 适用场景 |
|
||||
|-------|---------|---------|
|
||||
| 大统领 | 总指挥，任务分配 | 复杂任务协调、决策 |
|
||||
| 智库 | 战略分析师 | 策略规划、数据分析、方案比较 |
|
||||
| 牛马 | 执行者/开发者 | 编码实现、脚本编写、自动化 |
|
||||
| 作家 | 内容创作者 | 文档编写、报告生成、创意输出 |
|
||||
| 大法官 | 审核者/守护者 | 代码审查、质量把控、合规检查 |
|
||||
|
||||
## 投资分析师 (独立)
|
||||
|
||||
- **Guild**: Stock (`1479926167141355560`)
|
||||
- **频道**: general (`1479926167736942774`)
|
||||
- **触发**: 不需要 mention (`requireMention: false`)
|
||||
- **定时**: 工作日 08:00 自动生成投资简报
|
||||
- **技能**: invest-api
|
||||
|
||||
## 模型配置
|
||||
|
||||
所有 agent 统一使用 `kimi-coding/k2p5`:
|
||||
- 别名: Kimi Code
|
||||
- 提供商: kimi-coding
|
||||
|
||||
备选模型: `google-antigravity/claude-opus-4-6-thinking`
|
||||
- 通过 Google Antigravity OAuth 认证
|
||||
|
||||
## Bindings (路由绑定)
|
||||
|
||||
```json
|
||||
agentId: "ds-commander" → channel: "discord", accountId: "commander"
|
||||
agentId: "ds-strategist" → channel: "discord", accountId: "strategist"
|
||||
agentId: "ds-builder" → channel: "discord", accountId: "builder"
|
||||
agentId: "ds-creator" → channel: "discord", accountId: "creator"
|
||||
agentId: "ds-guardian" → channel: "discord", accountId: "guardian"
|
||||
agentId: "invest-analyst"→ channel: "discord", accountId: "invest-analyst"
|
||||
```
|
||||
|
||||
每个 agent 绑定一个独立的 Discord bot 账户，实现一对一映射。
|
||||
|
||||
## Session 配置
|
||||
|
||||
- **可见性**: all (所有 session 对工具可见)
|
||||
- **压缩模式**: safeguard
|
||||
|
||||
## Related
|
||||
|
||||
- [[OpenClaw 部署配置分析]]
|
||||
- [[OpenClaw-Skill-Reference]]
|
||||
168
2 - Projects/OpenClaw/OpenClaw 部署配置分析.md
Normal file
168
2 - Projects/OpenClaw/OpenClaw 部署配置分析.md
Normal file
@@ -0,0 +1,168 @@
|
||||
---
|
||||
created: "2026-03-19 17:00"
|
||||
type: project
|
||||
status: active
|
||||
tags: [openclaw, ai-gateway, discord, homelab, deployment]
|
||||
source: "ssh yiukai@192.168.68.108 ~/.openclaw/"
|
||||
---
|
||||
|
||||
# OpenClaw 部署配置分析
|
||||
|
||||
## 服务器信息
|
||||
|
||||
| 项目 | 值 |
|
||||
|------|-----|
|
||||
| 主机 | `192.168.68.108` (yiukai-ubuntu) |
|
||||
| 用户 | `yiukai` |
|
||||
| OpenClaw 版本 | 2026.2.13 |
|
||||
| 最新可用版本 | 2026.3.13 |
|
||||
| Node.js 版本 | v18.19.1 (推荐 v22.16+ 或 v24) |
|
||||
| 运行方式 | systemd user service (`openclaw-gateway.service`) |
|
||||
| 运行时长 | 自 2026-03-15 起 |
|
||||
| 内存占用 | ~633 MB |
|
||||
| Gateway 端口 | 18789 |
|
||||
| 绑定模式 | LAN |
|
||||
| 认证方式 | Token |
|
||||
| 配置文件 | `~/.openclaw/openclaw.json` |
|
||||
|
||||
## Agent 架构
|
||||
|
||||
### 默认配置
|
||||
|
||||
- **主模型**: `kimi-coding/k2p5` (Kimi Code)
|
||||
- **备选模型**: `google-antigravity/claude-opus-4-6-thinking`
|
||||
- **压缩模式**: safeguard
|
||||
- **Agent 间通信**: 已启用 (ds-* 系列)
|
||||
|
||||
### Agent 列表
|
||||
|
||||
| ID | 名称 | 角色 | Discord 账户 | Workspace |
|
||||
|----|------|------|-------------|-----------|
|
||||
| `main` | (默认) | 通用 agent | - | `~/.openclaw/workspace` |
|
||||
| `ds-commander` | 大统领 | 领导/协调 | commander | `workspace-ds-commander` |
|
||||
| `ds-strategist` | 智库 | 策略/分析 | strategist | `workspace-ds-strategist` |
|
||||
| `ds-builder` | 牛马 | 实施/构建 | builder | `workspace-ds-builder` |
|
||||
| `ds-creator` | 作家 | 内容创作 | creator | `workspace-ds-creator` |
|
||||
| `ds-guardian` | 大法官 | 监督/审查 | guardian | `workspace-ds-guardian` |
|
||||
| `invest-analyst` | 投资分析师 | 投资分析 | invest-analyst | `workspace-invest-analyst` |
|
||||
|
||||
### Agent 间通信规则
|
||||
|
||||
`agentToAgent` 允许列表: ds-commander, ds-strategist, ds-builder, ds-creator, ds-guardian
|
||||
|
||||
invest-analyst 不在 agent-to-agent 通信列表中，独立运作。
|
||||
|
||||
## 渠道配置
|
||||
|
||||
### Discord
|
||||
|
||||
6 个 bot 账户，每个绑定一个 agent:
|
||||
|
||||
**主 Guild** (`1475225167423602841`):
|
||||
- 5 个 ds-* bot，全部 `requireMention: true`
|
||||
- 所有 bot 共享同一频道 `1475225168635887776`
|
||||
- 用户白名单: 你的账号 + 6 个 bot 互相可见
|
||||
- streaming: off
|
||||
|
||||
**Stock Guild** (`1479926167141355560`):
|
||||
- invest-analyst bot，`requireMention: false`
|
||||
- 频道 `1479926167736942774` (general)
|
||||
- streaming: off
|
||||
|
||||
### Telegram
|
||||
|
||||
- 已启用
|
||||
- DM 策略: pairing
|
||||
- 群组策略: allowlist
|
||||
- streaming: partial
|
||||
|
||||
## 定时任务 (Cron)
|
||||
|
||||
| 任务 | 调度 | Agent | 投递方式 |
|
||||
|------|------|-------|----------|
|
||||
| daily-invest-briefing | 工作日 08:00 (Stockholm) | invest-analyst | Discord channel:1479926167736942774 |
|
||||
|
||||
**任务内容**: 生成每日投资简报 -- 检查投资组合、分析宏观经济、汇总持仓新闻情绪、标记财报日期、给出买卖建议。
|
||||
|
||||
## Hooks
|
||||
|
||||
内部 hooks 已启用:
|
||||
- `boot-md` -- 启动时加载 markdown
|
||||
- `bootstrap-extra-files` -- 额外启动文件
|
||||
- `command-logger` -- 命令日志
|
||||
- `session-memory` -- 会话记忆
|
||||
|
||||
## Skills
|
||||
|
||||
| 技能 | 路径 |
|
||||
|------|------|
|
||||
| invest-api | `~/.openclaw/skills/invest-api` |
|
||||
| openclaw-operator | `~/.openclaw/skills/openclaw-operator` |
|
||||
|
||||
## Plugins
|
||||
|
||||
| 插件 | 状态 |
|
||||
|------|------|
|
||||
| telegram | 已启用 |
|
||||
| discord | 已启用 |
|
||||
| google-antigravity-auth | 已启用 |
|
||||
|
||||
## Gateway 配置
|
||||
|
||||
- **控制 UI 允许来源**: localhost:18789, 127.0.0.1:18789, claw.colacoder.com
|
||||
- **信任代理**: 192.168.68.70
|
||||
- **Tailscale**: 关闭
|
||||
- **禁用移动节点命令**: camera.snap, camera.clip, screen.record, calendar.add, contacts.add, reminders.add
|
||||
|
||||
## 已知问题
|
||||
|
||||
### 1. 版本过旧
|
||||
- 当前: 2026.2.13
|
||||
- 最新: 2026.3.13
|
||||
- 建议: `openclaw update` 或 `npm install -g openclaw@latest`
|
||||
|
||||
### 2. Node.js 版本过低
|
||||
- 当前: v18.19.1
|
||||
- 推荐: v22.16+ LTS 或 v24
|
||||
- 风险: 可能缺少新功能支持
|
||||
|
||||
### 3. Cron 投递失败
|
||||
- `lastDeliveryStatus: "not-delivered"`
|
||||
- Agent 执行成功 (`lastRunStatus: "ok"`)，但消息未投递到 Discord
|
||||
- 需要排查 Discord 频道权限或 bot 连接状态
|
||||
|
||||
### 4. invest-analyst 健康问题
|
||||
- Health monitor 检测到 stuck 并自动重启
|
||||
- 日志: `health-monitor: restarting (reason: stuck)`
|
||||
- 可能原因: 模型响应超时、Discord 连接不稳定
|
||||
|
||||
### 5. 密钥管理
|
||||
- Discord bot tokens 明文存储在 `openclaw.json`
|
||||
- Kimi API key 在 `env` 字段中明文存储
|
||||
- `.env` 文件存在但未完全迁移
|
||||
- 建议: 将所有密钥迁移到环境变量
|
||||
|
||||
### 6. 遗留 Workspace
|
||||
存在不再使用的 workspace 目录:
|
||||
- `workspace-ds-lingce`
|
||||
- `workspace-ds-linggong`
|
||||
- `workspace-ds-linghe`
|
||||
- `workspace-ds-lingwen`
|
||||
- `workspace-ds-lingzong`
|
||||
|
||||
这些 agent 已不在配置中，workspace 可以清理。
|
||||
|
||||
## 待办
|
||||
|
||||
- [ ] 升级 OpenClaw 到 2026.3.13
|
||||
- [ ] 升级 Node.js 到 v22 LTS
|
||||
- [ ] 排查 cron 投递失败问题
|
||||
- [ ] 调查 invest-analyst stuck 原因
|
||||
- [ ] 将密钥迁移到环境变量
|
||||
- [ ] 清理遗留 workspace 目录
|
||||
|
||||
## Related
|
||||
|
||||
- [[OpenClaw-Skill-Reference]]
|
||||
- [[OpenClaw Agent 配置详情]]
|
||||
- [[家庭网络基础设施]]
|
||||
Reference in New Issue
Block a user