kai/knowledge-base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Re-structure

Browse Source
This commit is contained in:
Yaojia Wang
2026-03-21 11:31:31 +01:00
parent e61baf7e4e
commit cdba2497a7
30 changed files with 299 additions and 251 deletions
Download Patch File Download Diff File Expand all files Collapse all files

96
4 - Resources/OpenClaw/OpenClaw Agent 配置详情.md Normal file
View File

@@ -0,0 +1,96 @@
---
created: "2026-03-19 17:00"
type: resource
tags: [resource, openclaw, ai-agent, discord, multi-agent, homelab]
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]]

167
4 - Resources/OpenClaw/OpenClaw 部署配置分析.md Normal file
View File

@@ -0,0 +1,167 @@
---
created: "2026-03-19 17:00"
type: resource
tags: [resource, 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 配置详情]]
- [[家庭网络基础设施]]

111
4 - Resources/OpenClaw/OpenClaw-Skill-Reference.md Normal file
View File

@@ -0,0 +1,111 @@
---
created: "2026-03-10"
type: resource
tags: [resource, openclaw, ai-gateway, claude-code, skill, homelab]
source: "https://docs.openclaw.ai/"
---
# OpenClaw Skill 参考
## 概述
OpenClaw 是一个自托管的 AI 网关，将聊天应用（WhatsApp、Telegram、Discord、Slack、Signal、iMessage 等 20+ 渠道）连接到 AI 编码代理。基于 Node.js 22+，使用 WebSocket 控制平面。
- 配置文件: `~/.openclaw/openclaw.json`（JSON5 格式，热重载）
- 默认端口: `18789`
- 本地仓库: `C:\Users\yaoji\git\OpenSource\openclaw`
- 文档: https://docs.openclaw.ai/
- Claude Code Skill 位置: `~/.claude/skills/openclaw/SKILL.md`
## Skill 覆盖内容
### 核心操作
| 模块 | 功能 | 关键命令 |
|------|------|----------|
| Gateway | 启动/停止/重启/状态/服务安装 | `openclaw gateway run/start/stop/restart/status` |
| 配置 | JSON5 配置读写/验证/向导 | `openclaw config get/set/unset/validate` |
| Agent | 多 agent 隔离/路由绑定/身份 | `openclaw agents add/bind/unbind/list` |
| Session | 会话列表/清理/作用域管理 | `openclaw sessions/cleanup` |
### 通讯渠道
| 模块 | 功能 | 关键命令 |
|------|------|----------|
| Channel | 添加/登录/状态/能力探测 | `openclaw channels add/login/status/capabilities` |
| Message | 发送/回复/投票/反应/广播/线程 | `openclaw message send/poll/react/broadcast` |
### 扩展能力
| 模块 | 功能 | 关键命令 |
|------|------|----------|
| Skills | 列出/检查 agent 技能 | `openclaw skills list/info/check` |
| Plugins | 安装/启用/更新/卸载 | `openclaw plugins install/enable/update` |
| Hooks（内部） | 事件驱动自动化 | `openclaw hooks list/enable/disable` |
| Webhooks（外部） | HTTP 触发 agent | `POST /hooks/wake`, `POST /hooks/agent` |
| Cron | 定时任务 | `openclaw cron add/edit` |
### API 与集成
- **OpenAI 兼容 API**: `POST /v1/chat/completions`（需开启）
- **RPC 调用**: `openclaw gateway call <method>`
- **25+ 模型提供商**: Anthropic、OpenAI、Ollama、OpenRouter、Bedrock 等
## 关键配置结构
```
openclaw.json
├── identity # 名称/主题/表情
├── agents # agent 列表/默认值/workspace/model/skills
├── channels # 各渠道配置（whatsapp/telegram/discord/slack...）
├── session # 作用域/重置/维护
├── skills # 技能条目/加载/安装
├── plugins # 插件条目/允许/拒绝
├── tools # web/browser/canvas/media
├── gateway # 端口/绑定/认证/HTTP端点
├── hooks # webhook + 内部钩子
├── cron # 定时任务
├── acp # Agent Control Protocol
├── logging # 日志级别/脱敏
└── env # 环境变量
```
## Bootstrap 文件
放在 agent workspace 根目录:
- `AGENTS.md` - 操作指令 + 记忆
- `SOUL.md` - 人格/边界/语气
- `TOOLS.md` - 用户工具说明
- `BOOTSTRAP.md` - 一次性引导（运行后删除）
- `IDENTITY.md` - agent 名称/风格
- `USER.md` - 用户画像
## SKILL.md 格式（创建自定义技能）
```markdown
---
name: my-skill
description: 技能描述
requires:
bins: [node]
env: [API_KEY]
install:
- kind: node
package: my-package
---
# 技能说明和工具定义
```
## 常见工作流
1. **初始化**: `npm install -g openclaw@latest && openclaw onboard --install-daemon`
2. **添加渠道**: `openclaw channels add --channel telegram --token TOKEN`
3. **多 agent**: `openclaw agents add work --workspace ~/.openclaw/workspace-work`
4. **API 触发**: `curl -X POST http://127.0.0.1:18789/hooks/agent -H 'Authorization: Bearer TOKEN' -d '{"message":"..."}'`
5. **诊断**: `openclaw doctor --fix && openclaw status --deep`
## Related
- [[Claude Code 配置]]
- [[AI 工具链]]