Nowledge Mem

https://mem.nowledge.co/zh/docs
Admin
A neutral knowledge layer that gives you freedom to use any AI tool by storing decisions, insights,...
Tokens:72,802
Snippets:955
Trust Score:6.1
Update:4 months ago
Show doc for...
Tokens:
Raw
### Initial Setup Command

Source: https://mem.nowledge.co/zh/docs/integrations/bub

This command instructs your agent to read the integration guide and then install or update Nowledge Mem for Bub.

```bash
读取 https://mem.nowledge.co/docs/integrations/bub.mdx，然后帮我为 Bub 安装或更新 Nowledge Mem。优先使用指南中的推荐路径，按成功检查验证结果，并总结你改了什么。
```

--------------------------------

### Initial Setup Command for Hermes Agent

Source: https://mem.nowledge.co/zh/docs/integrations/hermes

This command reads the integration guide and installs or updates Nowledge Mem for Hermes Agent, prioritizing recommended paths and verifying the installation.

```bash
curl -sL https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/setup.sh | bash
```

--------------------------------

### Initial OpenCode Command for Integration Guide

Source: https://mem.nowledge.co/zh/docs/integrations/opencode

This command instructs OpenCode to read the integration guide and then install or update Nowledge Mem, verifying the installation and summarizing changes.

```bash
opencode plugin opencode-nowledge-mem -g

```

--------------------------------

### Install Nowledge Mem Plugin for Copilot CLI

Source: https://mem.nowledge.co/zh/docs/integrations/copilot-cli

Add the community plugin repository and install the Nowledge Mem plugin. This is a one-time setup for Copilot CLI.

```bash
copilot plugin marketplace add nowledge-co/community
copilot plugin install nowledge-mem@nowledge-community
```

--------------------------------

### Install Hermes Nowledge Mem Plugin

Source: https://mem.nowledge.co/zh/docs/integrations/hermes

Run the setup script to install the Nowledge Mem plugin for Hermes. Use the --mcp flag if you are using MCP mode.

```bash
# Plugin mode
bash <(curl -sL https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/setup.sh)
```

```bash
# MCP mode
bash <(curl -sL https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/setup.sh) --mcp
```

--------------------------------

### One-Click Installation Script

Source: https://mem.nowledge.co/zh/docs/integrations/hermes

A convenient script to install the Nowledge Mem integration for Hermes Agent. This is the recommended method for a seamless setup.

```bash
bash <(curl -sL https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/setup.sh)
```

--------------------------------

### Instruct Pi to Install Nowledge Mem

Source: https://mem.nowledge.co/zh/docs/integrations/pi

Provide this instruction to your Pi agent to automatically read the integration guide and install or update Nowledge Mem. It prioritizes recommended paths and verifies the installation.

```bash
读取 https://mem.nowledge.co/docs/integrations/pi.mdx，然后帮我为 Pi 安装或更新 Nowledge Mem。优先使用指南中的推荐路径，按成功检查验证结果，并总结你改了什么。
```

--------------------------------

### Run Hook Setup Script

Source: https://mem.nowledge.co/zh/docs/integrations/codex-cli

Execute the hook setup script from the plugin to integrate it with Codex.

```bash
python3 ./.agents/nowledge-mem/scripts/install_hooks.py
```

--------------------------------

### Install Nowledge Mem Raycast Extension from Source

Source: https://mem.nowledge.co/zh/docs/integrations/raycast

Clone the repository, navigate to the extension directory, and install dependencies to run the extension in development mode.

```bash
git clone https://github.com/nowledge-co/community.git
cd community/nowledge-mem-raycast
npm install && npm run dev
```

--------------------------------

### Linux Installation Paths

Source: https://mem.nowledge.co/zh/docs/troubleshooting

Common installation paths for Nowledge Mem on Linux systems.

```bash
/usr/lib/nowledge-mem/
/usr/share/nowledge-mem/
```

--------------------------------

### Manual Plugin Installation Steps

Source: https://mem.nowledge.co/zh/docs/integrations/hermes

Provides manual steps to install the Nowledge Mem plugin by copying files and configuring Hermes. Use this if the automated script is not suitable.

```bash
mkdir -p ~/.hermes/plugins/nowledge-mem
cd ~/.hermes/plugins/nowledge-mem
for f in plugin.yaml __init__.py provider.py client.py; do
  curl -sLO "https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/$f"
done
```

--------------------------------

### Install Visual C++ Redistributable

Source: https://mem.nowledge.co/zh/docs/troubleshooting

Download and install the Microsoft Visual C++ Redistributable (x64) to fix Windows startup failures related to missing runtime dependencies.

```html
https://aka.ms/vs/17/release/vc_redist.x64.exe
```

--------------------------------

### AI Agent Integration Examples

Source: https://mem.nowledge.co/zh/docs/cli

Examples of using Mem CLI with AI agents for searching context, saving insights, and browsing history.

```bash
# Search for context before responding
nmem --json m search "authentication flow" | jq '.memories[:3]'

# Save an insight
nmem m add "Rate limiting is per-user, not per-IP" \
  --unit-type learning --importance 0.8 -l backend

# Save a decision with when it was made
nmem m add "Chose Postgres over MySQL for task events" \
  --unit-type decision --event-start 2026-02 -l architecture

# Browse what was worked on last week
nmem --json f --days 7 | jq '.events[].title'

# Create a session thread backup
nmem t create -t "Debug session $(date +%Y%m%d)" \
  -m '[{"role":"user","content":"Investigate auth failures"},{"role":"assistant","content":"Found rate limit issue"}]'
```

--------------------------------

### Windows View Log File (Website Installer)

Source: https://mem.nowledge.co/zh/docs/troubleshooting

Path to the application log file for installations from the Nowledge Mem website on Windows.

```batch
%LOCALAPPDATA%\NowledgeGraph\logs\app.log
```

--------------------------------

### Manual Hook Installation (Compatibility)

Source: https://mem.nowledge.co/zh/docs/integrations/copilot-cli

If using an older installation method or developing locally, you can manually run the hook installation script from the plugin's source directory.

```bash
scripts/install-hooks.sh
```

--------------------------------

### Install Nowledge Mem Pi Plugin

Source: https://mem.nowledge.co/zh/docs/integrations/pi

Use this command to install the Nowledge Mem plugin for Pi. Ensure Pi is installed and the nmem CLI is in your PATH.

```bash
pi install npm:nowledge-mem-pi
```

--------------------------------

### Install CLI on macOS

Source: https://mem.nowledge.co/zh/docs/troubleshooting

Install the CLI on macOS from the developer tools settings.

```text
From Settings -> Preferences -> Developer Tools install CLI
```

--------------------------------

### Install Nowledge Mem as a Systemd Service

Source: https://mem.nowledge.co/zh/docs/server-deployment

Installs, enables, and starts Nowledge Mem as a systemd service for a specified Linux user. Recommended for production environments.

```bash
# 以你的日常 Linux 用户身份安装、启用并启动
sudo nmem service install --service-user <linux-user>
```

--------------------------------

### Install nmem CLI using uvx

Source: https://mem.nowledge.co/zh/docs/integrations/droid

Install the nmem CLI using uvx, a tool for managing command-line tools, by downloading and executing an installation script.

```bash
# Method 2: uvx
curl -LsSf https://astral.sh/uv/install.sh | sh
uvx --from nmem-cli nmem --version
```

--------------------------------

### Clone and Copy Plugin for Project-Level Installation

Source: https://mem.nowledge.co/zh/docs/integrations/codex-cli

Clone the community repository and copy the plugin into the local agents directory for project-level installation.

```bash
git clone https://github.com/nowledge-co/community.git /tmp/nowledge-community
mkdir -p .agents
cp -r /tmp/nowledge-community/nowledge-mem-codex-plugin ./.agents/nowledge-mem
rm -rf /tmp/nowledge-community
mkdir -p .agents/plugins
```

--------------------------------

### Install nmem CLI using uvx

Source: https://mem.nowledge.co/zh/docs/integrations/codex-cli

Installs the nmem CLI using the uvx package manager. Ensure uvx is installed first.

```bash
# 方式一：uvx
curl -LsSf https://astral.sh/uv/install.sh | sh
uvx --from nmem-cli nmem --version
```

--------------------------------

### Configure LLM Provider (Anthropic Example)

Source: https://mem.nowledge.co/zh/docs/server-deployment

Sets up a remote LLM provider, using Anthropic's Claude Sonnet as an example. Requires an API key. Use 'test' to verify the connection.

```bash
nmem config provider set anthropic \
  --api-key sk-ant-xxx \
  --model claude-sonnet-4-20250514

nmem config provider test    # 验证连接
```

--------------------------------

### Install Nowledge Mem from Local Checkout

Source: https://mem.nowledge.co/zh/docs/integrations/droid

Clone the community repository locally and add it as a marketplace to install the plugin from your checkout, useful for local verification.

```bash
git clone https://github.com/nowledge-co/community.git
cd community
droid plugin marketplace add .
droid plugin install nowledge-mem@nowledge-community
```

--------------------------------

### Install or Update Nowledge Mem via Alma

Source: https://mem.nowledge.co/zh/docs/integrations/alma

Instructs Alma to read the integration guide and install or update the Nowledge Mem plugin. It prioritizes recommended paths and verifies the installation.

```bash
read https://mem.nowledge.co/docs/integrations/alma.mdx, then help me install or update Nowledge Mem for Alma. Prioritize the recommended path in the guide, verify with a success check, and summarize your changes.
```

--------------------------------

### Install nmem CLI

Source: https://mem.nowledge.co/zh/docs/integrations/bub

Install the nmem CLI if it's not found. Then check its status.

```bash
pip install nmem-cli && nmem status
```

--------------------------------

### Example: Browse Memory by Date

Source: https://mem.nowledge.co/zh/docs/integrations/openclaw

Shows how to query memory for activities performed on a specific day or within a recent period.

```bash
问：这周我都做了什么？
问：2月17日我在忙什么？
```

--------------------------------

### Install Nowledge Mem Plugin (Alternative Path)

Source: https://mem.nowledge.co/zh/docs/integrations/openclaw

This command installs the Nowledge Mem plugin, defaulting to ClawHub resolution. It's an alternative to specifying the 'clawhub:' prefix.

```bash
openclaw plugins install @nowledge/openclaw-nowledge-mem
```

--------------------------------

### Install Nowledge Mem browse-now Skill Package

Source: https://mem.nowledge.co/zh/docs/browse-now

Installs a reusable skill package for external AI agents to learn how and when to use the browse-now CLI, prioritizing it for interactive web tasks.

```bash
npx skills add nowledge-co/community/nowledge-mem-browse-now-npx-skills
```

--------------------------------

### Clone Community Repo and Start Docker

Source: https://mem.nowledge.co/zh/docs/docker

Clone the community repository, navigate to the docker directory, and start the Nowledge Mem service using the nmemctl script. This script handles container startup, health checks, and API key display.

```bash
git clone https://github.com/nowledge-co/community.git
cd community/docker
./nmemctl up
```

--------------------------------

### Gemini CLI Command to Install Nowledge Mem

Source: https://mem.nowledge.co/zh/docs/integrations/gemini-cli

Use this command to instruct Gemini CLI to install or update the Nowledge Mem extension, prioritizing the recommended path from the guide.

```bash
读取 https://mem.nowledge.co/docs/integrations/gemini-cli.mdx，然后帮我为 Gemini CLI 安装或更新 Nowledge Mem。优先使用指南中的推荐路径，按成功检查验证结果，并总结你改了什么。
```

--------------------------------

### Install Nowledge Mem CLI using uv

Source: https://mem.nowledge.co/zh/docs/cli

Install the standalone PyPI package for the Nowledge Mem CLI using uv. This works with local or remote Nowledge Mem servers.

```bash
uv pip install nmem-cli
```

--------------------------------

### Download and Install .deb Package

Source: https://mem.nowledge.co/zh/docs/server-deployment

Downloads the .deb package using curl with a browser User-Agent and installs it using dpkg. Includes a step to fix missing dependencies.

```bash
BROWSER_UA='Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36'

# 下载 .deb
curl -A "$BROWSER_UA" -L -o nowledge-mem.deb https://nowled.ge/download-mem-deb

# 安装包
sudo dpkg -i nowledge-mem.deb

# 修复缺失的依赖
sudo apt-get install -f -y
```

--------------------------------

### Install Nowledge Mem Plugin

Source: https://mem.nowledge.co/zh/docs/integrations/droid

Install the Nowledge Mem plugin from the added community marketplace into your Droid instance.

```bash
droid plugin install nowledge-mem@nowledge-community
```

--------------------------------

### Get Thread Request (cURL)

Source: https://mem.nowledge.co/zh/docs/api/threads/thread_id/get

Example of how to make a GET request to retrieve a thread using cURL. Replace 'string' with the actual thread ID.

```shell
curl -X GET "http://127.0.0.1:14242/threads/string"
```

--------------------------------

### Install Nowledge Mem Plugin for OpenClaw

Source: https://mem.nowledge.co/zh/docs/integrations/openclaw

Use this command to install the Nowledge Mem plugin from ClawHub. The installer typically enables the plugin and sets it as the default memory slot.

```bash
openclaw plugins install clawhub:@nowledge/openclaw-nowledge-mem
```

--------------------------------

### Verify CLI Installation on Windows

Source: https://mem.nowledge.co/zh/docs/troubleshooting

After installing or upgrading Nowledge Mem on Windows, open a new terminal window to ensure the CLI is recognized.

```text
Open a NEW terminal window (PATH updates require a new session)
```

--------------------------------

### Install Mem Background Service

Source: https://mem.nowledge.co/zh/docs/troubleshooting

Installs the Mem background service on a Linux server. Ensure you replace '<linux-user>' with the appropriate user.

```bash
sudo nmem service install --service-user <linux-user>
```

--------------------------------

### Install Nowledge Mem Gemini Extension

Source: https://mem.nowledge.co/zh/docs/integrations/alma

Instructions for installing the official Nowledge Mem Gemini extension to connect Gemini CLI with local or remote Mem.

```bash
Install the official Nowledge Mem Gemini extension and wire Gemini CLI to local or remote Mem in about a minute.
```

--------------------------------

### Nowledge Mem CLI Quick Start Commands

Source: https://mem.nowledge.co/zh/docs/cli

A collection of common Nowledge Mem CLI commands for quick reference. These cover status checks, memory operations, working memory, spaces, activity feed, graph exploration, and the interactive UI.

```bash
nmem status                              # Check connection
```

```bash
nmem m search "project notes"           # Search memories
```

```bash
nmem m search "project notes" --space work
```

```bash
nmem m add "Key insight" --title "Learning"
```

```bash
nmem wm                                  # Read today's Working Memory
```

```bash
nmem wm --space work                     # Read Working Memory for one space
```

```bash
nmem spaces                              # List known spaces
```

```bash
nmem f --days 1                          # Today's activity
```

```bash
nmem g expand <memory-id>               # Explore graph connections
```

```bash
nmem tui                                 # Interactive terminal UI
```

--------------------------------

### Install Nowledge Mem Bub Plugin

Source: https://mem.nowledge.co/zh/docs/integrations/bub

Install the Nowledge Mem plugin for Bub using pip.

```bash
pip install nowledge-mem-bub
```

--------------------------------

### Set up OpenClaw with Nowledge Mem

Source: https://mem.nowledge.co/zh/docs/integrations/alma

Guide for setting up OpenClaw with lossless session memory and shared cross-tool memory using Nowledge Mem.

```bash
Set up OpenClaw with lossless session memory and shared cross-tool memory in 5 minutes.
```

--------------------------------

### Start Watcher

Source: https://mem.nowledge.co/zh/docs/api/threads/watcher/start/post

Starts the session watcher for auto-importing sessions. Returns the current status of the watcher.

```APIDOC
## POST /threads/watcher/start

### Description
Starts the session watcher for auto-importing sessions.

### Method
POST

### Endpoint
/threads/watcher/start

### Response
#### Success Response (200)
- **running** (boolean) - Indicates if the watcher is currently running.
- **watched_paths** (array) - A list of paths being watched.
- **last_check** (integer) - Timestamp of the last check.
- **auto_import_count** (integer) - The number of sessions automatically imported.
- **errors** (array) - A list of any errors encountered.

### Response Example
```json
{
  "running": true,
  "watched_paths": [
    "string"
  ],
  "last_check": 0,
  "auto_import_count": 0,
  "errors": [
    "string"
  ]
}
```
```

--------------------------------

### Install Mem Systemd Service

Source: https://mem.nowledge.co/zh/docs/server-deployment

Installs Mem as a systemd service. Use --service-user if sudo does not automatically identify the correct Linux user.

```bash
sudo nmem service install
```

```bash
sudo nmem service install --service-user <linux-user> --host 0.0.0.0 --port 8080
```

--------------------------------

### Verify CLI Installation

Source: https://mem.nowledge.co/zh/docs/server-deployment

Checks if the Nowledge Mem command-line interface is installed and accessible.

```bash
nmem --version
```

--------------------------------

### Install nmem-cli

Source: https://mem.nowledge.co/zh/docs/integrations/codex-cli

Use this command to install the nmem-cli package if the 'nmem' command is not found. Alternatively, use 'uvx --from nmem-cli nmem'.

```bash
pip install nmem-cli
```

--------------------------------

### Check browse-now CLI Status and Help

Source: https://mem.nowledge.co/zh/docs/browse-now

Verify that the browse-now CLI is installed and accessible on your machine. Use '--help' for a list of available commands and options.

```bash
browse-now status
browse-now --help
```

--------------------------------

### Install nmem CLI

Source: https://mem.nowledge.co/zh/docs/integrations/copilot-cli

Instructions for installing the nmem CLI tool using pip or pipx. This CLI is required for interacting with Nowledge Mem.

```bash
# 方式一：使用 Mem 桌面应用附带的 CLI
# 设置 → 偏好设置 → 开发者工具 → 安装 CLI

# 方式二：pip
pip install nmem-cli

# 方式三：pipx
pipx install nmem-cli
```

--------------------------------

### Start Docker Compose with TLS

Source: https://mem.nowledge.co/zh/docs/docker

Start the Nowledge Mem service using Docker Compose with TLS enabled, utilizing Caddy for automatic certificate management. Requires DNS configuration and specific Docker Compose version.

```bash
export NOWLEDGE_DOMAIN=mem.example.com
export NOWLEDGE_LE_EMAIL=you@example.com
docker compose -f compose.yaml -f compose.tls.yaml up -d
```

--------------------------------

### Install or Update Nowledge Mem for Codex CLI

Source: https://mem.nowledge.co/zh/docs/integrations/codex-cli

This command instructs the agent to read the provided documentation and install or update Nowledge Mem for the Codex CLI, verifying the installation and summarizing changes.

```bash
读取 https://mem.nowledge.co/docs/integrations/codex-cli.mdx，然后帮我为 Codex CLI 安装或更新 Nowledge Mem。优先使用指南中的推荐路径，按成功检查验证结果，并总结你改了什么。
```

--------------------------------

### cURL Request Example

Source: https://mem.nowledge.co/zh/docs/api/threads/bulk/delete/post

Example of how to make a POST request to the bulk delete threads endpoint using cURL.

```shell
curl -X POST "https://example.com/threads/bulk/delete" \
  -H "Content-Type: application/json" \
  -d '{    "selection": {}  }'
```

--------------------------------

### OpenClaw Prompt for Nowledge Mem Integration

Source: https://mem.nowledge.co/zh/docs/integrations/openclaw

This is an example prompt to give to an AI agent, instructing it to read documentation and configure Nowledge Mem for OpenClaw.

```text
读取 https://mem.nowledge.co/docs/integrations/openclaw.mdx，然后帮我为 OpenClaw 安装或更新 Nowledge Mem。优先使用指南中的推荐路径，按成功检查验证结果，并总结你改了什么。
```

--------------------------------

### Manual Installation of Nowledge Mem Gemini CLI Extension

Source: https://mem.nowledge.co/zh/docs/integrations/gemini-cli

Steps to manually install the Nowledge Mem extension for Gemini CLI from a GitHub repository or local directory.

```bash
git clone https://github.com/nowledge-co/nowledge-mem-gemini-cli.git
cd nowledge-mem-gemini-cli
gemini extensions link .
```

--------------------------------

### Example Conversation with YAML Front Matter

Source: https://mem.nowledge.co/zh/docs/threads

This snippet shows a complete example of a conversation, including optional YAML front matter and system messages. It demonstrates the structure for defining a title, source, and date.

```markdown
---
title: Python 异步编程
source: chatgpt
date: 2025-06-15
---

## System

你是一位资深 Python 开发者，擅长清晰地解释技术概念。

## User

Python 的 async/await 是怎么工作的？

## Assistant

Python 的 `async`/`await` 让你编写在等待 I/O 时不阻塞的并发代码。`async def` 函数返回一个协程，`await` 会暂停它直到结果就绪——同时其他协程可以继续执行。

## User

什么时候该用 asyncio，什么时候该用线程？

## Assistant

**asyncio** 适用于 I/O 密集型任务（HTTP 请求、数据库查询、文件读写）——比线程更轻量，扩展性更好。**threading** 适用于调用不支持异步的阻塞库。**multiprocessing** 适用于 CPU 密集型任务。
```

--------------------------------

### Install Mem CLI on Remote Machine

Source: https://mem.nowledge.co/zh/docs/server-deployment

Installs the Mem command-line interface on a separate machine for remote server management.

```bash
pip install nmem-cli
# or
uv pip install nmem-cli
```

--------------------------------

### Install Nowledge Mem via AppImage (Linux)

Source: https://mem.nowledge.co/zh/docs/installation

This script downloads the latest AppImage for Nowledge Mem, makes it executable, and provides the command to run it. This method is suitable for portable manual execution.

```bash
BROWSER_UA='Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36'

# Download the latest AppImage
curl -A "$BROWSER_UA" -L -o nowledge-mem.AppImage https://nowled.ge/download-mem-appimage

# Add executable permissions and run
chmod +x nowledge-mem.AppImage
./nowledge-mem.AppImage
```

--------------------------------

### Install Nowledge Mem via APT Repository (Linux)

Source: https://mem.nowledge.co/zh/docs/installation

This command adds the Nowledge Mem APT repository and installs the package, enabling automatic updates. It's the recommended method for Linux.

```bash
curl -fsSL https://nowledge-co.github.io/community/apt/install.sh | sudo bash
sudo apt-get install nowledge-mem
```

--------------------------------

### Install Nowledge Mem as a User Service

Source: https://mem.nowledge.co/zh/docs/server-deployment

Installs Nowledge Mem as a user service. Requires enabling lingering for the user to ensure the service persists after logout and reboots.

```bash
nmem service install --user

sudo loginctl enable-linger <linux-user>
```

--------------------------------

### Setup Codex Hooks for Nowledge Mem

Source: https://mem.nowledge.co/zh/docs/integrations/codex-cli

Re-run the hook setup and restart Codex if Codex threads are not appearing automatically. This script finds and executes the install_hooks.py script for Nowledge Mem.

```bash
HOOK_SETUP="$(find ~/.codex/plugins/cache -path '*/nowledge-mem/*/scripts/install_hooks.py' -print 2>/dev/null | sort | tail -1)"
test -n "$HOOK_SETUP" && python3 "$HOOK_SETUP"
```

--------------------------------

### Install Mem User Service

Source: https://mem.nowledge.co/zh/docs/server-deployment

Installs Mem as a user service without root privileges. Ensure you are running this command as the target Linux user.

```bash
nmem service install --user
```

--------------------------------

### Install Nowledge Mem Manually via .deb Package (Linux)

Source: https://mem.nowledge.co/zh/docs/installation

This script downloads the latest .deb package for Nowledge Mem using a browser User-Agent and installs it. It includes a command to fix any missing dependencies.

```bash
BROWSER_UA='Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36'

# Download the latest .deb
curl -A "$BROWSER_UA" -L -o nowledge-mem.deb https://nowled.ge/download-mem-deb

# Install
sudo dpkg -i nowledge-mem.deb
sudo apt-get install -f   # Fix missing dependencies
```

--------------------------------

### Manual Docker Compose Startup

Source: https://mem.nowledge.co/zh/docs/docker

Manually start the Nowledge Mem service using Docker Compose in detached mode. This is an alternative to using the nmemctl script.

```bash
docker compose up -d
```

--------------------------------

### List All Available Spaces

Source: https://mem.nowledge.co/zh/docs/spaces

The nmem CLI command to list all configured spaces. This is helpful for managing and understanding the different partitions available in your Mem setup.

```bash
nmem spaces
```

--------------------------------

### Mem MCP Endpoint Example

Source: https://mem.nowledge.co/zh/docs/integrations/chatgpt-web

This is an example of a Mem MCP endpoint URL that you would paste into ChatGPT's connector settings. Ensure your Access Anywhere domain is configured correctly and the URL ends with /mcp.

```text
https://your-access-anywhere-domain.example/mcp
```

--------------------------------

### Example: Remember and Recall a Fact

Source: https://mem.nowledge.co/zh/docs/integrations/openclaw

Demonstrates the basic functionality of remembering a fact and recalling it in a new session, verifying cross-session memory.

```bash
/remember 我们为任务事件选择了 PostgreSQL
/recall PostgreSQL
```

--------------------------------

### Setup Nowledge Mem Hooks for Codex (Linux/macOS)

Source: https://mem.nowledge.co/zh/docs/integrations/codex-cli

Sets up the necessary hooks for automatic thread capture in Codex. This script finds and executes the install_hooks.py script for the nowledge-mem plugin.

```bash
HOOK_SETUP="$(find ~/.codex/plugins/cache -path '*/nowledge-mem/*/scripts/install_hooks.py' -print 2>/dev/null | sort | tail -1)"
if [ -z "$HOOK_SETUP" ]; then
  echo "没有找到 hook setup。请打开 Codex，运行 /plugins，安装 nowledge-mem@nowledge-community，然后重试。"
else
  python3 "$HOOK_SETUP"
fi
```

--------------------------------

### Run Nowledge Mem CLI without installation

Source: https://mem.nowledge.co/zh/docs/cli

Execute the Nowledge Mem CLI directly without installing it using uvx. This is useful for quick checks or testing.

```bash
uvx --from nmem-cli nmem --help
```

--------------------------------

### Install nmem CLI using pip

Source: https://mem.nowledge.co/zh/docs/integrations/droid

Use this command to install the nmem command-line interface via pip, a common method for Python package management.

```bash
# Method 1: pip
pip install nmem-cli
```

--------------------------------

### Example: Remember a Decision with Type and Date

Source: https://mem.nowledge.co/zh/docs/integrations/openclaw

Illustrates saving a memory with specific metadata, including type (decision) and date, for structured knowledge storage.

```bash
记住这是一个决策，发生在 2026 年 2 月
```

--------------------------------

### Start Watcher Request

Source: https://mem.nowledge.co/zh/docs/api/threads/watcher/start/post

Use this cURL command to initiate the session watcher. This action enables auto-importing of sessions.

```curl
curl -X POST "https://example.com/threads/watcher/start"
```

--------------------------------

### Direct Data Directory Migration

Source: https://mem.nowledge.co/zh/docs/docker

You can directly use tools like rsync, restic, borg, ZFS snapshots, or tar on the ./data and ./config directories. For absolute consistency, stop Mem before the operation and start it afterward.

```bash
./nmemctl down
# Perform rsync, restic, borg, ZFS snapshot, or tar
./nmemctl up
```

--------------------------------

### Windows View Log File (Microsoft Store)

Source: https://mem.nowledge.co/zh/docs/troubleshooting

Path to the application log file for Microsoft Store installations on Windows.

```batch
%LOCALAPPDATA%\Packages\NowledgeLabsLLC.NowledgeMem_1070t6ne485wp\logs\app.log
```

--------------------------------

### Install Nowledge Mem via MCP Mode Script

Source: https://mem.nowledge.co/zh/docs/integrations/hermes

Installs the Nowledge Mem integration using the MCP (Multi-Chat Protocol) mode for older Hermes versions (< v0.7.0). This configures MCP server settings and SOUL.md behavior guides.

```bash
bash <(curl -sL https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/setup.sh) --mcp
```

--------------------------------

### List Threads Request (cURL)

Source: https://mem.nowledge.co/zh/docs/api/threads/get

Example cURL command to list threads. Use this to make a GET request to the /threads endpoint.

```shell
curl -X GET "https://example.com/threads"
```

--------------------------------

### Example: Search for Past Conversations

Source: https://mem.nowledge.co/zh/docs/integrations/openclaw

Demonstrates how to search for specific conversation threads based on keywords or topics discussed.

```bash
找一下我们讨论 Redis 缓存的那次对话
```

--------------------------------

### Setup Nowledge Mem Hooks for Codex (Windows PowerShell)

Source: https://mem.nowledge.co/zh/docs/integrations/codex-cli

Sets up the necessary hooks for automatic thread capture in Codex on Windows using PowerShell. This command finds and executes the install_hooks.py script.

```powershell
$HookSetup = Get-ChildItem "$env:USERPROFILE\.codex\plugins\cache" -Recurse -Filter install_hooks.py |
  Where-Object { $_.FullName -like "*nowledge-mem*" } |
  Sort-Object FullName |
  Select-Object -Last 1
if ($null -eq $HookSetup) {
  Write-Host "没有找到 hook setup。请打开 Codex，运行 /plugins，安装 nowledge-mem@nowledge-community，然后重试。"
} else {
  py -3 $HookSetup.FullName
}
```

--------------------------------

### Example Search Response JSON

Source: https://mem.nowledge.co/zh/docs/cli

A sample JSON structure for a search query response, including memory details.

```json
{
  "query": "API design",
  "total": 3,
  "search_mode": "fast_bm25_vector",
  "memories": [
    {
      "id": "abc123-def456-...",
      "title": "REST API versioning decision",
      "content": "We use /v1/ prefix for all public endpoints...",
      "score": 0.91,
      "relevance_reason": "Text Match (89%) + Semantic Match (73%) | decay[imp:high]",
      "importance": 0.8,
      "labels": ["architecture", "api"],
      "event_start": "2025-09",
      "temporal_context": "past",
      "source": "cli"
    }
  ]
}
```

--------------------------------

### Prompt Copilot to Recall Working Memory

Source: https://mem.nowledge.co/zh/docs/integrations/copilot-cli

After installing the plugin, ask Copilot what you were working on to verify the working memory recall functionality.

```bash
What was I working on?
```

--------------------------------

### Example: Recall Across Sessions

Source: https://mem.nowledge.co/zh/docs/integrations/openclaw

Tests if the AI can recall information from a previous session, confirming that memory persists across new conversations.

```bash
问：任务事件的数据库我们选的什么？
```

--------------------------------

### Launch Nowledge Mem from Terminal (Linux)

Source: https://mem.nowledge.co/zh/docs/installation

This command launches the Nowledge Mem application from the terminal. Ensure the application is installed and accessible in your PATH.

```bash
nowledge-mem
```

--------------------------------

### Verify Nowledge Mem Integration with OpenCode

Source: https://mem.nowledge.co/zh/docs/integrations/opencode

After installation and restarting OpenCode, use this prompt to confirm that OpenCode can access your Nowledge Mem context.

```bash
我最近在做什么？

```

--------------------------------

### Run Nowledge Mem in Foreground

Source: https://mem.nowledge.co/zh/docs/server-deployment

Starts the Nowledge Mem server process in the foreground. Useful for temporary use or debugging, but occupies the current terminal session.

```bash
nmem serve
```

--------------------------------

### Disable Authentication

Source: https://mem.nowledge.co/zh/docs/server-deployment

Starts the Mem server without requiring an API key for authentication. Not recommended for production environments.

```bash
nmem serve --no-auth
```

--------------------------------

### Create Thread Response (Success)

Source: https://mem.nowledge.co/zh/docs/api/threads/post

Example JSON response when a thread is successfully created. Includes details about the created thread and its messages.

```JSON
{
  "thread": {
    "id": "string",
    "node_type": "Thread",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "metadata": {},
    "thread_id": "string",
    "title": "string",
    "summary": "string",
    "message_count": 0,
    "participants": [
      "string"
    ],
    "source": "string",
    "space_id": "default",
    "project": "string",
    "workspace": "string",
    "tool_version": "string",
    "import_date": "2019-08-24T14:15:22Z"
  },
  "messages": [
    {
      "id": "string",
      "node_type": "Thread",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z",
      "metadata": {},
      "content": "string",
      "role": "string",
      "order_index": 0,
      "timestamp": "2019-08-24T14:15:22Z",
      "token_count": 0
    }
  ],
  "created_relationships": 0,
  "auto_generated_summary": "string",
  "extracted_memories": [
    {
      "id": "string",
      "node_type": "Thread",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z",
      "metadata": {},
      "content": "string",
      "title": "string",
      "importance": 0.5,
      "confidence": 0.5,
      "pagerank_score": 0,
      "embedding": [
        0
      ],
      "source_range": {
        "property1": 0,
        "property2": 0
      },
      "source": "string",
      "space_id": "default",
      "semantic_field": "string",
      "reindex_needed": false,
      "last_reindexed_at": "2019-08-24T14:15:22Z",
      "last_accessed_at": "2019-08-24T14:15:22Z",
      "access_count": 0,
      "appearances": 0,
      "clicks": 0,
      "total_dwell_time_ms": 0,
      "last_clicked_at": "2019-08-24T14:15:22Z",
      "decay_score_cached": 1,
      "temporal_context": "timeless",
      "temporal_type": "string",
      "event_start": "string",
      "event_end": "string",
      "temporal_precision": "string",
      "temporal_confidence": 0,
      "unit_type": "fact",
      "is_latest": true,
      "version": 1,
      "is_crystal": false,
      "crystal_title": "string",
      "source_unit_count": 0,
      "extraction_method": "manual",
      "last_evaluated_at": "2019-08-24T14:15:22Z",
      "review_status": ""
    }
  ],
  "auto_extraction_performed": false
}
```

--------------------------------

### Enable In-Browser Upgrades

Source: https://mem.nowledge.co/zh/docs/docker

Enable automatic upgrades to manage Mem updates directly from the web interface. This sets up a companion container and a unique token for browser-triggered installations.

```bash
./nmemctl auto-update enable
```

--------------------------------

### Example: Fetch Original Conversation Thread

Source: https://mem.nowledge.co/zh/docs/integrations/openclaw

Shows how to retrieve the full conversation thread associated with a specific memory using its `sourceThreadId`.

```bash
nowledge_mem_thread_fetch
```

--------------------------------

### Manual OpenCode Plugin Configuration

Source: https://mem.nowledge.co/zh/docs/integrations/opencode

Manually add the Nowledge Mem plugin to the OpenCode configuration file if you prefer not to use the command-line installation.

```json
{
  "plugin": ["opencode-nowledge-mem"]
}

```

--------------------------------

### Incorporate Project Guidance for Copilot

Source: https://mem.nowledge.co/zh/docs/integrations/copilot-cli

Clone the community repository and copy the AGENTS.md file to your project root to enhance Copilot's proactivity in searching and distilling information.

```bash
git clone https://github.com/nowledge-co/community.git /tmp/nowledge-community
cp /tmp/nowledge-community/nowledge-mem-copilot-cli-plugin/AGENTS.md ./AGENTS.md
rm -rf /tmp/nowledge-community
```

--------------------------------

### cURL Example for Reconcile Thread Tail

Source: https://mem.nowledge.co/zh/docs/api/threads/thread_id/reconcile-tail/post

Demonstrates how to make a POST request to reconcile the tail of a thread using cURL. Includes the endpoint and a sample JSON payload.

```shell
curl -X POST "https://example.com/threads/string/reconcile-tail" \
  -H "Content-Type: application/json" \
  -d '{}'
```

--------------------------------

### Get Storage Info Request

Source: https://mem.nowledge.co/zh/docs/api/storage/info/get

Use this cURL command to make a GET request to the storage info endpoint.

```shell
curl -X GET "https://example.com/storage/info"
```

--------------------------------

### Successful Space Update Response

Source: https://mem.nowledge.co/zh/docs/api/spaces/space_ref/patch

Example JSON response when a space is successfully updated. It includes details about the space's configuration and usage statistics.

```json
{
  "enabled": false,
  "spaces": [
    {
      "id": "string",
      "key": "string",
      "name": "string",
      "aliases": [
        "string"
      ],
      "description": "string",
      "icon": "string",
      "instructions": "string",
      "sharedSpaceIds": [
        "string"
      ],
      "defaultRetrievalMode": "strict",
      "usage": {
        "memories": 0,
        "threads": 0,
        "sources": 0,
        "hasWorkingMemory": false
      },
      "observed": false,
      "hasProfile": true
    }
  ]
}
```

--------------------------------

### Display nmemctl Help

Source: https://mem.nowledge.co/zh/docs/docker

View the complete list of available commands and their usage for the nmemctl lifecycle controller.

```bash
./nmemctl help
```

--------------------------------

### Piping Search Results to Cat

Source: https://mem.nowledge.co/zh/docs/cli

Demonstrates how to pipe the output of `recall` or `grep` to `cat` to display specific content. The `grep` example uses `jq` to extract path and line information for targeted viewing.

```bash
nmem fs recall "why did we change token refresh?" --in /memories -k 5 --paths \
  | while IFS= read -r kfs_path; do nmem fs cat "$kfs_path"; done

```

```bash
nmem fs grep "JWT rotation" /threads --jsonl \
  | while IFS= read -r hit;
      kfs_path=$(printf '%s' "$hit" | jq -r '.path')
      kfs_line=$(printf '%s' "$hit" | jq -r '.line')
      nmem fs cat "$kfs_path" --line "$kfs_line" --lines 12
    done

```

--------------------------------

### Download and Run AppImage

Source: https://mem.nowledge.co/zh/docs/server-deployment

Downloads the AppImage, makes it executable, and runs it. This method is suitable for portable, manual execution and not recommended for long-term server use.

```bash
BROWSER_UA='Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36'

# 下载 AppImage
curl -A "$BROWSER_UA" -L -o nowledge-mem.AppImage https://nowled.ge/download-mem-appimage

# 仅适合便携式手动运行
chmod +x nowledge-mem.AppImage

./nowledge-mem.AppImage
```

--------------------------------

### Core browse-now Usage Sequence

Source: https://mem.nowledge.co/zh/docs/browse-now

Demonstrates the fundamental workflow for interacting with a website using browse-now: opening a URL, inspecting elements, performing an action, and verifying navigation.

```bash
browse-now open https://example.com
browse-now snapshot -i
browse-now click @e5
browse-now wait 2
browse-now get url
browse-now snapshot -i
```

--------------------------------

### CLI 配置后台智能

Source: https://mem.nowledge.co/zh/docs/advanced-features

在 Linux 服务器上，通过 CLI 配置后台处理设置。

```bash
nmem config settings set backgroundIntelligence true
nmem config settings set autoDailyBriefing true
nmem config settings set briefingHour 8
```

--------------------------------

### List, Read, and Search Filesystem Paths

Source: https://mem.nowledge.co/zh/docs/cli

Basic commands for navigating and retrieving information from Nowledge FS paths. Use `cat` with line numbers for specific sections of documents.

```bash
nmem fs ls /

```

```bash
nmem fs cat /wiki/entities/PostgreSQL.entity.md

```

```bash
nmem fs cat /sources/research-report-abc123.pdf --line 120 --lines 80

```

```bash
nmem fs stat /memories/by-id/mem_abc.memory.md

```

```bash
nmem fs find /memories --label decisions --since 2026-01-01

```

```bash
nmem fs grep "JWT rotation" /memories

```

```bash
nmem fs grep "JWT rotation" /threads

```

```bash
nmem fs grep "JWT rotation" /sources

```

```bash
nmem fs grep "JWT rotation" /threads --jsonl

```

```bash
nmem fs recall "session token strategy" --in /memories

```

--------------------------------

### Windows File Paths

Source: https://mem.nowledge.co/zh/docs/troubleshooting

Overview of configuration, data, user, and client tool directories on Windows.

```batch
# Configuration/Status Root Directory: co.nowledge.mem.desktop
# Data Root Directory: NowledgeGraph
# User Working Directory: ai-now
# Client Tool Directory (nmem CLI + OpenClaw plugin): .nowledge-mem

%APPDATA%\co.nowledge.mem.desktop\     # Configuration/Status
%LOCALAPPDATA%\NowledgeGraph\          # Data (DB/Index/Logs)
%USERPROFILE%\ai-now\                  # User Working Directory
%USERPROFILE%\.nowledge-mem\           # nmem/OpenClaw Client Configuration
```

--------------------------------

### macOS File Paths

Source: https://mem.nowledge.co/zh/docs/troubleshooting

Overview of configuration, data, user, and client tool directories on macOS.

```bash
# Configuration/Status Root Directory: co.nowledge.mem.desktop
# Data Root Directory: NowledgeGraph
# User Working Directory: ai-now
# Client Tool Directory (nmem CLI + OpenClaw plugin): .nowledge-mem

~/Library/Application Support/co.nowledge.mem.desktop/   # Configuration/Status
~/Library/Application Support/NowledgeGraph/             # Data (DB/Index/Logs)
~/ai-now/                                                 # User Working Directory
~/.nowledge-mem/                                          # nmem/OpenClaw Client Configuration
```

--------------------------------

### Update Space cURL Example

Source: https://mem.nowledge.co/zh/docs/api/spaces/space_ref/patch

Example of how to update a space using cURL. This sends a PATCH request to the specified endpoint with an empty JSON body.

```shell
curl -X PATCH "https://example.com/spaces/string" \
  -H "Content-Type: application/json" \
  -d '{}'
```

--------------------------------

### Get Watcher Status (cURL)

Source: https://mem.nowledge.co/zh/docs/api/threads/watcher/status/get

Use this cURL command to make a GET request to the /threads/watcher/status endpoint to retrieve the watcher's current status.

```shell
curl -X GET "http://127.0.0.1:14242/threads/watcher/status"
```

--------------------------------

### Create Local Marketplace Configuration

Source: https://mem.nowledge.co/zh/docs/integrations/codex-cli

Create a marketplace.json file to configure the local plugin source for Codex discovery.

```json
{
  "name": "local",
  "plugins": [
    {
      "name": "nowledge-mem",
      "source": {
        "source": "local",
        "path": "./.agents/nowledge-mem"
      },
      "policy": {
        "installation": "INSTALLED_BY_DEFAULT",
        "authentication": "ON_INSTALL"
      },
      "category": "Productivity"
    }
  ]
}
```

--------------------------------

### List, Add, Show, and Delete Library Sources

Source: https://mem.nowledge.co/zh/docs/cli

Basic commands for managing documents within the Nowledge Library. Supports adding files and URLs, viewing metadata, and deleting sources.

```bash
nmem sources list                       # Sources in the current space

```

```bash
nmem sources add notes.pdf               # Import a file

```

```bash
nmem sources add https://example.com/doc # Capture a URL

```

```bash
nmem sources show src_abc123             # Metadata for one source

```

```bash
nmem sources delete src_abc123 -f        # Delete (non-interactive)

```

--------------------------------

### Create Standard Directory

Source: https://mem.nowledge.co/zh/docs/server-deployment

Create the standard directory for Nowledge Graph data if it does not exist.

```bash
mkdir -p ~/.local/share/NowledgeGraph
```

--------------------------------

### Configure Client Connection Settings

Source: https://mem.nowledge.co/zh/docs/cli

Commands to show, set, and clear client connection settings for remote Mem servers.

```bash
nmem config client show
nmem config client set url https://mem.example.com
nmem config client set api-key nmem_...
nmem config client clear api-key
```

--------------------------------

### Instruct Droid to Install/Update Nowledge Mem

Source: https://mem.nowledge.co/zh/docs/integrations/droid

Provide this instruction to your Droid agent to automatically install or update the Nowledge Mem plugin, prioritizing recommended paths and verifying the installation.

```text
Read https://mem.nowledge.co/docs/integrations/droid.mdx, then help me install or update Nowledge Mem for Droid. Prioritize the recommended path in the guide, verify with a success check, and summarize your changes.
```

--------------------------------

### Add Project-Specific Agent Guidance

Source: https://mem.nowledge.co/zh/docs/integrations/codex-cli

Copies the AGENTS.md file from the community repository to your project root to enhance memory behavior within that specific repository.

```bash
git clone https://github.com/nowledge-co/community.git /tmp/nowledge-community
cp /tmp/nowledge-community/nowledge-mem-codex-plugin/AGENTS.md ./AGENTS.md
rm -rf /tmp/nowledge-community
```

--------------------------------

### Update nmem-cli and Re-run Hook Setup

Source: https://mem.nowledge.co/zh/docs/integrations/codex-cli

Update the nmem-cli to the latest version and re-run the hook setup if 'codex mcp list' shows 'Not logged in'. This ensures version compatibility and proper CLI configuration.

```bash
pip install -U nmem-cli
nmem status
HOOK_SETUP="$(find ~/.codex/plugins/cache -path '*/nowledge-mem/*/scripts/install_hooks.py' -print 2>/dev/null | sort | tail -1)"
test -n "$HOOK_SETUP" && python3 "$HOOK_SETUP"
```

--------------------------------

### Show Current Mem Client Configuration

Source: https://mem.nowledge.co/zh/docs/integrations/claude-desktop

Verify the current URL and API Key settings for the Nowledge Mem client. This is useful for remote connection troubleshooting.

```bash
nmem config client show
```

--------------------------------

### Restart Nowledge Mem Server

Source: https://mem.nowledge.co/zh/docs/server-deployment

Restart the Nowledge Mem server. The server will print the database path on startup.

```bash
nmem serve               # 或: nmem service start
```

--------------------------------

### Successful Response Body

Source: https://mem.nowledge.co/zh/docs/api/threads/bulk/delete/post

Example of a successful response body when threads are deleted.

```json
{
  "message": "string",
  "deleted_count": 0,
  "failed_count": 0,
  "total_deleted_messages": 0,
  "total_deleted_memories": 0,
  "cascade_deletion": false,
  "results": [
    {}
  ]
}
```

--------------------------------

### Application-Level Export and Restore

Source: https://mem.nowledge.co/zh/docs/docker

For cross-version migration or moving from .deb/desktop versions, use application-level export. This creates a portable JSONL format. The 'backup-app' command generates a zip file, and 'restore-app' restores from it.

```bash
./nmemctl backup-app                # Generate mem-app-export-<host>-<ts>.zip
```

```bash
./nmemctl restore-app mem-app-export-<host>-<ts>.zip
```

--------------------------------

### Update CLI via pipx

Source: https://mem.nowledge.co/zh/docs/troubleshooting

Update the nmem CLI if it was installed via pipx.

```bash
pipx upgrade nmem-cli
```

--------------------------------

### Show Login URL

Source: https://mem.nowledge.co/zh/docs/server-deployment

Displays the URL to access the Nowledge Mem Web App. Use this on headless servers to connect from a local browser.

```bash
nmem key --show-login
```

--------------------------------

### Update CLI via PyPI

Source: https://mem.nowledge.co/zh/docs/troubleshooting

Update the nmem CLI if it was installed via PyPI.

```bash
python -m pip install --upgrade nmem-cli
```

--------------------------------

### Launch Terminal UI

Source: https://mem.nowledge.co/zh/docs/cli

Starts the interactive terminal user interface for browsing memories and threads.

```bash
nmem tui
```

--------------------------------

### Configure Processing Settings

Source: https://mem.nowledge.co/zh/docs/cli

Commands to show all settings and change the morning briefing time.

```bash
nmem config settings                               # Show all settings
nmem config settings set briefingHour 8            # Change morning briefing time
```

--------------------------------

### Example Error Response JSON

Source: https://mem.nowledge.co/zh/docs/cli

A sample JSON structure for an error response, indicating an API error.

```json
{
  "error": "api_error",
  "status_code": 404,
  "detail": "Memory not found"
}
```

--------------------------------

### Example: Forget a Fact

Source: https://mem.nowledge.co/zh/docs/integrations/openclaw

Demonstrates how to remove specific memories from the system to manage or clean up stored information.

```bash
/forget PostgreSQL 任务事件
```
Tokens:
Raw