diff --git a/kb/README.md b/kb/README.md new file mode 100644 index 0000000..6a26af9 --- /dev/null +++ b/kb/README.md @@ -0,0 +1,16 @@ +# 小德知识库 + +## 目录结构 + +``` +kb/ +├── setup/ # 初始部署 & 安装记录 +│ └── 2026-06-25-初始部署.md +└── ops/ # 运维速查 + └── quickref.md +``` + +## 知识库索引 + +- [初始部署日志](setup/2026-06-25-初始部署.md) — 2026-06-25 首日所有安装和配置记录 +- [运维速查](ops/quickref.md) — 飞书白名单、Git 推送、Ollama 等常用操作 diff --git a/kb/ops/quickref.md b/kb/ops/quickref.md new file mode 100644 index 0000000..e410b51 --- /dev/null +++ b/kb/ops/quickref.md @@ -0,0 +1,47 @@ +# 运维速查 — Ops Quick Reference + +## 飞书白名单管理 + +```bash +# 查看当前白名单 +python3 -c " +import json +d = json.load(open('/root/.openclaw/openclaw.json')) +print(d['channels']['feishu']['allowFrom']) +" + +# 添加用户(需要 open_id) +# 编辑 ~/.openclaw/openclaw.json → channels.feishu.allowFrom +# 添加后无需重启,配置热加载生效 +``` + +## Git 推送 + +```bash +cd /root/.openclaw/workspace +git add -A +git commit -m "更新说明" +git push +``` + +## Ollama + +```bash +# 查看模型 +ollama list + +# 拉取模型 +ollama pull <模型名> + +# 推理测试 +ollama run qwen2.5:7b "你好" +``` + +## 系统维护 + +```bash +# Gateway 状态 +openclaw gateway status + +# 查看日志(飞书/网关) +journalctl -u openclaw --no-pager -n 50 diff --git a/kb/setup/2026-06-25-初始部署.md b/kb/setup/2026-06-25-初始部署.md new file mode 100644 index 0000000..6062c21 --- /dev/null +++ b/kb/setup/2026-06-25-初始部署.md @@ -0,0 +1,107 @@ +# 初始部署日志 — 2026-06-25 + +> 服务器:RH1288 V3(华为)| Ubuntu 24.04 x86_64 | 15GB RAM / 无 GPU + +--- + +## 1. OpenClaw 环境初始化 + +- 网关服务已运行,嵌入模式(`/usr/bin/node /usr/lib/node_modules/openclaw/dist/index.js gateway --port 18789`) +- Agent 身份已配置:小德("小德"),老大为中国时区用户 +- 飞书(Feishu/Lark)渠道已对接,WebSocket 直连模式 + +### 飞书渠道配置 + +| 参数 | 值 | +|------|-----| +| appId | `cli_aab626c98ab85cb1` | +| 连接方式 | `websocket` | +| 域名 | `feishu` | +| 私聊策略 | `allowlist`(白名单) | +| 群聊策略 | `open`(开放) | +| 群聊需@ | `true` | + +### 白名单变更 + +- `ou_d0aebfafffd8333f6a778f54cb786366` — 老大(初始) +- `ou_87bb3bfebdc779277b1371062427c412` — 张凯(2026-06-25 19:32 添加) + +> 配置文件:`~/.openclaw/openclaw.json` → `channels.feishu.allowFrom` + +--- + +## 2. Ollama 安装 + +**版本:** v0.30.10 + +### 安装方式 + +由于服务器上 `github.com` 不可达(DNS/网络策略阻挡),绕道安装: +1. 通过 `api.github.com` 获取最新 Release asset ID +2. 从 GitHub CDN(`release-assets.githubusercontent.com`)直接下载免安装包 +3. 解压部署到 `/usr/local/bin/ollama` + `/usr/local/lib/ollama/` + +### 服务配置 + +- **运行用户:** `ollama`(system 用户) +- **systemd 服务:** `/etc/systemd/system/ollama.service` +- **监听地址:** `0.0.0.0:11434` + +### 已拉取模型 + +| 模型 | 大小 | 状态 | +|------|------|------| +| Qwen2.5:7B | ~4.7GB | ✅ 已下载 | + +> 下载过程出现过网络中断重连,Ollama 支持断点续传。 + +--- + +## 3. Git 远程仓库 — Gitea + +### 服务器信息 + +| 项目 | 内容 | +|------|------| +| 地址 | `https://git.szdego.cn` | +| 类型 | Gitea v1.26.4 | +| 账号 | `admin`(wfq323@hotmail.com) | +| IP | `8.155.27.249` | + +### 已知问题 + +- **SSL 证书域名不匹配:** 服务器证书注册为 `log.collectpublish.net`,与访问域名 `git.szdego.cn` 不符 +- **已处理:** Git 配置中跳过该域名 SSL 验证 + ```bash + git config --global http.https://git.szdego.cn/.sslVerify false + ``` + +### 已创建的仓库 + +| 仓库名 | 说明 | URL | +|--------|------|-----| +| `xdeSpace` | OpenClaw 工作空间备份 | `https://git.szdego.cn/admin/xdeSpace.git` | + +### Token 存储 + +- Token 已存入 `~/.git-credentials`(权限 600) +- Git credential helper: `store` +- 认证方式:`oauth2:${TOKEN}`(Gitea 标准) + +--- + +## 4. 系统网络备注 + +- `github.com` 的 443 端口不可达(被墙) +- `api.github.com` ✅ 可达 +- `raw.githubusercontent.com` ✅ 可达 +- `release-assets.githubusercontent.com` ✅ 可达(GitHub Release CDN) +- 其他 HTTPS 网站 ✅ 正常 + +--- + +## 5. 待办 / 注意事项 + +- [ ] 如需新增飞书白名单用户,从日志捞 ID 加入 `openclaw.json` +- [ ] Ollama 模型可补充拉取(DeepSeek-R1、Llama3 等) +- [ ] Gitea 证书问题建议联系运维修复