Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

1.8 KB
Raw Blame

Step 1: Install

  1. Install the OpenViking plugin:

    openclaw plugins install clawhub:@openviking/openclaw-plugin
    
  2. Run the setup wizard. Enter {{OPENVIKING_BASE_URL}} as the service URL and the API key provided on this page:

    openclaw openviking setup
    

    Or configure it in one step, with the key in OPENVIKING_API_KEY:

    openclaw openviking setup --base-url {{OPENVIKING_BASE_URL}} --api-key "$OPENVIKING_API_KEY"
    
  3. Configure peer_role: peer_role identifies the type of conversation participant. It is not a permission role. assistant represents agents, tools, or models; sender represents message senders (the legacy value person remains an alias). After the setup above, peer_role defaults to none. To change peer_role, run:

    openclaw openviking setup --reconfigure
    
  4. Restart the Gateway to apply the configuration:

    openclaw gateway restart
    

Step 2: Verify

  1. Check the integration status in your terminal:

    openclaw openviking status
    
  2. A result similar to the following means the integration is successful:

    🦣 OpenViking Plugin Status
    
      Status: Configured
      mode:      remote
      baseUrl:   `https://api.vikingdb.cn-beijing.volces.com/openviking`
      apiKey:    set
      peer_role: none
      accountId: not set
      userId:    not set
      slot:      active
    
      ✓ Server reachable (version: v0.x.xx.x)
    

Troubleshoot

Problem Fix
Plugin not active Re-run Install, then openclaw gateway restart
401 / 403 Refresh credentials

Reference