Nanobot Custom

Nanobot自定义图像

用于具有MCP服务器、Google Workspace API访问、GitHub CLI和Nextcloud同步的纳米机器人的自定义Docker映像。

包含内容

用法

拉

docker pull ghcr.io/orrinwitt/nanobot-custom:latest

跑

docker run -d \
  --name nanobot \
  -v /path/to/nanobot-data:/root/.nanobot \
  ghcr.io/orrinwitt/nanobot-custom:latest

注： 仅 /root/.nanobot 需要安装。所有工具都包含在图像中。

MCP服务器配置

MCP服务器通过以下方式运行 npx （无需全局安装，自动缓存）：

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "@mauricio.wolff/mcp-obsidian", "/root/.nanobot/workspace/vault"],
      "transport": "stdio",
      "disabled": false
    },
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"],
      "transport": "stdio",
      "disabled": false
    }
  }
}

自动更新

此图像会自动检查来自的新版本 香港科技大学/纳米机器人 每日：

• 日程：每天早上6点UTC（美国东部时间凌晨1点）
• 过程：检测新版本→ 更新Dockerfile→ 构建图像→ 通过电报通知
• 手动触发：转到操作→ “上游自动更新”→ 运行工作流

手动更新

要手动更新到特定版本，请执行以下操作：

1. 更新 NANOBOT_VERSION 在 Dockerfile
2. 将更改推送到GitHub
3. GitHub Actions将自动构建并推送新镜像

或者在本地构建：

docker build --build-arg NANOBOT_VERSION=v0.1.5 -t ghcr.io/orrinwitt/nanobot-custom:latest .
docker push ghcr.io/orrinwitt/nanobot-custom:latest

卷

仅 /root/.nanobot 需要作为卷安装。所有工具都包含在图像中。

Nextcloud同步

使用以下方式将保管库同步到Nextcloud nextcloudcmd:

nextcloudcmd --non-interactive --trust \
  -u 'USERNAME' -p 'PASSWORD' \
  --path 'NanobotMemory' \
  /root/.nanobot/workspace/vault \
  'https://nextcloud.flwitts.us'

Google Workspace API访问（gws）

这 gws CLI提供对Google服务（Gmail、日历、任务、驱动器、文档、表格、幻灯片）的访问：

# Authenticate
gws auth login

# Example: list emails
gws gmail list

# Example: list calendar events
gws calendar list

请参阅：https://github.com/googleworkspace/cli

织物（AI增强图案）

fabric 提供257多种AI模式用于文本转换、摘要、分析等：

# List available patterns
fabric --list

# Use a pattern
echo "content" | fabric --pattern summarize
cat file.txt | fabric --pattern extract_wisdom

模式存储器

优点：

• 无启动时间下载延迟（模式已在映像中）
• 自定义模式在容器重建过程中持续存在
• 背景更新检查使模式保持最新

配置

结构通过以下方式配置 ~/.config/fabric/.env （安装自 /root/.nanobot/workspace/secrets/fabric.env):

OPENAI_API_KEY=your-api-key
OPENAI_API_BASE_URL=https://your-openwebui-instance/api/v1
DEFAULT_MODEL=anthropic/claude-sonnet-4.6
DEFAULT_VENDOR=OpenAI
FABRIC_DISABLE_RESPONSES_API=true

注： FABRIC_DISABLE_RESPONSES_API=true 是OpenWebUI兼容性所必需的（防止结构使用 /responses 端点）。

请参阅：https://github.com/danielmiessler/fabric

GitHub CLI（gh）

这 gh CLI为问题、PR、操作等提供了GitHub API访问权限：

# Authenticate
gh auth login

# Example: trigger workflow
gh workflow run build.yml

# Example: check workflow status
gh run list --limit 5

请参阅：https://cli.github.com/

PinchTab浏览器自动化

PinchTab提供无头浏览器自动化，用于导航网站、截图、填写表单和与网页交互。

状态

• 自动启动 在容器启动时（通过entrypoint.sh）
• 令牌身份验证 必需--已配置 /root/.pinchtab/config.json
• 容器模式：用途 PINCHTAB_CHROME_NO_SANDBOX=1 非根/容器兼容性

快速测试

curl -X POST http://localhost:9867/navigate \
  -H "Authorization: Bearer " \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

服务命令

# On the container:
/root/.nanobot/workspace/scripts/pinchtab-service.sh start|stop|restart|status

端点

SSRF白名单

本地网络访问（本地主机、家庭网络）通过以下方式控制 tools.ssrfWhitelist 在 config.json:

{
  "tools": {
    "ssrfWhitelist": ["127.0.0.0/8", "::1/128", "192.168.0.0/16"]
  }
}

请参阅：https://github.com/HKUDS/nanobot/releases/tag/v0.1.5

Vault RAG（检索增强生成）

使用LightRAG和Ollama对保险库进行索引和搜索。问一些关于你的保险库的自然问题，并从你的实际笔记中得到综合答案。

运作原理

1. 索引 --Vault文件被分块、嵌入(qwen3-embedding:8b)，并存储在知识图+矢量数据库中
2. 查询 --你的问题被嵌入，相关块被检索出来 qwen3.5:cloud 综合答案 仅来自检索到的上下文 （无幻觉）

用法

Telegram/Discord中的触发短语：

• “在我的保险库中搜索\[主题\]”
• “向我的保险库询问\[主题\]”
• “我的笔记对\[主题\]说了什么？”

或者从命令行：

cd /root/.nanobot/workspace
python3 skills/vault-rag/query_vault.py "your question"
python3 skills/vault-rag/query_vault.py --mode mix "thorough question"

# Re-index after vault changes
python3 skills/vault-rag/index_vault.py --reindex

自动索引

vault监视器在每次Nextcloud同步后自动重新索引，因此索引保持最新状态，无需手动干预。

模型使用

查询模式